The LeadMagic MCP server exposes 16 tools, 1 resource, and 2 prompts. Each tool maps directly to a LeadMagic API endpoint — the AI calls the right one based on your request.
Credits are only charged when data is found. not_found results are free. See Credits & Pricing for full details.
Credit Cost Summary
| Tool | Credits | Free When |
|---|
validate_email | 1 per 20 validations | catch_all, unknown results |
find_email | 1 | Not found |
find_mobile | 5 | Not found |
search_profile | 1 | Not found |
email_to_b2b_profile | 10 | Not found |
find_personal_email | 2 | Not found |
social_to_email | 5 | Not found |
find_role | 2 | Not found |
find_employees | 1 per 20 employees | — |
detect_job_change | 3 | Not found |
search_company | 1 | Not found |
find_competitors | 5 | Not found |
get_company_funding | 4 | Not found |
get_technographics | 1 | Not found |
find_jobs | 1 per job | — |
check_credits | Free | Always free |
validate_email
Validate an email address for deliverability. Returns status, MX records, and company enrichment data.
| Parameter | Type | Required | Description |
|---|
email | string (email) | Yes | Email address to validate |
Credits: 1 per 20 validations (0.05 each). Free for catch_all and unknown results.
Example prompt: “Validate the email john@acme.com”
API Reference: Email Validation
find_email
Find a professional work email from a person’s name and company. Prefer domain over company_name for best results.
| Parameter | Type | Required | Description |
|---|
first_name | string | No | First name |
last_name | string | No | Last name |
full_name | string | No | Full name (alternative to first + last) |
domain | string | No | Company domain (preferred) |
company_name | string | No | Company name |
Requires (first_name + last_name OR full_name) AND (domain OR company_name).
Credits: 1. Free if not found.
Example prompt: “Find the work email for Jane Smith at stripe.com”
API Reference: Email Finder
find_mobile
Find a direct mobile phone number. Provide at least one identifier.
| Parameter | Type | Required | Description |
|---|
profile_url | string | No | LinkedIn profile URL or username |
work_email | string (email) | No | Work email address |
personal_email | string (email) | No | Personal email address |
At least one parameter is required.
Credits: 5. Free if not found.
Example prompt: “Find the mobile number for linkedin.com/in/janesmith”
API Reference: Mobile Finder
search_profile
Get a full professional profile including work history, education, and skills.
| Parameter | Type | Required | Description |
|---|
profile_url | string | No | LinkedIn profile URL (preferred) |
work_email | string (email) | No | Work email address |
personal_email | string (email) | No | Personal email address |
first_name | string | No | First name |
last_name | string | No | Last name |
company_name | string | No | Current company name |
At least one parameter is required.
Credits: 1. Free if not found.
Example prompt: “Get the full profile for linkedin.com/in/janesmith”
API Reference: Profile Search
email_to_b2b_profile
Find a LinkedIn profile URL from an email address.
| Parameter | Type | Required | Description |
|---|
work_email | string (email) | No | Work email address |
personal_email | string (email) | No | Personal email address |
At least one parameter is required.
Credits: 10. Free if not found.
Example prompt: “Find the LinkedIn profile for john@acme.com”
API Reference: Email to Profile
find_personal_email
Find personal email addresses from a LinkedIn profile URL.
| Parameter | Type | Required | Description |
|---|
profile_url | string | Yes | LinkedIn profile URL |
Credits: 2. Free if not found.
Example prompt: “Find personal emails for linkedin.com/in/janesmith”
API Reference: Personal Email Finder
social_to_email
Convert a LinkedIn profile URL to a verified work email. Optional name and company improve accuracy.
| Parameter | Type | Required | Description |
|---|
profile_url | string | Yes | LinkedIn profile URL |
first_name | string | No | First name (improves accuracy) |
last_name | string | No | Last name (improves accuracy) |
company_name | string | No | Company name (improves accuracy) |
Credits: 5. Free if not found.
Example prompt: “Get the work email for linkedin.com/in/janesmith”
API Reference: Profile to Email
find_role
Find people in a specific role at a company.
| Parameter | Type | Required | Description |
|---|
company_name | string | Yes | Company name |
job_title | string | No | Job title to search for |
location | string | No | Location filter |
Credits: 2. Free if not found.
Example prompt: “Find the VP of Sales at Snowflake”
API Reference: Role Finder
find_employees
List employees at a company.
| Parameter | Type | Required | Description |
|---|
company_name | string | Yes | Company name |
domain | string | No | Company domain |
location | string | No | Location filter |
limit | number | No | Max results (1–1000) |
Credits: 1 per 20 employees.
Example prompt: “List employees at Acme Corp in San Francisco”
API Reference: Employee Finder
detect_job_change
Check if a contact has recently changed jobs.
| Parameter | Type | Required | Description |
|---|
email | string (email) | No | Work or personal email |
profile_url | string | No | LinkedIn profile URL |
first_name | string | No | First name |
last_name | string | No | Last name |
company_name | string | No | Previous company name |
At least one parameter is required.
Credits: 3. Free if not found.
Example prompt: “Has john@acme.com changed jobs recently?”
API Reference: Job Change Detector
search_company
Enrich company data by domain, name, or LinkedIn URL. Prefer domain for fastest and most accurate results.
| Parameter | Type | Required | Description |
|---|
domain | string | No | Company domain (preferred) |
company_name | string | No | Company name |
profile_url | string | No | LinkedIn company URL |
At least one parameter is required.
Credits: 1. Free if not found.
Example prompt: “Get company info for stripe.com”
API Reference: Company Search
find_competitors
Find competitor companies.
| Parameter | Type | Required | Description |
|---|
company_name | string | Yes | Company name |
domain | string | No | Company domain |
industry | string | No | Industry filter |
Credits: 5. Free if not found.
Example prompt: “Who are Stripe’s competitors?”
API Reference: Competitors Search
get_company_funding
Get funding history including rounds, investors, and amounts.
| Parameter | Type | Required | Description |
|---|
company_name | string | Yes | Company name |
domain | string | No | Company domain |
Credits: 4. Free if not found.
Example prompt: “How much funding has Notion raised?”
API Reference: Company Funding
get_technographics
Identify the technology stack a company uses.
| Parameter | Type | Required | Description |
|---|
company_name | string | Yes | Company name |
domain | string | No | Company domain |
Credits: 1. Free if not found.
Example prompt: “What tech stack does stripe.com use?”
API Reference: Technographics
find_jobs
Search job postings by company, title, location, and more.
| Parameter | Type | Required | Description |
|---|
company_name | string | No | Company name |
job_title | string | No | Job title to search for |
location | string | No | Location filter |
country | string | No | Country filter |
region | string | No | Region filter |
job_type | string | No | Job type filter |
industry | string | No | Industry filter |
Credits: 1 per job returned.
Example prompt: “Find engineering jobs at Stripe in San Francisco”
API Reference: Jobs Finder
check_credits
Check your remaining LeadMagic credit balance.
| Parameter | Type | Required | Description |
|---|
| (none) | — | — | No parameters required |
Credits: Always free.
Example prompt: “How many credits do I have?”
API Reference: Check Credits
Resources
The MCP server exposes one resource that AI clients can read for context.
| Resource | URI | Type | Description |
|---|
| LeadMagic API Documentation | leadmagic://docs | text/markdown | Credit costs, rate limits, best practices, and API reference |
The AI client can read this resource to understand how to use LeadMagic tools effectively — including which parameters to prefer and how to optimize credit usage.
Prompts
The server provides two built-in prompts that guide the AI through common workflows.
enrich_lead
Enrich a lead with email, company, and profile data.
| Parameter | Type | Required | Description |
|---|
name | string | No | Person’s name |
company | string | No | Company name |
linkedin_url | string | No | LinkedIn profile URL |
Usage: “Enrich the lead Jane Smith at Acme Corp”
The AI will use this prompt to orchestrate multiple tool calls — finding the email, searching the profile, and enriching the company data.
validate_emails
Validate a list of email addresses for deliverability.
| Parameter | Type | Required | Description |
|---|
emails | string | Yes | Comma-separated list of email addresses |
Usage: “Validate these emails: john@acme.com, jane@stripe.com, bob@notion.so”
The AI will validate each email and summarize the results (valid, invalid, catch-all, unknown).