How do I install the MCP Integration skill?

Run npx skillmds@latest add leadmagic/mcp-integration in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is MCP Integration safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with MCP Integration?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is MCP Integration free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published MCP Integration?

LeadMagic (@leadmagic) published this skill. Their other Agent Skills are listed on their SkillMD profile.

MCP Integration by leadmagic — Agent Skill

Name: MCP Integration
Author: LeadMagic

MCP Integration

LeadMagic hosted MCP setup for Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code. Use when installing the LeadMagic MCP server at mcp.leadmagic.io, configuring OAuth, choosing between MCP and REST, or mapping MCP tools to REST enrichment endpoints.

LeadMagic db9cdeb 3.0 KB Updated Sep 17, 2026

File contents

LeadMagic — MCP integration

Prefer the hosted MCP over hand-rolled curl in agent sessions: OAuth (no key in shell history), server-side token handling, and composite tools that replace multi-call chains.

URL: https://mcp.leadmagic.io/mcp
Setup docs: leadmagic.io/docs/mcp/setup
Plugin (bundles this + skills + hooks): LeadMagic/leadmagic-skills

Config

Claude Code: claude mcp add --transport http leadmagic https://mcp.leadmagic.io/mcp

Cursor configuration (other clients use their own formats; consult the setup docs):

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

Complete OAuth in the browser on first use. 401 later → reconnect OAuth in the client (do not add a REST API key to this OAuth configuration). 402 → credits/billing.

Tool → REST map (core)

MCP tool	REST equivalent
`check_credit_balance` / `preview_cost`	`GET /v1/credits` / `POST /v1/batch/preview-cost` (free)
`find_work_email` / `validate_work_email`	email-finder / email-validation
`find_personal_email` / `find_mobile_number`	personal-email-finder / mobile-finder
`b2b_profile_to_work_email` / `email_to_b2b_profile`	b2b-profile-email / b2b-profile
`search_profile` / `enrich_contact`	profile-search (+composite)
`search_people` / `find_people_by_role` / `find_company_employees`	v3 people search / role-finder / employee-finder
`enrich_company` / `account_intel` / `research_account`	company-search (+composite brief)
`find_company_funding` / `get_company_technographics`	company-funding / technographics
`find_lookalike_companies` / `list_company_competitors`	v3 lookalike / competitors-search
`find_decision_makers`	role/employee composite
`find_jobs` / `search_jobs` / `get_job_search_catalogs`	jobs search + free catalogs
`get_company_hiring_signals`	`/v1/jobs/companies/{domain}/hiring-signals`
`detect_job_change`	job-change-detector
`search_google_ads` / `search_meta_ads` / `search_b2b_ads` / `get_b2b_ad_details`	ads endpoints
`submit_bulk_job` / `process_attached_csv` / `get_bulk_job_status`	`/bulk/*`
`get_account_analytics`	`/v1/analytics/*` (free)

Usage rules

Prefer composites (account_intel, enrich_contact, find_decision_makers) over long primitive chains.
Free first: check_credit_balance + preview_cost before expensive or bulk work.
One record → single tools; CSV/list → bulk path; poll get_bulk_job_status ≥45s apart.
Pass company_domain (e.g. stripe.com) when identifying companies.

---name: mcp-integrationdescription: LeadMagic hosted MCP setup for Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code. Use when installing the LeadMagic MCP server at mcp.leadmagic.io, configuring OAuth, choosing between MCP and REST, or mapping MCP tools to REST enrichment endpoints.license: MIT---# LeadMagic — MCP integrationPrefer the **hosted MCP** over hand-rolled `curl` in agent sessions: OAuth (no key in shell history), server-side token handling, and composite tools that replace multi-call chains.- **URL:** `https://mcp.leadmagic.io/mcp`- **Setup docs:** [leadmagic.io/docs/mcp/setup](https://leadmagic.io/docs/mcp/setup?utm_source=github&utm_medium=skill&utm_campaign=leadmagic-skills)- **Plugin (bundles this + skills + hooks):** [LeadMagic/leadmagic-skills](https://github.com/LeadMagic/leadmagic-skills)## ConfigClaude Code: `claude mcp add --transport http leadmagic https://mcp.leadmagic.io/mcp`Cursor configuration (other clients use their own formats; consult the setup docs):```jsonc{ "mcpServers": { "leadmagic": { "url": "https://mcp.leadmagic.io/mcp" } }}```Complete OAuth in the browser on first use. **401 later → reconnect OAuth in the client** (do not add a REST API key to this OAuth configuration). 402 → credits/billing.## Tool → REST map (core)| MCP tool | REST equivalent ||----------|----------------|| `check_credit_balance` / `preview_cost` | `GET /v1/credits` / `POST /v1/batch/preview-cost` (free) || `find_work_email` / `validate_work_email` | email-finder / email-validation || `find_personal_email` / `find_mobile_number` | personal-email-finder / mobile-finder || `b2b_profile_to_work_email` / `email_to_b2b_profile` | b2b-profile-email / b2b-profile || `search_profile` / `enrich_contact` | profile-search (+composite) || `search_people` / `find_people_by_role` / `find_company_employees` | v3 people search / role-finder / employee-finder || `enrich_company` / `account_intel` / `research_account` | company-search (+composite brief) || `find_company_funding` / `get_company_technographics` | company-funding / technographics || `find_lookalike_companies` / `list_company_competitors` | v3 lookalike / competitors-search || `find_decision_makers` | role/employee composite || `find_jobs` / `search_jobs` / `get_job_search_catalogs` | jobs search + free catalogs || `get_company_hiring_signals` | `/v1/jobs/companies/{domain}/hiring-signals` || `detect_job_change` | job-change-detector || `search_google_ads` / `search_meta_ads` / `search_b2b_ads` / `get_b2b_ad_details` | ads endpoints || `submit_bulk_job` / `process_attached_csv` / `get_bulk_job_status` | `/bulk/*` || `get_account_analytics` | `/v1/analytics/*` (free) |## Usage rules- Prefer composites (`account_intel`, `enrich_contact`, `find_decision_makers`) over long primitive chains.- Free first: `check_credit_balance` + `preview_cost` before expensive or bulk work.- One record → single tools; CSV/list → bulk path; poll `get_bulk_job_status` ≥45s apart.- Pass `company_domain` (e.g. `stripe.com`) when identifying companies.

Frequently asked questions