LeadMagic MCP Server

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

MCP Server Beta

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.

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 [e-mail] or via the Help Center.

What is MCP? The Model Context Protocol 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.

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

Contacts

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

Company

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

Bulk

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

Jobs & Account

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

See the full tool reference for tool categories, parameters, examples, cost behavior, resources, and prompts.

Supported Clients

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

Cursor

Native Streamable HTTP support.

VS Code / Copilot

Secure input variables supported.

Claude Desktop

Via mcp-remote proxy.

Claude Code

One CLI command to add.

Windsurf

Native Streamable HTTP.

Zed

Via mcp-remote proxy.

Cline

Remote URL with OAuth.

Roo Code

Project or global config.

OpenCode

Remote type with OAuth.

Gemini CLI

CLI or settings.json.

JetBrains IDEs

IntelliJ, WebStorm, PyCharm, etc.

Amazon Q

HTTP transport in IDE or CLI.

Copilot Agent

GitHub coding agent.

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

Setup Guide

Step-by-step setup for Cursor, VS Code, Claude, and Windsurf.

Tool Reference

All MCP tools with parameters, cost notes, resources, and prompts.

Authentication

OAuth setup and troubleshooting.

Troubleshooting

Common issues and how to fix them.