Skip to content

Repository files navigation

LeadMagic

LeadMagic logo

Official LeadMagic plugin for Cursor. Connect your agent to LeadMagic’s hosted MCP (130+ tools) for B2B research: search people, companies, and jobs; find and validate work emails; look up professional mobile numbers.

LeadMagic · MCP setup · Pricing

This is licensed contact and company intelligence — the same class of product as enterprise GTM data platforms. It is not a scraper. Hosted MCP is OAuth only (no API key in this plugin).

Install today via Team Marketplace import of this repo. /add-plugin leadmagic works after Cursor lists the plugin on cursor.com/marketplace. Canonical plugin URL: mcp.leadmagic.io/cursor-plugin (redirects here).

Install

  1. Open Cursor Dashboard → Plugins → Team Marketplaces → Import from Repo.
  2. Paste https://github.com/LeadMagic/leadmagic-cursor-plugin (same target as https://mcp.leadmagic.io/cursor-plugin).
  3. Enable LeadMagic. The first time a tool hits MCP, Cursor prompts OAuth. Sign in with your LeadMagic account in the browser (Google or email — the same account as app.leadmagic.io). There is no API key to paste.

After official marketplace listing, you can also search LeadMagic in Cursor Settings → Plugins or run /add-plugin leadmagic.

This checkout (local play)

npm ci
npm run install:local

Then Developer: Reload Window. Open Customize and confirm LeadMagic. Complete the browser sign-in when Cursor asks. Local imports must be allowed. A marketplace install with the same name takes precedence.

The installer links this repo at ~/.cursor/plugins/local/leadmagic. npm run uninstall:local removes only this checkout’s link.

Team marketplace import

Dashboard → Plugins → Team Marketplaces → Import from Repo:

https://github.com/LeadMagic/leadmagic-cursor-plugin

Uses .cursor-plugin/marketplace.json with "source": ".".

Sign in

Hosted MCP is https://mcp.leadmagic.io/mcp. Cursor starts OAuth and opens the browser. Sign in with the LeadMagic workspace you already use. Do not add X-API-Key or other headers to mcp.json.

If the browser stops on LeadMagic sign-in, finish it, then return to Cursor. Reconnect from MCP settings if tools still return 401.

Details: docs/authentication.md · LeadMagic MCP authentication.

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

First run

After install and sign-in, ask:

Check my LeadMagic credit balance, then search 5 companies in B2B software in the US. Do not look up emails yet.

That is search first, then look up work emails or professional mobile only for selected people. Results stay in the agent as markdown rows.

What you can do

Four product features. Prefer the live schema and leadmagic://docs. Email Finder returns validated work emails; use validation for addresses you already have. Check credits before paid work. Search and some contact products can be separate entitlements from the main credit wallet.

Feature When MCP tools
Search People, companies, or jobs search_people, search_companies, find_jobs / search_jobs
Work email find Name + company, or B2B profile URL find_work_email, b2b_profile_to_work_email
Work email validate You already have an email validate_work_email
Professional mobile Work email or B2B profile URL find_mobile_number

Commands match those four: search, find-work-email, validate-email, find-mobile. Agent: leadmagic-enrichment.

Demo prompts

Search companies matching my ICP; 15 rows.
Find the work email for Alex Example at example.com.
Validate this work email: person@example.com
Look up a professional mobile number for this work email. I am authorized to contact them.
Search open backend roles at stripe.com; 5 rows.

Skills

Front door (Agent Decides, or invoke with /name):

Request Skill
People / company / jobs search market-search
Find a work email find-work-email
Validate an existing work email validate-work-email
Professional mobile find-mobile

Supporting (not pushed in marketplace copy): account-intelligence, prospect-list-qc.

Authoring: Cursor Agent Skills. Plugin model: https://cursor.com/docs/plugins. Smoke tests: docs/cursor-smoke-tests.md.

Docs

REST (https://api.leadmagic.io, X-API-Key) is for your own integrations — never commit keys here. Prefer MCP in Cursor.

Security

Tool calls send emails, names, domains, and B2B profile URLs you provide to LeadMagic. Never commit secrets. Privacy · Terms · SECURITY.md

Logo: assets/logo.svg (256×256 official icon). Raster copy: assets/logo.png.

Develop

Node.js 22. npm ci && npm run check (npm run validate, npm test, npm run verify:health, npm run verify:auth). Offline: npm run validate && npm test. Copy: SUBMISSION.md. Notes: CHANGELOG.md.

Troubleshooting

Issue What to try
Browser login Finish LeadMagic sign-in, then return to Cursor.
MCP 401 Reconnect OAuth in Customize. Do not paste an API key.
Search or mobile 402 Separate product entitlement vs wallet; check the app billing page.

MIT. See LICENSE.

About

LeadMagic Cursor plugin for B2B research, email finding, company intelligence, and data enrichment through hosted MCP with OAuth.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages