MonialMCP

MCP

Model Context Protocol

Connect Claude, Cursor, or any MCP client with your API key. Every Realtime Data API endpoint — people, companies, news, posts, jobs, ads, web search, AI answers, website content and places — is available as a tool, plus monitors for scheduled runs. The same key authenticates the REST API.

Server URLhttps://www.monial.co/mcp
HeaderAuthorization: Bearer YOUR_API_KEY

Get the server URL and API key from Console → Settings, then connect your client:

  1. Claude — Settings → Connectors → Add custom connector. Paste the server URL and set the Authorization header to Bearer YOUR_API_KEY.
  2. Cursor — add the server to mcp.json with the same Authorization header (config on the right).
  3. Other clients — point the client at the server URL and send Authorization: Bearer YOUR_API_KEY on every request.

Cursor mcp.json

{
  "mcpServers": {
    "monial": {
      "url": "https://www.monial.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

After connecting, call web_search, get_company or any Realtime Data API tool directly, and get_users to list your organization's members. Use monitor_create to schedule recurring runs with webhook delivery.

Tools

Realtime Data API

get_person

Get person

Enrich people in bulk — pass a query array of up to 100 people, each identified by name, company domain, email or LinkedIn URL. Waits for the result even when the API queues the job.

Arguments

queryrequiredjsonArray of up to 100 people, each an object like { "name", "domain", "email", "linkedin" }.
cachebooleanReuse stored enrichments when they exist (default true). Set false to force a fresh scrape.

Example call

{
  "tool": "get_person",
  "arguments": {
    "query": [
      {
        "domain": "acme.com",
        "name": "Jane Doe"
      }
    ]
  }
}
get_company

Get company

Enrich companies in bulk — pass a query array of up to 100 companies, each identified by domain or LinkedIn URL. Waits for the result even when the API queues the job.

Arguments

queryrequiredjsonArray of up to 100 companies, each an object like { "domain" } or { "linkedin" }.
cachebooleanReuse stored enrichments when they exist (default true). Set false to force a fresh scrape.

Example call

{
  "tool": "get_company",
  "arguments": {
    "query": [
      {
        "domain": "acme.com"
      }
    ]
  }
}
get_company_techstack

Get company tech stack

Detect the technologies behind up to 100 company websites — frameworks, analytics, hosting, CRM and more. Recent stored scans are returned inline; otherwise new scans run and the tool waits for the result.

Arguments

queryrequiredjsonArray of up to 100 domains, each an object like { "domain": "acme.com" }.
cachebooleanReuse recent stored scans when they exist (default true). Set false to force a fresh scan.

Example call

{
  "tool": "get_company_techstack",
  "arguments": {
    "query": [
      {
        "domain": "acme.com"
      }
    ]
  }
}
get_company_employees

Get company employees

Find the people working at up to 100 companies by job title — executives, engineering, sales and more — via public LinkedIn-profile search. Pass category inside a query to scan one function (e.g. engineering); omit it to scan every category. A stored scan is returned inline; otherwise the scan runs and the tool waits for the result.

Arguments

queryrequiredjsonArray of up to 100 queries, each an object like { "domain": "acme.com", "category": "engineering" }.
cachebooleanReuse stored scans when they exist (default true). Set false to force a fresh scan.

Example call

{
  "tool": "get_company_employees",
  "arguments": {
    "query": [
      {
        "domain": "acme.com",
        "category": "engineering"
      }
    ]
  }
}
get_company_events

Get company news

Return public news articles about up to 100 companies by their domains.

Arguments

queryrequiredjsonArray of up to 100 queries, each an object like { "domain": "acme.com", "limit": 10, "page": 1 }.
cachebooleanReuse stored articles when they exist (default true). Set false to force a fresh scrape.

Example call

{
  "tool": "get_company_events",
  "arguments": {
    "query": [
      {
        "domain": "acme.com"
      }
    ]
  }
}
get_posts

Get social posts

Search social media posts on Reddit, Twitter/X and YouTube, up to 100 queries per call.

Arguments

queryrequiredjsonArray of up to 100 queries, each an object like { "query": "AI agents", "datePosted": "24h", "platforms": ["reddit"] } — empty platforms means all.
cachebooleanReuse stored results for these queries when they exist (default true). Set false to force a fresh scrape.

Example call

{
  "tool": "get_posts",
  "arguments": {
    "query": [
      {
        "query": "AI agents",
        "platforms": [
          "reddit"
        ]
      }
    ]
  }
}
get_jobs

Get job postings

Find job postings by company domain and/or title and location, up to 100 queries per call.

Arguments

queryrequiredjsonArray of up to 100 queries, each an object like { "domain": "stripe.com", "title": "Backend Engineer", "date": "1w", "limit": 10 }.
cachebooleanReuse stored postings for these searches when they exist (default true). Set false to force a fresh search.

Example call

{
  "tool": "get_jobs",
  "arguments": {
    "query": [
      {
        "domain": "stripe.com",
        "title": "Backend Engineer"
      }
    ]
  }
}
get_ads

Get ads

Search ad-library ads for up to 100 queries across Meta, Google and LinkedIn. Leave platforms empty inside a query to search all of them.

Arguments

queryrequiredjsonArray of up to 100 queries, each an object like { "query": "nike", "platforms": ["meta"], "limit": 100, "region": "US" }.
cachebooleanReuse stored ads for these queries when they exist (default true). Set false to force a fresh scrape.

Example call

{
  "tool": "get_ads",
  "arguments": {
    "query": [
      {
        "query": "nike",
        "platforms": [
          "meta"
        ],
        "limit": 100
      }
    ]
  }
}

Example call

{
  "tool": "web_search",
  "arguments": {
    "query": [
      {
        "query": "Best AI Agent",
        "limit": 10
      }
    ]
  }
}
web_search_ai

AI web search

Ask up to 100 questions per call: each runs a web search, reads the top pages and returns an AI answer with its sources.

Arguments

queryrequiredjsonArray of up to 100 questions, each an object like { "query": "What is the best time to post on LinkedIn?" }.

Example call

{
  "tool": "web_search_ai",
  "arguments": {
    "query": [
      {
        "query": "What is the best time to post on LinkedIn?"
      }
    ]
  }
}
get_website_content

Get website content

Fetch up to 100 pages' titles, text content and markdown per call. Pages that need JavaScript are rendered in a headless browser automatically.

Arguments

queryrequiredjsonArray of up to 100 URLs, each an object like { "url": "https://example.com" }.

Example call

{
  "tool": "get_website_content",
  "arguments": {
    "query": [
      {
        "url": "https://example.com"
      }
    ]
  }
}
get_places

Get places

Search places (businesses, locations) via maps, up to 100 queries per call. Returns name, address, rating and more.

Arguments

queryrequiredjsonArray of up to 100 searches, each an object like { "query": "coffee shops in Chennai", "limit": 100 }.

Example call

{
  "tool": "get_places",
  "arguments": {
    "query": [
      {
        "query": "coffee shops in Chennai",
        "limit": 100
      }
    ]
  }
}
search_people

Search people

Search people by location, industry and keywords, up to 100 queries per call. Pass a waterfall inside a query — an ordered list of { title, size } steps — and the API walks each step until it has enough candidates.

Arguments

queryrequiredjsonArray of up to 100 queries, each an object like { "location": "Chennai", "industry": "software", "keywords": "...", "waterfall": [{"title":"CMO","size":"100-200"}], "limit": 10 }.

Example call

{
  "tool": "search_people",
  "arguments": {
    "query": [
      {
        "location": "Chennai",
        "industry": "software",
        "limit": 10
      }
    ]
  }
}

Tools

Organization

get_users

List users

Return every member of the organization as email, and name when the profile has one.

Example call

{
  "tool": "get_users",
  "arguments": {}
}
monitor_list

List monitors

Return every monitor for the organization. A monitor runs one data API endpoint on a schedule (1h, 1d or 1w) and POSTs the result to a webhook URL. Pass id to get one monitor with its recent results.

Arguments

idstringMonitor id — returns that monitor plus its 20 most recent results.

Example call

{
  "tool": "monitor_list",
  "arguments": {}
}
monitor_create

Create a monitor

Schedule a recurring API call: give it an optional name and description, run a data API endpoint every hour, day or week and POST the result to a webhook URL after every run.

Arguments

namestringDisplay name. Defaults to Untitled.
descriptionstringOptional description.
endpointrequiredstringRealtime Data API path, e.g. company/events?domain=acme.com.
requestBodyjsonJSON request body for POST APIs such as person and company.
intervalrequiredstring1h, 1d or 1w.
webhookUrlrequiredstringURL that receives { monitorId, status, result, error } after every run.
isActivebooleanStart paused with false. Defaults to true.

Example call

{
  "tool": "monitor_create",
  "arguments": {
    "name": "Acme company news",
    "description": "Track news about Acme",
    "endpoint": "company/events?domain=acme.com",
    "interval": "1d",
    "webhookUrl": "https://example.com/hooks/monial"
  }
}
monitor_update

Update a monitor

Change a monitor's name, description, endpoint, interval, webhook URL or active flag. Only the fields you pass change. Set isActive false to pause the schedule without deleting it.

Arguments

idrequiredstringMonitor id.
namestringNew display name.
descriptionstringNew description; pass null to clear it.
endpointstringNew data API path.
requestBodyjsonNew request body, or null to clear it.
intervalstring1h, 1d or 1w.
webhookUrlstringNew webhook URL.
isActivebooleanPause (false) or resume (true) the schedule.

Example call

{
  "tool": "monitor_update",
  "arguments": {
    "id": "mon_123",
    "interval": "1w"
  }
}
monitor_delete

Delete a monitor

Delete a monitor and all of its stored results. The schedule stops immediately.

Arguments

idrequiredstringMonitor id.

Example call

{
  "tool": "monitor_delete",
  "arguments": {
    "id": "mon_123"
  }
}