Skip to content

Commit 1098180

Browse files
jesseouejesseoue
committed
feat: package LeadMagic Cursor plugin for hosted MCP
Bundle the local Cursor plugin assets, validation checks, and install tooling so the hosted MCP configuration can be shipped and tested consistently. Made-with: Cursor
0 parents  commit 1098180

18 files changed

Lines changed: 732 additions & 0 deletions

File tree

‎.cursor-plugin/plugin.json‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
{
2+
"name": "leadmagic",
3+
"displayName": "LeadMagic",
4+
"version": "0.1.0",
5+
"description": "Official LeadMagic plugin for Cursor with hosted MCP-powered B2B enrichment, contact discovery, company intelligence, and GTM signal research.",
6+
"author": {
7+
"name": "LeadMagic",
8+
},
9+
"homepage": "https://leadmagic.io",
10+
"repository": "https://github.com/LeadMagic/leadmagic-cursor-plugin",
11+
"license": "MIT",
12+
"logo": "assets/logo.svg",
13+
"primaryColor": "#0EA5E9",
14+
"keywords": [
15+
"leadmagic",
16+
"cursor",
17+
"mcp",
18+
"b2b",
19+
"data-enrichment",
20+
"email-validation",
21+
"email-finder",
22+
"company-intelligence",
23+
"prospecting",
24+
"gtm"
25+
],
26+
"category": "developer-tools",
27+
"tags": [
28+
"sales",
29+
"prospecting",
30+
"enrichment",
31+
"mcp",
32+
"api"
33+
],
34+
"skills": "./skills/",
35+
"mcpServers": "./mcp.json"
36+
}

‎.github/pull_request_template.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Pull Request
2+
3+
## Summary
4+
5+
<!-- What changed and why? -->
6+
7+
## Type Of Change
8+
9+
- [ ] Documentation
10+
- [ ] Skills or rules
11+
- [ ] MCP config or metadata
12+
- [ ] Validation or GitHub automation
13+
- [ ] Other maintenance
14+
15+
## Validation
16+
17+
- [ ] Ran `npm run validate`
18+
- [ ] Checked that copy matches the current hosted MCP surface
19+
- [ ] Verified no secrets or hardcoded API keys were added
20+
21+
## Alignment Checklist
22+
23+
- [ ] `mcp.json` still points to `https://mcp.leadmagic.io/mcp`
24+
- [ ] Auth still uses `x-leadmagic-key`
25+
- [ ] Repo copy does not imply MCP support for tools outside the current MCP surface
26+
- [ ] README and submission copy stay consistent
27+
28+
## Notes For Reviewers
29+
30+
<!-- Anything reviewers should pay extra attention to? -->

‎.github/workflows/validate-plugin.yml‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
name: Validate Cursor Plugin
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
branches: [main]
8+
paths:
9+
- ".cursor-plugin/**"
10+
- ".github/**"
11+
- "assets/**"
12+
- "mcp.json"
13+
- "package.json"
14+
- "README.md"
15+
- "SUBMISSION.md"
16+
- "rules/**"
17+
- "scripts/**"
18+
- "skills/**"
19+
20+
jobs:
21+
validate:
22+
name: Validate package structure
23+
runs-on: ubuntu-latest
24+
25+
steps:
26+
- name: Checkout repository
27+
uses: actions/checkout@v4
28+
29+
- name: Setup Node.js
30+
uses: actions/setup-node@v4
31+
with:
32+
node-version: "20"
33+
34+
- name: Validate plugin package
35+
run: npm run validate
36+
37+
- name: Check hosted MCP endpoint
38+
run: |
39+
node -e "const fs=require('node:fs');const data=JSON.parse(fs.readFileSync('mcp.json','utf8'));const server=data.mcpServers?.leadmagic;if(!server||server.type!=='http'||server.url!=='https://mcp.leadmagic.io/mcp'){throw new Error('mcp.json must point to the hosted LeadMagic MCP endpoint with explicit HTTP transport')}if(!server.headers||server.headers['x-leadmagic-key']!=='${LEADMAGIC_API_KEY}'){throw new Error('mcp.json must use LEADMAGIC_API_KEY interpolation')}"
40+
41+
- name: Check README references
42+
run: |
43+
node -e "const fs=require('node:fs');const text=fs.readFileSync('README.md','utf8');for(const value of ['https://mcp.leadmagic.io/mcp','leadmagic://docs','LeadMagic MCP Tools']){if(!text.includes(value)){throw new Error('README.md is missing required reference: '+value)}}"

