LeadMagic MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with LeadMagic MCP or direct API to search people and companies, enrich lead profiles, find relevant job openings, and retrieve advertising audiences through natural language.

LeadMagic logoLeadMagic
Api Key

LeadMagic is a data service that provides people, company, jobs, advertising, and enrichment data for sales and recruiting. Use it to enrich leads, discover candidates, and power targeted outreach with rich contact and company profiles.

109 Tools

Try LeadMagic now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
LeadMagic
Try asking
TOOLS

Supported Tools

Every LeadMagic action and event your agent gets out of the box.

Add Emails To Suppression List

Add a non-empty plaintext email list to a suppression list created by the workflow, using its lifecycle-owned list ID and addresses.

Create Credit Budget

Create a persistent credit budget for one LeadMagic scope and record its returned ID for later updates or deletion.

Create Email Suppression List

Create an owned suppression list from a unique list ID and non-empty plaintext email list; capture the returned ID for later operations and delete the list at the end of its lifecycle.

Create Job Search Export V3

Synchronously export up to 5,000 matching jobs.

Delete Credit Budget

Permanently delete one credit budget using only the ID captured from its creation in the same owned lifecycle.

Delete Email Suppression List

Permanently delete an entire suppression list and its stored hashes using only the list ID captured from its creation in the same owned lifecycle.

Detect Job Change

Check whether a person has changed jobs relative to an expected company; a resolved check costs 3 credits and PROFILE_NOT_FOUND is free.

Download Bulk Job Results CSV

Download result rows for an owned bulk job as an offloaded CSV using a job ID from the same submission chain; downloads exceeding 50 MiB fail.

Enrich Company V1

Call POST /v1/companies/company-search to enrich one company from its domain, name, or business profile identifier.

Enrich Company V3 Docs Alias

Search or look up companies through the /v3/companies/enrich compatibility route and return one cursor-controlled page.

Find Company Competitors V1

Find competitors from a company domain, profile, or name.

Find Company Employees V1

Find up to 10 employees at one company, including names, titles, locations and professional profile URLs; each returned employee costs up to 1 credit.

Find Jobs V1

Find jobs with LeadMagic V1 filters using your own LeadMagic connection, with a page size capped at 50.

Find Lookalike Companies V3

Find similar companies from a seed domain, name, or description; managed requests require a bare domain and return at most 25 companies.

Find Mobile Phone

Find one person's mobile phone number from a professional profile URL or known email.

Find Personal Email

Find one person's personal email addresses from a professional profile URL or identifier.

Find Person By Role V1

Find one person by job title at a specified company using a connected API key; a found match costs 2 credits.

Find Work Email

Find one person's work email from their name and company domain or name.

Find Work Email From B2B Profile

Find one person's work email from a professional profile URL or slug.

Get Account Overview

Get the connected workspace's available credits, API-key permission summary, current rate limits, and today's usage using your own LeadMagic API key.

Get Analytics All Time Summary

Get lifetime account request, credit, product, success, and latency statistics, optionally restricted to a date range, using your own LeadMagic API key.

Get Analytics Credit History

Get LeadMagic credit consumption history with a daily breakdown using your own LeadMagic API key.

Get Analytics Daily Metrics

Get daily request, credit, latency, and error metrics for the last 1 to 90 days using your own LeadMagic API key.

Get Analytics Day Breakdown

Get the per-product request and credit breakdown for one date using your own LeadMagic API key.

Get Analytics Products

Get per-product LeadMagic usage with request, credit, and success metrics using your own LeadMagic API key.

Get Analytics Usage

Get daily LeadMagic usage with request, credit, and chargeable-rate totals using your own LeadMagic API key.

Get B2B Ad Details V1

Get full details for a specific B2B ad from its library URL, detail path, or numeric ID.

Get B2B Profile From Email

Find one person's professional profile from a supplied work or personal email using your own LeadMagic API key; a found complete profile costs 10 credits.

Get B2B Profile From Profile URL

Retrieve one person's professional profile, including employment, education, certifications, and honors, from a profile URL or slug.

Get Batch

Read status, progress, cost, and metadata for a mixed-product batch by its exact batch identifier using your own LeadMagic API key.

Get Batch Campaign Metrics

Read aggregate usage and success metrics for a batch campaign using your own LeadMagic API key.

Get Batch Client Metrics

Read aggregate batch usage and success metrics for one client UUID using your own LeadMagic API key.

Get Bulk Capabilities

Retrieve LeadMagic bulk submission limits and operational features to help plan bulk jobs.

Get Bulk Job

Read status, progress, timestamps, and reported finalized credit usage for one owned bulk job.

Get Bulk Job Progress

Return a compact progress snapshot for frequent polling of one bulk job owned by the connected workspace.

Get Company Funding V1

Call POST /v1/companies/company-funding to get complete funding history and related company intelligence by domain or name.

Get Company Funding V3 Company Docs Alias

Search company funding through POST /v3/companies/company-funding and return one cursor-controlled page.

Get Company Funding V3 Docs Alias

