LeadMagic MCP for AI Agents

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 one owned suppression list; LeadMagic stores only normalized SHA-256 hashes.

Create Credit Budget

Create a persistent credit budget that caps spend for one LeadMagic scope.

Create Email Suppression List

Create an owned suppression list from a unique list_id and non-empty plaintext email list.

Create Job Search Export V3

Synchronously export up to 5,000 matching jobs.

Delete Credit Budget

Permanently delete one credit budget.

Delete Email Suppression List

Permanently delete an entire suppression list and its stored hashes.

Detect Job Change

Check whether a person has changed jobs relative to an expected company.

Download Bulk Job Results CSV

Download all result rows for an owned bulk job as a CSV file.

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

Call the distinct documented POST /v3/companies/enrich alias.

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, returning names, titles, locations, and professional profile URLs.

Find Jobs V1

Call POST /v1/jobs/jobs-finder to find jobs with the LeadMagic V1 filters.

Find Lookalike Companies V3

Find similar companies from a seed domain, name, or description.

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.

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

Return the connected workspace's available credits, API-key permission summary, current rate limits, and today's usage.

Get Analytics All Time Summary

Get documented lifetime account request, credit, product, success, and latency statistics, optionally restricted to a date range.

Get Analytics Credit History

Get LeadMagic credit consumption history with a daily breakdown.

Get Analytics Daily Metrics

Get documented daily request, credit, latency, and error metrics for the last 1 to 90 days.

Get Analytics Day Breakdown

Get the documented per-product request and credit breakdown for one date.

Get Analytics Products

Get per-product LeadMagic usage with request, credit, and success metrics.

Get Analytics Usage

Get daily LeadMagic usage with request, credit, and chargeable-rate totals.

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.

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.

Get Batch Campaign Metrics

Read aggregate usage and success metrics for a batch campaign.

Get Batch Client Metrics

Read aggregate batch usage and success metrics for one client UUID.

Get Bulk Capabilities

Return the current bulk submission limits and supported operational features in a stable agent-facing shape.

Get Bulk Job

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

Get Bulk Job Progress

Return LeadMagic's 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

Call the distinct documented POST /v3/companies/company-funding alias.

Get Company Funding V3 Docs Alias

Call the distinct documented POST /v3/companies/funding alias.

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 for free.

Get Credit Budget Status

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

Get Credit Service Health V1 Docs Only

Validate the connected LeadMagic API key and check credit-service authentication status.

Get Email Suppression List

Return one offset-controlled page of details and irreversible SHA-256 email hashes for one owned suppression list.

Get Job Board Stats V3

Return the free job search dataset statistics through LeadMagic's exact job-board integration alias 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 coverage, freshness, and capability statistics for the LeadMagic Jobs Search index.

Get Search Stats

Return free cached coverage, capabilities, and top dimensions for selected LeadMagic search products.

List Batch Clients

List existing organization-scoped client records used to segment batch work.

List Batch Client Webhooks

List delivery webhooks configured for one batch client.

List Batches

List one bounded page of mixed-product batches for the connected organization.

List Bulk Job Errors

Return one offset-controlled page of failed rows and error details for a bulk job owned by the connected workspace.

List Bulk Job Events

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

List Bulk Job Results

Return one bounded offset page of row-level JSON results for an owned bulk job.

List Bulk Jobs

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

List Credit Budgets

List all persistent credit budgets configured for the connected LeadMagic workspace, including identifiers needed for owned-budget lifecycle operations.

List Email Suppression Lists

Read all suppression-list summaries for the connected workspace.

List External Batch Providers

List organization-level external enrichment provider configurations.

List Job Company Types V1

List the company type IDs accepted by the legacy V1 Jobs Finder API.

List Job Countries V1

List the free country codes accepted by the legacy V1 Jobs Finder API.

List Job Industries V1

List the industry IDs accepted by 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 the free region IDs accepted by 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 the job type IDs accepted by the legacy V1 Jobs Finder API.

Lookup Company Domain V3 Docs Alias

Call the distinct documented POST /v3/companies/domain-lookup alias.

Lookup Company V3 Docs Alias

Call the distinct documented POST /v3/companies/lookup alias.

Pause Bulk Job

Pause a queued or running LeadMagic bulk job.

Preview Mixed Batch Cost

Estimate the maximum credit cost and budget impact of an exact mixed-product batch payload.

