// mcp

Connect AgenticData to your AI agent via MCP

Hosted MCP endpoint. No npm install, no local CLI. Paste a URL and your API key — your agent gets enrich() and search() instantly.

What is MCP?

Model Context Protocol (MCP) is a standard from Anthropic that lets AI agents call external tools without bespoke wrapper code. AgenticData runs an MCP server at a stable URL, so any MCP-compatible client — Claude Desktop, Cursor, Claude Code, LangChain — can call enrich() and search() directly.

Endpoint

https://www.agenticdata.host/api/mcp

Authenticate with your AgenticData API key as a Bearer token. Grab a key from your dashboard if you don't have one.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agenticdata": {
      "type": "http",
      "url": "https://www.agenticdata.host/api/mcp",
      "headers": {
        "Authorization": "Bearer ADATA_live_xxxxxxxx"
      }
    }
  }
}

Restart Claude. A 🔌 plug icon appears with two tools available.

Cursor

Open Cursor Settings → MCP → Add new MCP server, choose HTTP, and use:

Name: agenticdata
URL:  https://www.agenticdata.host/api/mcp
Header: Authorization: Bearer ADATA_live_xxxxxxxx

Available tools

  • enrich(email | phone | linkedin) — full person + company record (alias: enrich_person)
  • search(filters) — people search, up to 100 rows (alias: search_people). Filter by first_name, last_name, company, company_domain, title, location.
  • list_build(companies, contacts, limit) — deduped list preview, up to 500 rows per call (page with offset). Use a small limit for previews.
  • list_export(companies, contacts, max_records) — async CSV export for 500–10,000+ records. Returns a job_id; poll list_export_status(job_id) until complete, then download from download_url.
  • search_companies(filters) — company/account discovery
  • get_usage() — plan limits and monthly quota

Example prompts

> "Enrich sundar@google.com and summarize his tenure at Google."

> "Find 20 VPs of Engineering in Series B fintechs based in NYC,
   then draft a cold email referencing each company's funding round."

Use cases

  • Lead research — agents qualify leads in real time
  • Hiring — pull candidate context inside Claude
  • Sales intelligence — enrich an account before a call

Troubleshooting

  • 401 Unauthorized — check the Authorization header. The key must start with ADATA_live_ or ADATA_test_ and be at least 20 characters.
  • Tools don't show up — verify the endpoint URL exactly. Claude Desktop logs are at tail -f ~/Library/Logs/Claude/mcp*.log.
  • list_build times out — narrow filters or lower limit. For anything over 500 records use list_export instead — it runs as a background job and never blocks the chat.
  • Rate limits — see your plan limits on pricing. The MCP server enforces the same per-key quota as the REST API.