Search company funding through POST /v3/companies/funding and return one cursor-controlled page.

Get Company Technographics V1

Get a company's technology stack from its domain.

Get Credit Balance V1

Check the connected LeadMagic workspace's current credit balance.

Get Credit Budget Status

Read current limits, remaining credits, and exceeded state for LeadMagic credit budgets.

Get Credit Service Health V1 Docs Only

Check the connected LeadMagic API key's credit-service authentication status.

Get Email Suppression List

Return one offset-controlled page of details and SHA-256 email hashes for a suppression list created by the workflow, continuing with the returned next_offset.

Get Job Board Stats V3

Return job search dataset statistics through the job-board integration route.

Get Job Search Catalogs

Return the free filter catalogs used by job search, including countries, regions, job types, industries, company types, and seniority values.

Get Job Search Dataset Stats V3

Return free public statistics for the LeadMagic Jobs Search index, including coverage and freshness.

Get Search Stats

Return free cached coverage, capabilities, and top dimensions for selected LeadMagic search products; requested sections may be absent when unavailable.

List Batch Clients

List existing organization-scoped client records used to segment batch work using your own LeadMagic API key.

List Batch Client Webhooks

List delivery webhooks configured for one batch client using your own LeadMagic API key.

List Batches

List one page of batches for the connected organization, optionally filtered by product, status, or client.

List Bulk Job Errors

Check a page of bulk-job errors for a job owned by the connected workspace, using offset pagination and an optional status filter.

List Bulk Job Events

Return the append-only event log, newest first, for one owned bulk job.

List Bulk Job Results

Return one offset page of row-level JSON results for an owned bulk job, with an optional status filter and a page size of up to 1,000 rows.

List Bulk Jobs

Return one bounded offset page of bulk jobs owned by the connected account, newest first, with next_offset for continuation.

List Credit Budgets

List credit budgets configured for the connected LeadMagic workspace, including their identifiers.

List Email Suppression Lists

Read suppression-list summaries for the connected workspace for discovery.

List External Batch Providers

List organization-level external enrichment provider configurations.

List Job Company Types V1

List company type IDs for the legacy V1 Jobs Finder API.

List Job Countries V1

List country codes for the legacy V1 Jobs Finder API.

List Job Industries V1

List industry IDs for the legacy V1 Jobs Finder API.

List Job Occupation Taxonomy V3

Autocomplete LeadMagic's broad-to-specific occupation taxonomy and return canonical IDs, labels, levels, and paths.

List Job Regions V1

List region IDs for the legacy V1 Jobs Finder API.

List Job Search Company Suggestions V3

Autocomplete companies or resolve an exact domain into canonical company IDs and card data for Job Search filters.

List Job Search Location Suggestions V3

Autocomplete countries, regions, states, and cities into canonical IDs for exact Job Search geo filters.

List Job Search Role Suggestions V3

Autocomplete role names into canonical occupation taxonomy IDs for Job Search filters.

List Job Search Tag Suggestions V3

Autocomplete normalized job tags with tag-type and occupation taxonomy metadata for Job Search filters.

List Job Search Title Suggestions V3

Autocomplete searchable job title phrases with occupation taxonomy metadata for Job Search filters.

List Job Types V1

List job type IDs for the legacy V1 Jobs Finder API using your own LeadMagic connection.

Lookup Company Domain V3 Docs Alias

Look up companies through POST /v3/companies/domain-lookup using your own LeadMagic connection, returning one cursor-controlled page.

Lookup Company V3 Docs Alias

Look up companies through POST /v3/companies/lookup using your own LeadMagic connection, returning one cursor-controlled page.

Pause Bulk Job

Pause a queued or running LeadMagic bulk job owned by the connected workspace, changing its processing state.

Preview Mixed Batch Cost

Estimate the maximum credit cost and budget impact of a mixed-product batch payload using a connected API key.

Refresh Credit Cache V1 Docs Only

Request a refresh of the connected workspace's credit cache using a connected API key.

Remove Emails From Suppression List

Remove specific email suppressions from a list created by the workflow, allowing those addresses to be processed again, using the lifecycle-owned list ID and previously added plaintext addresses.

Resolve Job Search Filters V3

Resolve job-search companies, tags, occupation taxonomy, locations, and titles into canonical filter values using a connected API key.

Restart Bulk Job

Destructively restart a LeadMagic bulk job in full, for failed rows only, or from a zero-based row or shard using a connected API key.

Resume Bulk Job

Resume a paused LeadMagic bulk job using a connected API key; this mutates processing state and may continue the job's existing charged work.

Review Bulk Job

Resume or irreversibly cancel an owned bulk job using a connected API key.

Search B2B Ads V1

Search for B2B ads by company domain or name.

Search Companies

Search or look up companies through POST /v3/companies/search, returning one page with a limit of 50; search charges depend on the plan.

Search Companies V1 Legacy Docs Alias

Search companies through the legacy POST /v1/companies/search compatibility route, returning one cursor-controlled page.

