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 URL | https://www.monial.co/mcp |
| Header | Authorization: Bearer YOUR_API_KEY |
Get the server URL and API key from Console → Settings, then connect your client:
- Claude — Settings → Connectors → Add custom connector. Paste the server URL and set the
Authorizationheader toBearer YOUR_API_KEY. - Cursor — add the server to
mcp.jsonwith the sameAuthorizationheader (config on the right). - Other clients — point the client at the server URL and send
Authorization: Bearer YOUR_API_KEYon 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_personGet 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
| queryrequired | json | Array of up to 100 people, each an object like { "name", "domain", "email", "linkedin" }. |
| cache | boolean | Reuse 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_companyGet 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
| queryrequired | json | Array of up to 100 companies, each an object like { "domain" } or { "linkedin" }. |
| cache | boolean | Reuse 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_techstackGet 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
| queryrequired | json | Array of up to 100 domains, each an object like { "domain": "acme.com" }. |
| cache | boolean | Reuse 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_employeesGet 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
| queryrequired | json | Array of up to 100 queries, each an object like { "domain": "acme.com", "category": "engineering" }. |
| cache | boolean | Reuse 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_eventsGet company news
Return public news articles about up to 100 companies by their domains.
Arguments
| queryrequired | json | Array of up to 100 queries, each an object like { "domain": "acme.com", "limit": 10, "page": 1 }. |
| cache | boolean | Reuse 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_postsGet social posts
Search social media posts on Reddit, Twitter/X and YouTube, up to 100 queries per call.
Arguments
| queryrequired | json | Array of up to 100 queries, each an object like { "query": "AI agents", "datePosted": "24h", "platforms": ["reddit"] } — empty platforms means all. |
| cache | boolean | Reuse 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_jobsGet job postings
Find job postings by company domain and/or title and location, up to 100 queries per call.
Arguments
| queryrequired | json | Array of up to 100 queries, each an object like { "domain": "stripe.com", "title": "Backend Engineer", "date": "1w", "limit": 10 }. |
| cache | boolean | Reuse 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_adsGet 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
| queryrequired | json | Array of up to 100 queries, each an object like { "query": "nike", "platforms": ["meta"], "limit": 100, "region": "US" }. |
| cache | boolean | Reuse 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
}
]
}
}web_searchWeb search
Public web search in bulk (up to 100 queries per call). Returns organic results with titles, URLs and snippets.
Arguments
| queryrequired | json | Array of up to 100 searches, each an object like { "query": "Best AI Agent", "limit": 10, "page": 1, "date": "m" } — date d, w, m or y filters to the last day, week, month or year. |
Example call
{
"tool": "web_search",
"arguments": {
"query": [
{
"query": "Best AI Agent",
"limit": 10
}
]
}
}web_search_aiAI 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
| queryrequired | json | Array 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_contentGet 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
| queryrequired | json | Array 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_placesGet places
Search places (businesses, locations) via maps, up to 100 queries per call. Returns name, address, rating and more.
Arguments
| queryrequired | json | Array 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_peopleSearch 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
| queryrequired | json | Array 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_usersList users
Return every member of the organization as email, and name when the profile has one.
Example call
{
"tool": "get_users",
"arguments": {}
}monitor_listList 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
| id | string | Monitor id — returns that monitor plus its 20 most recent results. |
Example call
{
"tool": "monitor_list",
"arguments": {}
}monitor_createCreate 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
| name | string | Display name. Defaults to Untitled. |
| description | string | Optional description. |
| endpointrequired | string | Realtime Data API path, e.g. company/events?domain=acme.com. |
| requestBody | json | JSON request body for POST APIs such as person and company. |
| intervalrequired | string | 1h, 1d or 1w. |
| webhookUrlrequired | string | URL that receives { monitorId, status, result, error } after every run. |
| isActive | boolean | Start 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_updateUpdate 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
| idrequired | string | Monitor id. |
| name | string | New display name. |
| description | string | New description; pass null to clear it. |
| endpoint | string | New data API path. |
| requestBody | json | New request body, or null to clear it. |
| interval | string | 1h, 1d or 1w. |
| webhookUrl | string | New webhook URL. |
| isActive | boolean | Pause (false) or resume (true) the schedule. |
Example call
{
"tool": "monitor_update",
"arguments": {
"id": "mon_123",
"interval": "1w"
}
}monitor_deleteDelete a monitor
Delete a monitor and all of its stored results. The schedule stops immediately.
Arguments
| idrequired | string | Monitor id. |
Example call
{
"tool": "monitor_delete",
"arguments": {
"id": "mon_123"
}
}