> ## Documentation Index
> Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LeadMagic MCP Server

> Use LeadMagic enrichment, bulk jobs, analytics, and account intelligence directly inside AI assistants

# MCP Server <Badge color="purple">Beta</Badge>

The LeadMagic MCP server lets AI assistants call LeadMagic directly. Ask your AI to validate contacts, find emails, enrich companies, submit bulk jobs, check account analytics, or build an account brief - the assistant uses the right LeadMagic tool and returns the result in context.

<Warning>
  **Beta** — The MCP server is fully functional but still in beta. Tools, parameters, and behavior may change. We'd love your feedback — reach out at [support@leadmagic.io](mailto:support@leadmagic.io) or via the [Help Center](https://help.leadmagic.io/en).
</Warning>

<Note>
  **What is MCP?** The [Model Context Protocol](https://modelcontextprotocol.io) is an open standard that lets AI assistants use external tools. LeadMagic's MCP server exposes contact, company, jobs, bulk, analytics, and workflow tools that compatible AI clients can call.
</Note>

## What You Can Do

Ask your AI assistant questions like:

* *"Find the work email for Alex Rivera at Example Robotics"*
* *"Validate these 50 email addresses before my campaign"*
* *"What's the tech stack at example.com?"*
* *"Find and validate the CEO, CRO, and VP Sales at Example Robotics"*
* *"Open the upload widget and enrich this company list"*
* *"How much did I use today and am I close to my limits?"*
* *"Give me account intel on Example Robotics: funding, competitors, jobs, and tech stack"*

The AI calls the right LeadMagic tool automatically - no code, no API calls, no context switching.

## What The MCP Can Do

<Tabs>
  <Tab title="Contacts" icon="user">
    | Tool                             | What It Does                                                                         |
    | -------------------------------- | ------------------------------------------------------------------------------------ |
    | `validate_work_email`            | Verify deliverability before outreach                                                |
    | `find_work_email`                | Name + company/domain to work email                                                  |
    | `find_mobile_number`             | Profile/email to direct mobile                                                       |
    | `linkedin_profile_to_work_email` | Profile URL to work email                                                            |
    | `email_to_b2b_profile`           | Email to B2B profile URL                                                             |
    | `search_profile`                 | Profile URL to professional profile                                                  |
    | `find_personal_email`            | Profile URL to personal email                                                        |
    | `detect_job_change`              | Check whether a contact moved jobs                                                   |
    | `enrich_contact`                 | Composite dossier across validation, profile, personal email, mobile, and job change |
  </Tab>

  <Tab title="Company" icon="building">
    | Tool                         | What It Does                                                       |
    | ---------------------------- | ------------------------------------------------------------------ |
    | `enrich_company`             | Firmographics by domain, name, or LinkedIn URL                     |
    | `research_account`           | Concise company brief with firmographics and funding context       |
    | `find_company_funding`       | Funding rounds, investors, and financial context                   |
    | `list_company_competitors`   | Competitor and similar-company discovery                           |
    | `get_company_technographics` | Company technology stack                                           |
    | `find_company_employees`     | Employee lists by company/domain                                   |
    | `find_people_by_role`        | Role and title discovery                                           |
    | `find_decision_makers`       | Composite role search plus email discovery and validation          |
    | `account_intel`              | Composite account brief with research, competitors, tech, and jobs |
  </Tab>

  <Tab title="Bulk" icon="file-csv">
    | Tool                                        | What It Does                                                    |
    | ------------------------------------------- | --------------------------------------------------------------- |
    | `create_bulk_upload_session`                | Open the LeadMagic CSV upload widget                            |
    | `process_attached_csv`                      | Start the correct upload flow for attached CSV/JSON/JSONL files |
    | `submit_detected_bulk_job`                  | Submit a file after enrichment type and columns are detected    |
    | `submit_company_firmographics_bulk`         | Fast path for company list firmographics                        |
    | `submit_bulk_job`                           | Generic bulk submit for supported products                      |
    | `list_bulk_jobs`                            | List recent bulk jobs                                           |
    | `get_bulk_job_status`                       | Inspect status, queue, progress, and links                      |
    | `get_bulk_job_rows`                         | Read completed row output                                       |
    | `get_bulk_job_errors`                       | Read failed rows and row errors                                 |
    | `get_bulk_job_logs` / `get_bulk_job_events` | Debug queue, retry, progress, and completion events             |
  </Tab>

  <Tab title="Jobs & Account" icon="briefcase">
    | Tool                                               | What It Does                                                                                             |
    | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
    | `find_jobs`                                        | Search job postings by company, role, location, remote status, seniority, and recency                    |
    | `search_jobs`                                      | Advanced Jobs Search with v3 warehouse filters, vector, facets, deep mode, tags, and occupation taxonomy |
    | `resolve_job_search_filters`                       | Resolve company, tag, title, occupation taxonomy, and location filters before search                     |
    | `get_job_search_catalogs` / `get_job_search_stats` | Free jobs warehouse catalogs, dimensions, and freshness stats                                            |
    | `list_job_countries`                               | Supported job country codes                                                                              |
    | `list_job_types`                                   | Supported job types                                                                                      |
    | `list_job_company_types`                           | Supported company type filters                                                                           |
    | `list_job_industries`                              | Supported job industry filters                                                                           |
    | `list_job_regions`                                 | Supported job regions                                                                                    |
    | `check_credit_balance`                             | Credit balance                                                                                           |
    | `get_account_analytics`                            | Balance, rate-limit headroom, concurrency, usage, and top tools                                          |
    | `preview_cost`                                     | Free credit estimate before expensive or composite actions                                               |
  </Tab>
</Tabs>

<Tip>
  See the full [tool reference](/docs/mcp/tools) for tool categories, parameters, examples, cost behavior, resources, and prompts.
</Tip>

## Supported Clients

Works with any MCP client that supports Streamable HTTP transport — 13 clients and counting.

<CardGroup cols={3}>
  <Card title="Cursor" icon="code" href="/docs/mcp/setup">
    Native Streamable HTTP support.
  </Card>

  <Card title="VS Code / Copilot" icon="window" href="/docs/mcp/setup">
    Secure input variables supported.
  </Card>

  <Card title="Claude Desktop" icon="message" href="/docs/mcp/setup">
    Via `mcp-remote` proxy.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/docs/mcp/setup">
    One CLI command to add.
  </Card>

  <Card title="Windsurf" icon="wind" href="/docs/mcp/setup">
    Native Streamable HTTP.
  </Card>

  <Card title="Zed" icon="code" href="/docs/mcp/setup#more-clients">
    Via `mcp-remote` proxy.
  </Card>

  <Card title="Cline" icon="puzzle-piece" href="/docs/mcp/setup#more-clients">
    Remote URL with OAuth.
  </Card>

  <Card title="Roo Code" icon="code-branch" href="/docs/mcp/setup#more-clients">
    Project or global config.
  </Card>

  <Card title="OpenCode" icon="laptop-code" href="/docs/mcp/setup#more-clients">
    Remote type with OAuth.
  </Card>

  <Card title="Gemini CLI" icon="wand-magic-sparkles" href="/docs/mcp/setup#more-clients">
    CLI or settings.json.
  </Card>

  <Card title="JetBrains IDEs" icon="laptop" href="/docs/mcp/setup#more-clients">
    IntelliJ, WebStorm, PyCharm, etc.
  </Card>

  <Card title="Amazon Q" icon="cloud" href="/docs/mcp/setup#more-clients">
    HTTP transport in IDE or CLI.
  </Card>

  <Card title="Copilot Agent" icon="github" href="/docs/mcp/setup#more-clients">
    GitHub coding agent.
  </Card>
</CardGroup>

## How It Works

1. You add the LeadMagic MCP server URL to your AI client
2. Your client opens the LeadMagic OAuth sign-in flow
3. The AI discovers the available LeadMagic tools automatically
4. When you ask a question, the AI calls the right tool with the right parameters
5. LeadMagic returns structured data, and the AI presents it in context

For bulk files, the MCP can open an upload widget, map columns, submit jobs, poll progress, inspect failures, and fetch completed rows. For account operations, it can estimate credit usage, check credits, and read analytics before running expensive work.

The server runs at `https://mcp.leadmagic.io/mcp` using the Streamable HTTP transport. Claude remote connectors should use `https://mcp.leadmagic.io`.

## Get Started

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="gear" href="/docs/mcp/setup">
    Step-by-step setup for Cursor, VS Code, Claude, and Windsurf.
  </Card>

  <Card title="Tool Reference" icon="wrench" href="/docs/mcp/tools">
    All MCP tools with parameters, cost notes, resources, and prompts.
  </Card>

  <Card title="Authentication" icon="key" href="/docs/mcp/authentication">
    OAuth setup and troubleshooting.
  </Card>

  <Card title="Troubleshooting" icon="circle-question" href="/docs/mcp/troubleshooting">
    Common issues and how to fix them.
  </Card>
</CardGroup>