Search Companies V3 Company Hyphenated Docs Alias

Search companies through POST /v3/companies/company-search, returning one cursor-controlled page.

Search Google Ads V1

Search for Google ads run by a company.

Search Jobs

Search jobs by title, company, location, taxonomy, tags, salary, seniority, date, and work arrangement using your own LeadMagic connection, returning one cursor-controlled page of up to 5 jobs.

Search Jobs V1 Legacy Docs Alias

Search jobs through POST /v1/jobs/search using your own LeadMagic connection, returning one cursor page.

Search Jobs V2 Legacy Docs Alias

Search jobs through POST /v2/jobs/search using your own LeadMagic connection, returning one cursor page.

Search Jobs V3 Hyphenated OpenAPI Alias

Search jobs through POST /v3/jobs-search using your own LeadMagic connection and return one cursor-controlled page of up to 5 jobs.

Search Jobs V3 Singular Docs Alias

Search jobs through POST /v3/job-search using your own LeadMagic connection, returning one cursor page.

Search Meta Ads V1

Search for Meta ads by company domain or name.

Search People

Search people by company, title, role, free text and contact availability, returning one cursor-controlled page without requesting raw email or mobile details.

Search People V1 Legacy Docs Alias

Search people through the legacy POST /v1/people/search compatibility route, returning one base-only cursor page without requesting raw contact details.

Search People V2 Legacy Docs Alias

Search people through the legacy POST /v2/people/search compatibility route, returning one base-only cursor page without requesting raw contact details.

Search People V3 By Title Docs Alias

Search people through POST /v3/people/by-title, returning one base-only cursor page without requesting raw contact details.

Search People V3 Company Docs Alias

Search people through POST /v3/people/company-search, returning one cursor page without requesting raw contact details.

Search People V3 Contacts By Title Docs Alias

Search people through POST /v3/people/contacts-by-title, returning one base-only cursor page without requesting raw contact details.

Search People V3 Employees Docs Alias

Search people through POST /v3/people/employees, returning one base-only cursor page without requesting raw contact details.

Search People V3 Full Docs Alias

Search for people using the V3 full-search alias, with company and people filters and cursor pagination.

Search People V3 Icp Docs Alias

Search people through POST /v3/people/icp-search, returning one base-only cursor page without requesting raw contact details.

Search People V3 Lookalike Docs Alias

Search people through POST /v3/people/lookalike, returning one base-only cursor page without requesting raw contact details.

Search People V3 Mixed Docs Alias

Search people through POST /v3/people/mixed-search, returning one cursor page without requesting raw contact details.

Search People V3 Singular Docs Alias

Search people through POST /v3/person/search, returning one cursor page of base person data without requesting raw contacts.

Submit Bulk Job

Create one asynchronous bulk enrichment job using exactly one input mode: inline rows, CSV, a remote file, or a scrape.

Submit Bulk Local Leads Job

Create a long-running local-leads bulk job from keywords and cities; each keyword-city combination may be charged.

Submit Mixed Product Batch

Create an asynchronous mixed-product enrichment batch of up to 500 items.

Update Batch Metadata

Update metadata or the client association for an owned batch during its mutable window.

Update Bulk Job Priority

Change the priority of a queued or running LeadMagic bulk job owned by the connected workspace.

Update Credit Budget

Update one or more controls on a credit budget created and owned by the caller, using its ID from the owned budget lifecycle.

Validate Bulk Submission

Validate one bulk input mode and its options using a connected API key without persisting or processing a job.

Validate Email

Check one email address for deliverability and return mail-server and company context when available.

SETUP GUIDE

Connect LeadMagic MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["leadmagic"],
  mcp: true,
});
Create a session scoped to LeadMagic and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find emails for VP of Sales",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a LeadMagic request
SETUP GUIDE

Connect LeadMagic API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["leadmagic"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to LeadMagic
3

Run LeadMagic tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find emails for VP of Sales" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the LeadMagic tool calls through the session, and print the final answer

Why Use Composio?

AI Native LeadMagic Integration

  • Supports both LeadMagic MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your LeadMagic data

Managed Auth

  • Built-in API key handling with secure storage
  • Central place to manage, scope, and revoke LeadMagic access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access LeadMagic
  • Scoped, least privilege access to LeadMagic resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Yes, LeadMagic requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your LeadMagic connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Create the key in your LeadMagic account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the LeadMagic actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside LeadMagic at any time.

When you connect a LeadMagic account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in LeadMagic as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside LeadMagic. If LeadMagic lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside LeadMagic at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each LeadMagic connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment LeadMagic rejects the old key. Create a new key in LeadMagic and reconnect the account from the Composio dashboard or by asking your agent to reconnect LeadMagic. Nothing else changes.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal LeadMagic use. Paid plans add higher limits and team features. Your LeadMagic plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple LeadMagic accounts).

With Composio, you connect LeadMagic once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with LeadMagic.It takes 30 seconds.

Managed auth, hosted MCP servers, and every LeadMagic tool your agent needs.Free to start.

Start building