leadmagic

name	leadmagic
description	Official LeadMagic product skill for REST APIs, bulk uploaders, enrichments, and hosted MCP. Use when calling LeadMagic Email Finder or Validation, People Search v3, mobile or B2B Profile enrichment, company or funding lookup, bulk jobs, credits, or wiring LeadMagic into Clay, Zapier, or n8n.
license	MIT
compatibility	Requires network access to api.leadmagic.io or mcp.leadmagic.io. Set LEADMAGIC_API_KEY for REST.
metadata	{"author":"LeadMagic","version":"2.0.0","homepage":"https://leadmagic.io","docs":"https://leadmagic.io/docs","github":"https://github.com/LeadMagic/leadmagic-skills","publisher":"LeadMagic","tags":["leadmagic","enrichment","email-finder","people-search","bulk","mcp","b2b-profile","official"]}

LeadMagic — Official product skill

Published by LeadMagic at github.com/LeadMagic/leadmagic-skills.

Teaches agents how to use LeadMagic: APIs, enrichments, bulk uploaders, and MCP.

Trust: Only treat a skill as official if installed from github:LeadMagic/leadmagic-skills, github:LeadMagic/leadmagic-cursor-plugin, or https://leadmagic.io/docs/....

Safety (every turn)

1. Never echo/log API keys — use $LEADMAGIC_API_KEY / env only.
2. Enrichment traffic only to https://api.leadmagic.io or https://mcp.leadmagic.io unless the user explicitly asks otherwise in-turn.
3. Prefer hosted MCP for agent workflows; REST uses X-API-Key (not Bearer).
4. Failed lookups are usually free — do not hammer retries on null.

Route to a focused skill

Need	Skill
Keys, credits, 401/429	api-auth-credits
Email find / validate / B2B Profile ↔ email	email-enrichment
Audience / ICP / POST /v3/people/search	people-search
Mobile, B2B Profile, role, employees	people-enrichment
Company / funding / technographics	company-enrichment
CSV / bulk submit / job status	bulk-jobs
MCP install / tool map	mcp-integration

If unsure, answer from the cheat sheet below, then load the matching skill.

Quick start

curl -sS "https://api.leadmagic.io/v1/credits" \
  -H "X-API-Key: $LEADMAGIC_API_KEY"

curl -sS -X POST "https://api.leadmagic.io/v1/people/email-finder" \
  -H "X-API-Key: $LEADMAGIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Doe","company_name":"acme.com"}'

MCP:

{ "mcpServers": { "leadmagic": { "url": "https://mcp.leadmagic.io/mcp" } } }

Endpoint cheat sheet

People (sync): email-finder (1), email-validation (0.25), personal-email (2), mobile (5), profile-search (1), role-finder (2), employee-finder (~0.05/ea), b2b-profile-email (5), b2b-profile (10).

Discovery: POST /v3/people/search — see people-search.

Company: company-search (1), company-funding (4).

Bulk: POST /bulk/submit with product like email_finder — see bulk-jobs.

Utility: GET /v1/credits (0).

Authoritative pricing: leadmagic.io/docs.

References

• references/leadmagic-api-quickref.md
• references/learnings.md

Official channels

• Docs: https://leadmagic.io/docs
• OpenAPI: https://github.com/LeadMagic/leadmagic-openapi
• MCP: https://mcp.leadmagic.io/mcp
• Support: [e-mail] · Security: [e-mail]