‎.gitignore‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
node_modules/
2+
.DS_Store

‎CHANGELOG.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Changelog
2+
3+
All notable changes to the LeadMagic Cursor plugin will be documented in this file.
4+
5+
## [Unreleased]
6+
7+
### Added
8+
- Initial public Cursor plugin package structure
9+
- Hosted MCP configuration for `https://mcp.leadmagic.io/mcp`
10+
- Skills, rules, validation script, and marketplace submission copy
11+
12+
### Changed
13+
- Synced repository copy to the current LeadMagic MCP surface: 16 tools, 1 docs resource, and 2 built-in prompts
14+
- Removed wording that implied MCP support for ad-search endpoints that are part of the REST API but not the current MCP tool surface
15+
- Tightened skills and default guidance around company research, job-change checks, hiring signals, and credit-aware workflows
16+
- Added GitHub pull request and validation scaffolding so the plugin repo matches the OpenAPI repo's baseline maintenance hygiene

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 LeadMagic
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
# LeadMagic Cursor Plugin
2+
3+
Official LeadMagic plugin for Cursor. It connects Cursor to LeadMagic's hosted MCP server so agents can run credit-aware B2B enrichment, contact discovery, company research, technographics, competitor analysis, job-change checks, and hiring-signal workflows inside Cursor.
4+
5+
## What this plugin adds
6+
7+
- Hosted LeadMagic MCP connectivity for Cursor
8+
- The current LeadMagic MCP surface:
9+
- 16 tools across credits, people, company research, and jobs
10+
- 1 shared docs resource: `leadmagic://docs`
11+
- 2 built-in prompts: `enrich_lead` and `validate_emails`
12+
- Four focused Cursor skills:
13+
- contact enrichment
14+
- account intelligence
15+
- prospect list QA
16+
- signal research
17+
- A default rule that nudges Cursor to use LeadMagic efficiently and avoid wasteful repeat lookups
18+
19+
## How it works
20+
21+
The plugin points Cursor at LeadMagic's hosted MCP endpoint:
22+
23+
- MCP endpoint: `https://mcp.leadmagic.io/mcp`
24+
- MCP transport: `http`
25+
- Auth header: `x-leadmagic-key`
26+
27+
Users provide their API key through the `LEADMAGIC_API_KEY` environment variable, and the plugin passes it through to the hosted MCP server. This mirrors the current hosted MCP setup docs for Cursor.
28+
29+
## What the MCP supports today
30+
31+
The current hosted MCP surface is strongest for:
32+
33+
- checking credit balance with `check_credits`
34+
- validating and finding work emails
35+
- enriching people from professional social profile URLs or email addresses
36+
- finding personal emails and direct mobile numbers
37+
- researching companies with company search, funding, competitors, and technographics
38+
- detecting job changes and finding live hiring signals through jobs search
39+
40+
The broader REST API and OpenAPI snapshot include additional surfaces, but this plugin should describe the MCP surface accurately rather than implying every API endpoint is exposed as an MCP tool.
41+
42+
## Repository layout
43+
44+
```text
45+
.cursor-plugin/plugin.json
46+
.github/pull_request_template.md
47+
.github/workflows/validate-plugin.yml
48+
assets/logo.svg
49+
mcp.json
50+
rules/leadmagic-usage.mdc
51+
skills/*/SKILL.md
52+
scripts/validate-plugin.mjs
53+
README.md
54+
SUBMISSION.md
55+
```
56+
57+
## Setup
58+
59+
1. Install the plugin in Cursor from GitHub or after marketplace approval.
60+
2. Set your API key in your shell or environment:
61+
62+
```bash
63+
export LEADMAGIC_API_KEY="your_api_key_here"
64+
```
65+
66+
3. Restart Cursor or reload the plugin if needed.
67+
4. Verify the connection by asking Cursor: `"Check my LeadMagic credit balance."`
68+
69+
## Local Development
70+
71+
To load this repository as a local Cursor plugin during development:
72+
73+
```bash
74+
npm run install:local
75+
```
76+
77+
That creates a symlink at `~/.cursor/plugins/local/leadmagic` that points to this repository. Then reload Cursor with `Developer: Reload Window`.
78+
79+
On macOS, if Cursor was launched from the dock or Finder, it may not inherit your shell environment. If `LEADMAGIC_API_KEY` is set in your terminal but LeadMagic still fails inside Cursor, launch Cursor from the same shell session or reload it after exporting the variable in an environment Cursor can see.
80+
81+
If you prefer to configure LeadMagic directly in Cursor instead of through the plugin package, see the hosted setup guide:
82+
83+
- [LeadMagic MCP Setup](https://leadmagic.io/docs/mcp/setup)
84+
- [LeadMagic MCP Tools](https://leadmagic.io/docs/mcp/tools)
85+
- [LeadMagic MCP Troubleshooting](https://leadmagic.io/docs/mcp/troubleshooting)
86+
87+
## Companion resources
88+
89+
- OpenAPI snapshot and schema docs: [LeadMagic OpenAPI](https://github.com/LeadMagic/leadmagic-openapi)
90+
- Product docs index: [leadmagic.io/docs/llms.txt](https://leadmagic.io/docs/llms.txt)
91+
- Website: [leadmagic.io](https://leadmagic.io)
92+
93+
## Example prompts
94+
95+
- "Check my LeadMagic credit balance."
96+
- "Validate these prospect emails and tell me which are safe to use."
97+
- "Find the best work email for Jane Doe at Snowflake."
98+
- "Enrich this b2b profile and pull any work email or mobile available."
99+
- "Has this prospect changed jobs recently?"
100+
- "Research Ramp as an account and tell me the best buying signals."
101+
- "What tech stack does Ramp use and who are its competitors?"
102+
- "Find engineering hiring signals for OpenAI and summarize the GTM angle."
103+
104+
## Validation
105+
106+
```bash
107+
npm run validate
108+
```
109+
110+
## Submission
111+
112+
Use `SUBMISSION.md` for ready-to-paste marketplace copy.

‎SUBMISSION.md‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Cursor marketplace submission copy
2+
3+
Use the following values in the Cursor marketplace publisher form.
4+
5+
## Form fields
6+
7+
**Organization name**
8+
LeadMagic
9+
10+
**Organization handle**
11+
leadmagic
12+
13+
**Unique namespace**
14+
@leadmagic
15+
16+
**Contact email**
17+
Use a shared public LeadMagic alias for marketplace contact. Avoid individual employee inboxes.
18+
19+
**Logotype URL**
20+
https://leadmagic.io/icon.svg
21+
22+
**Description**
23+
Official LeadMagic plugin for Cursor. Gives agents direct access to LeadMagic's hosted MCP surface for email validation, email finding, profile enrichment, company intelligence, technographics, competitor research, job-change detection, and hiring-signal workflows.
24+
25+
**GitHub repository**
26+
https://github.com/LeadMagic/leadmagic-cursor-plugin
27+
28+
**Website URL**
29+
https://leadmagic.io
30+
31+
## Suggested reviewer note
32+
33+
LeadMagic is an API-first B2B enrichment platform for AI agents and GTM engineers. This plugin packages our current hosted MCP integration into a Cursor-native repo with focused skills, safe default guidance, and a clean environment-variable setup for credit-aware enrichment workflows.
34+
35+
## Short marketplace blurb alternatives
36+
37+
### Option A
38+
Official LeadMagic plugin for Cursor. Enrich people and companies, validate emails, find contact paths, and surface GTM signals directly inside Cursor.
39+
40+
### Option B
41+
B2B enrichment for Cursor agents: email validation, email finding, profile enrichment, company intelligence, technographics, job-change detection, and buying-signal research through LeadMagic.
42+
43+
### Option C
44+
Connect Cursor to LeadMagic for agent-native prospecting and account research with verified contact data, company intelligence, and workflow-ready enrichment tools.

‎assets/logo.svg‎

Lines changed: 10 additions & 0 deletions
Loading

‎mcp.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"mcpServers": {
3+
"leadmagic": {
4+
"type": "http",
5+
"url": "https://mcp.leadmagic.io/mcp",
6+
"headers": {
7+
"x-leadmagic-key": "${LEADMAGIC_API_KEY}"
8+
}
9+
}
10+
}
11+
}

0 commit comments

Comments
 (0)