LeadMagic
LeadMagic provides people, company, jobs, advertising, and enrichment data for sales and recruiting workflows.
Verdict
Common use cases
- Export job postings matching hiring signals
- Verify email deliverability before cold outreach
- Detect when a prospect changes employers
- Build suppression lists for compliance
- Enrich lead records with current job titles
Integration
- Vendor
- LeadMagic
- Category
- other
- Auth
- API_KEY
- Tools
- 50
- Composio slug
leadmagic
Tools
- Add Emails To Suppression List
Add a non-empty plaintext email list to one owned suppression list; LeadMagic stores only normalized SHA-256 hashes. Use the exact list_id captured in the same create lifecycle and only addresses intentionally owned by that workflow.
- Create Credit Budget
Create a persistent credit budget that caps spend for one LeadMagic scope. Record the returned id so the owned budget can be updated or deleted later.
- Create Email Suppression List
Create an owned suppression list from a unique list_id and non-empty plaintext email list. LeadMagic hashes emails server-side. Capture the returned list_id, use only that exact ID for subsequent reads or mutations, and always delete the ow
- Create Job Search Export V3
Synchronously export up to 5,000 matching jobs. At least one search filter is required. This route is credit-metered, but LeadMagic does not publish an exact rate. The limit defaults to 1 and bounds result count, not guaranteed credit expos
- Delete Credit Budgetdestructive
Permanently delete one credit budget. This is an irreversible teardown action: use only the exact budget ID captured from Create Credit Budget in the same owned lifecycle, and never delete a budget discovered by listing workspace data.
- Delete Email Suppression Listdestructive
Permanently delete an entire suppression list and its stored hashes. This is an irreversible teardown action: use only the exact list_id captured from Create Email Suppression List in the same owned lifecycle, never a pre-existing list.
- Detect Job Change
Check whether a person has changed jobs relative to an expected company. A resolved check costs 3 credits; PROFILE_NOT_FOUND costs 0 credits.
- Download Bulk Job Results CSV
Download all result rows for an owned bulk job as a CSV file. Use only a jobId captured from the same submission chain. The streamed download is offloaded and fails if it exceeds the documented 50 MiB bulk source-size bound.
- Enrich Company V1
Call POST /v1/companies/company-search to enrich one company from its domain, name, or business profile identifier. A successful enriched-company result costs 1 credit; use credits_consumed as the finalized spend.
- Enrich Company V3 Docs Alias
Call the distinct documented POST /v3/companies/enrich alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does no
- Find Company Competitors V1
Find competitors from a company domain, profile, or name. A successful competitor list costs 5 credits.
- Find Company Employees V1
Find up to 10 employees at one company, returning names, titles, locations, and professional profile URLs. Provider documentation conflicts between 0.05 and 1 credit per returned employee, so treat 1 credit per result as the exposure bound
- Find Jobs V1
Call POST /v1/jobs/jobs-finder to find jobs with the LeadMagic V1 filters. Each returned job costs 1 credit; an empty result costs 0 credits. per_page is capped at 50.
- Find Lookalike Companies V3
Find similar companies from a seed domain, name, or description. The OpenAPI contract documents a flat 5-credit charge for a non-empty result and no charge when empty; another provider surface says 1 credit, so use credits_consumed as the f
- Find Mobile Phone
Find one person's mobile phone number from a professional profile URL or known email. A found mobile number costs 5 credits; no result is free. Exactly one person is processed per call.
- Find Personal Email
Find one person's personal email addresses from a professional profile URL or identifier. A successful result costs 2 credits. Personal email addresses are sensitive personal data; use this tool only for a lawful, authorized purpose.
- Find Person By Role V1
Find one person by job title at a specified company. A successful match costs 2 credits; rely on credits_consumed as finalized spend. The response can contain personal identity and professional profile data.
- Find Work Email
Find one person's work email from their name and company domain or name. A found valid email costs 1 credit; no result is free. Exactly one person is processed per call.
- Find Work Email From B2B Profile
Find one person's work email from a professional profile URL or slug. LeadMagic's published sources conflict on whether a successful result costs 1 or 5 credits; treat 5 credits as the maximum documented exposure and use credits_consumed as
- Get Account Overview
Return the connected workspace's available credits, API-key permission summary, current rate limits, and today's usage. This read is free.
- Get Analytics All Time Summary
Get documented lifetime account request, credit, product, success, and latency statistics, optionally restricted to a date range. This free analytics route was not individually live-probed during the build.
- 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. This free analytics route was not individually live-probed during the build.
- Get Analytics Day Breakdown
Get the documented per-product request and credit breakdown for one date. This free analytics route was not individually live-probed during the build.
- 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. A successful full-details lookup costs exactly 2 credits; use credits_consumed as finalized spend.
- Get B2B Profile From Email
Find one person's professional profile from a supplied work or personal email. A found complete profile costs 10 credits. Email addresses and matched profile data are personal data; submit and use them only for a lawful, authorized purpose.
- Get B2B Profile From Profile URL
Retrieve one person's professional profile, including employment, education, certifications, and honors, from a profile URL or slug. A found full profile costs 1 credit. Returned profile data is personal data; use it only for a lawful, auth
- Get Batch
Read status, progress, cost, and metadata for a mixed-product batch by its exact batch identifier. A missing synthetic identifier safely returns not found and does not mutate or spend credits.
- Get Batch Campaign Metrics
Read aggregate usage and success metrics for a batch campaign. A syntactically valid missing identifier can be used for a safe, non-mutating not-found check.
- Get Batch Client Metrics
Read aggregate batch usage and success metrics for one client UUID. An all-zero missing UUID is safe for a non-mutating not-found check.
- Get Bulk Capabilities
Return the current bulk submission limits and supported operational features in a stable agent-facing shape. Service-internal host and deployment metadata are intentionally omitted.
- Get Bulk Job
Read status, progress, timestamps, and finalized credit usage for one bulk job. Pass a jobId captured from the same owned submission workflow; do not inspect an unrelated workspace job.
- Get Bulk Job Progress
Return LeadMagic's compact progress snapshot for frequent polling of one bulk job owned by the connected workspace. This read does not start, stop, or restart processing.
- Get Company Funding V1
Call POST /v1/companies/company-funding to get complete funding history and related company intelligence by domain or name. A successful funding result costs 4 credits.
- Get Company Funding V3 Company Docs Alias
Call the distinct documented POST /v3/companies/company-funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagi
- Get Company Funding V3 Docs Alias
Call the distinct documented POST /v3/companies/funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does n
- Get Company Technographics V1
Get a company's technology stack from its domain. A successful stack result costs 1 credit; use credits_consumed as finalized spend.
- 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. This does not reserve or consume credits.
- Get Credit Service Health V1 Docs Only
Validate the connected LeadMagic API key and check credit-service authentication status. This medium-confidence docs-only read has an undocumented response schema and billing behavior and was not live-probed.
- Get Email Suppression List
Return one offset-controlled page of details and irreversible SHA-256 email hashes for one owned suppression list. Use only the exact list_id captured in the same create lifecycle, never auto-fetch pages, and continue only with the returned
- 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. This helper consumes 0 credits.
- 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. Requested product sections may be absent when unavailable. This helper costs 0 credits.
- List Batch Clients
List existing organization-scoped client records used to segment batch work. This read does not create or modify clients.
- List Batch Client Webhooks
List delivery webhooks configured for one batch client. This read does not create, change, or invoke webhooks.
- List Batches
List one bounded page of mixed-product batches for the connected organization. Continue only with the returned next_offset; this tool never auto-fetches additional pages.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings → Integrations → MCP Servers. 2. Click Add MCP Server and select LeadMagic from the directory. 3. Log in to your LeadMagic dashboard, copy your API key from the Developers or API Keys section, then paste it into the Switchy configuration modal. 4. Click Connect; Switchy will validate the key and confirm the connection. 5. Open any Project and type '@LeadMagic' in a message to see available tools autocomplete. 6. Test the connection by asking '@LeadMagic, check if john.doe@example.com is deliverable' — if you see a verification result, the integration is live. 7. Monitor your credit usage in the LeadMagic dashboard; each enrichment or export consumes credits, and you can create budgets via Switchy to cap spend per project.
What teammates see: by default, memories from LeadMagic are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Export Sales Engineer Jobs
@LeadMagic, export jobs with title 'Sales Engineer', seniority 'Mid-Senior', and location 'United States'. Limit to 500 results and show company name, job title, and posting date.
Verify Prospect Email
@LeadMagic, verify the email address sarah.chen@acmecorp.com and tell me if it's safe to send cold outreach.
Detect Job Changes
@LeadMagic, check if Michael Torres still works at DataFlow Inc. If he's moved, return his new employer and title.
Create Suppression List
@LeadMagic, create a new suppression list called 'Q1_Unsubscribes' from the emails in the attached CSV. Store only the hashes and return the list ID.
Set Credit Budget
@LeadMagic, create a credit budget of 1,000 credits for this project. Label it 'Enterprise_Outreach_March' and return the budget ID so I can track usage.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@LeadMagic search for software engineering jobs at Series B startups in San Francisco, limit 100 results
Found 87 matching jobs: • Senior Backend Engineer at Acme Analytics (Series B, $45M raised) – San Francisco, CA – Posted 3 days ago • Full-Stack Engineer at DataFlow Inc (Series B, $32M raised) – San Francisco, CA – Posted 1 week ago • Platform Engineer at CloudSync (Series B, $28M raised) – San Francisco, CA – Posted 2 days ago [...84 more results] This search consumed approximately 87 credits (1 credit per result returned). The export includes company funding stage, location, posting date, and role title for each match.
Job searches are credit-metered but LeadMagic does not publish exact per-result costs in their docs. The 5,000-result ceiling means broad searches may truncate silently. Requires at least one filter (location, title keyword, company stage, etc.) — empty searches will fail. API_KEY scope must include job-search access.
@LeadMagic check if john.doe@example.com still works at Acme Corp, then add him to our outreach suppression list if he's moved
Job-change check: john.doe@example.com has left Acme Corp. Current employer detected as NewCo Inc as of 14 days ago (3 credits consumed). Added john.doe@example.com to suppression list 'outreach_q1_2025'. LeadMagic stored the normalized SHA-256 hash; the plaintext address is not retained. This list now contains 1,247 hashed emails. Future enrichment or send operations will skip any address matching this hash.
Job-change detection costs 3 credits per resolved check; PROFILE_NOT_FOUND results cost 0 credits. Suppression lists store only SHA-256 hashes server-side, so you cannot export the original email addresses later. Use the exact list_id from your Create Email Suppression List call — mismatched IDs will fail silently or create orphaned lists.
@LeadMagic create a $500 credit budget for our Q1 lead-gen campaign, then summarize how many credits we've burned this month across all job searches
Created credit budget 'Q1_leadgen_2025' with a $500 cap (budget_id: bg_a1b2c3d4). This budget is now active and will block requests once the threshold is reached. Month-to-date credit usage (January 2025): • Job searches: 1,843 credits (~$184 at standard rates) • Job-change detection: 267 credits (89 checks × 3 credits) • Total: 2,110 credits consumed You have ~$316 remaining in the new Q1 budget before requests are rejected. Budget deletion is irreversible, so capture bg_a1b2c3d4 if you need to adjust the cap later.
Credit budgets are persistent spend caps tied to your API_KEY scope. Once created, record the returned budget_id — you'll need that exact ID to update or delete the budget. Deleting a budget is irreversible and will not refund consumed credits. LeadMagic does not auto-alert when you approach the cap; monitor usage via separate API calls or dashboard.
Use-case deep-dives
When LeadMagic beats manual LinkedIn scraping for cold outreach
A 2-person sales team at a Series A SaaS company needs 200 qualified leads per week for cold email campaigns. LeadMagic's job-search export and suppression-list tools let them filter by title and company size, pull enriched contact data, and auto-exclude bounced addresses—all in one workflow instead of toggling between LinkedIn Sales Navigator, Apollo, and a spreadsheet. The credit-metered pricing means each export costs real money, so this works when your ICP is narrow enough that you're pulling 500–2,000 records per month, not 50,000. If you're running multi-touch sequences across three verticals, the per-export cost adds up fast and you'll want a flat-rate enrichment vendor instead. For focused outbound at seed or Series A scale, LeadMagic's suppression-list hygiene and job-change detection justify the credit spend.
Why LeadMagic's job-change detection matters for retention teams
A 6-person customer success team at a B2B platform tracks 400 champion users across 80 accounts. When a champion leaves, the renewal is at risk—but most teams only find out when the new contact ghosts them. LeadMagic's Detect Job Change tool costs 3 credits per resolved check, so running a weekly batch on 400 contacts is 1,200 credits or roughly $12–$24 depending on your plan. The team pairs this with a Slack alert: any detected move triggers an immediate handoff call. The trade-off is manual: you need to maintain the list of champions in a CSV or CRM export, then script the batch check. If your CRM already has native job-change signals (HubSpot Enterprise, Salesforce with ZoomInfo), LeadMagic is redundant. But if you're on HubSpot Starter or a lightweight CRM, this is the cheapest way to catch churn risk before it shows up in your renewal dashboard.
When LeadMagic's bulk export scales better than manual sourcing
A 3-person recruiting team at a 40-employee startup needs to fill 8 engineering roles in Q1. They're sourcing from GitHub, conference attendee lists, and referrals—but half the contact info is stale or missing. LeadMagic's bulk job export (up to 5,000 rows) and email suppression lists let them enrich 2,000 candidate records in one pass, strip known opt-outs, and feed clean data into their ATS. The 50-tool surface means they can also script budget caps so a junior recruiter can't accidentally burn $500 in credits on a single export. This breaks down if your candidate pool is over 10,000 per quarter—at that scale, the credit cost and 5,000-row export ceiling push you toward a flat-rate data provider like Clearbit or People Data Labs. For early-stage hiring where you're sourcing 500–3,000 candidates per quarter, LeadMagic's pay-per-use model and suppression hygiene are cheaper than an annual enrichment contract.
Frequently asked
What does the LeadMagic MCP do in Switchy?
It lets your team enrich contact data, detect job changes, and export job postings directly from Switchy prompts. The MCP wraps LeadMagic's 50 tools — including suppression-list management, credit budgets, and bulk enrichment — so you can build prospecting workflows without leaving the workspace. Every call consumes LeadMagic credits from your vendor account.
Do I need a paid LeadMagic account to use this MCP?
Yes. You need an active LeadMagic subscription and an API key. The MCP authenticates with that key and every enrichment or export operation deducts credits from your LeadMagic balance. Free-tier keys may hit rate limits quickly. Check your vendor dashboard before connecting the MCP to avoid surprise overages.
Can the LeadMagic MCP send outbound emails or update my CRM records?
No. It only reads and enriches data from LeadMagic's database. To push enriched contacts into your CRM, you'll need a separate MCP for that system or export the results as CSV and upload manually. The suppression-list tools store hashed emails inside LeadMagic but don't trigger sends.
How does using the MCP compare to calling LeadMagic's API directly?
The MCP saves you from writing auth headers and parsing JSON responses in every prompt. You trade that convenience for less control over retry logic and batch sizes. If your team runs the same enrichment query daily, a custom script will be faster; for ad-hoc research, the MCP is simpler.
Who on my team should connect the LeadMagic MCP?
Whoever owns your LeadMagic subscription and can generate API keys. That person's credit balance applies to every team member's queries in Switchy, so set a credit budget using the MCP's budget tools if you want to cap spend. Only one connection is needed per workspace.