Refresh Credit Cache V1 Docs Only

Force LeadMagic to refresh the connected workspace's credit cache from its database.

Remove Emails From Suppression List

Irreversibly remove specific email suppressions from one owned list, allowing those addresses to be processed again.

Resolve Job Search Filters V3

Resolve friendly job-search companies, tags, occupation taxonomy, locations, and titles into canonical values.

Restart Bulk Job

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

Resume Bulk Job

Resume a paused LeadMagic bulk job.

Review Bulk Job

Resume or irreversibly cancel an owned bulk job.

Search B2B Ads V1

Search for B2B ads by company domain or name.

Search Companies

Call the canonical POST /v3/companies/search route to search or look up companies by domain, name, website, professional profile URL, or company filters and return one cursor-controlled page.

Search Companies V1 Legacy Docs Alias

Call the distinct legacy compatibility route POST /v1/companies/search.

Search Companies V3 Company Hyphenated Docs Alias

Call the distinct documented POST /v3/companies/company-search alias.

Search Google Ads V1

Search for Google ads run by a company.

Search Jobs

Call the canonical POST /v3/jobs/search route to search by title, company, location, taxonomy, tags, salary, seniority, date, and work arrangement, returning one cursor-controlled page.

Search Jobs V1 Legacy Docs Alias

Call the distinct legacy compatibility route POST /v1/jobs/search; prefer POST /v3/jobs/search for new integrations.

Search Jobs V2 Legacy Docs Alias

Call the distinct legacy compatibility route POST /v2/jobs/search; prefer POST /v3/jobs/search for new integrations.

Search Jobs V3 Hyphenated OpenAPI Alias

Search the distinct documented POST /v3/jobs-search alias and return one cursor-controlled page.

Search Jobs V3 Singular Docs Alias

Call the distinct documented compatibility route POST /v3/job-search; prefer POST /v3/jobs/search for new integrations.

Search Meta Ads V1

Search for Meta ads by company domain or name.

Search People

Call the canonical POST /v3/people/search route to search by company, title, role, free text, and contact availability, returning one cursor-controlled page without raw email or mobile details.

Search People V1 Legacy Docs Alias

Call the distinct legacy compatibility route POST /v1/people/search; prefer the canonical V3 route for new integrations.

Search People V2 Legacy Docs Alias

Call the distinct legacy compatibility route POST /v2/people/search; prefer the canonical V3 route for new integrations.

Search People V3 By Title Docs Alias

Call the distinct compatibility route POST /v3/people/by-title; prefer the canonical route for new integrations.

Search People V3 Company Docs Alias

Call the distinct documented POST /v3/people/company-search alias.

Search People V3 Contacts By Title Docs Alias

Call the distinct compatibility route POST /v3/people/contacts-by-title; prefer the canonical route for new integrations.

Search People V3 Employees Docs Alias

Call the distinct compatibility route POST /v3/people/employees; prefer the canonical route for new integrations.

Search People V3 Full Docs Alias

Call the distinct documented POST /v3/people/full-search alias.

Search People V3 Icp Docs Alias

Call the distinct documented compatibility route POST /v3/people/icp-search; prefer POST /v3/people/search for new integrations.

Search People V3 Lookalike Docs Alias

Call the distinct compatibility route POST /v3/people/lookalike; prefer the canonical route for new integrations.

Search People V3 Mixed Docs Alias

Call the distinct documented POST /v3/people/mixed-search alias.

Search People V3 Singular Docs Alias

Call the distinct documented POST /v3/person/search alias.

Submit Bulk Job

Create one asynchronous bulk enrichment job from exactly one input mode.

Submit Bulk Local Leads Job

Create a long-running local-leads bulk job.

Submit Mixed Product Batch

Create one asynchronous mixed-product enrichment batch.

Update Batch Metadata

Update metadata or 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.

Validate Bulk Submission

Validate exactly one bulk input mode and its options without persisting or processing a job.

Validate Email

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

SETUP GUIDE

Connect LeadMagic MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

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

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for LeadMagic
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect LeadMagic API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

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

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute LeadMagic Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute LeadMagic actions with your Agent

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 OAuth handling with automatic token refresh and rotation
  • 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
FRAMEWORKS

Use LeadMagic with any AI Agent Framework

Choose a Framework you want to connect LeadMagic with

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.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

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

Start with LeadMagic.It takes 30 seconds.

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

Start building