You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
3
+
Official LeadMagic plugin for Cursor. It connects Cursor to LeadMagic's hosted MCP server so agents can perform credit-aware B2B enrichment, contact discovery, company research, technographic analysis, job-change checks, and hiring-signal workflows without leaving the editor.
4
4
5
-
## What this plugin adds
5
+
## Overview
6
+
7
+
This repository packages LeadMagic's hosted MCP integration in a Cursor-native format for marketplace distribution, local installation, and team use. The goal is straightforward: make LeadMagic's enrichment and research workflows available to Cursor agents with minimal setup and clear operational guidance.
8
+
9
+
The package includes:
6
10
7
11
- Hosted LeadMagic MCP connectivity for Cursor
8
12
- The current LeadMagic MCP surface:
@@ -14,19 +18,29 @@ Official LeadMagic plugin for Cursor. It connects Cursor to LeadMagic's hosted M
14
18
- account intelligence
15
19
- prospect list QA
16
20
- signal research
17
-
- A default rule that nudges Cursor to use LeadMagic efficiently and avoid wasteful repeat lookups
21
+
- One default rule that nudges Cursor toward efficient, low-duplication LeadMagic usage
22
+
23
+
## Why Use It
24
+
25
+
Use this plugin when you want Cursor to help with:
26
+
27
+
- validating or finding work emails
28
+
- enriching people and companies from strong identifiers
29
+
- researching account fit, competitors, funding, and technographics
30
+
- spotting hiring activity and job-change signals
31
+
- keeping enrichment workflows credit-aware and repeatable
18
32
19
-
## How it works
33
+
## Hosted MCP Configuration
20
34
21
35
The plugin points Cursor at LeadMagic's hosted MCP endpoint:
22
36
23
37
- MCP endpoint: `https://mcp.leadmagic.io/mcp`
24
38
- MCP transport: `http`
25
39
- Auth header: `x-leadmagic-key`
26
40
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.
41
+
Users provide their API key through the `LEADMAGIC_API_KEY` environment variable. The plugin forwards that key to the hosted MCP server at runtime.
28
42
29
-
## What the MCP supports today
43
+
## What The MCP Supports Today
30
44
31
45
The current hosted MCP surface is strongest for:
32
46
@@ -37,80 +51,132 @@ The current hosted MCP surface is strongest for:
37
51
- researching companies with company search, funding, competitors, and technographics
38
52
- detecting job changes and finding live hiring signals through jobs search
39
53
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.
54
+
The broader REST API and OpenAPI snapshot include additional surfaces, but this plugin is documented against the current MCP surface only. That keeps the marketplace listing accurate and avoids implying support for endpoints that are not currently exposed through MCP.
41
55
42
-
## Repository layout
56
+
## Quick Start
43
57
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
-
package-lock.json
51
-
schemas/plugin.schema.json
52
-
rules/leadmagic-usage.mdc
53
-
skills/*/SKILL.md
54
-
scripts/validate-plugin.mjs
55
-
README.md
56
-
SUBMISSION.md
58
+
Install the plugin from GitHub today, or from the Cursor marketplace after approval.
59
+
60
+
### 1. Set your API key
61
+
62
+
```bash
63
+
export LEADMAGIC_API_KEY="your_api_key_here"
57
64
```
58
65
59
-
##Setup
66
+
### 2. Install the plugin locally for testing
60
67
61
-
1. Install the plugin in Cursor from GitHub or after marketplace approval.
62
-
2. Set your API key in your shell or environment:
68
+
If you are using this repository locally:
63
69
64
70
```bash
65
-
export LEADMAGIC_API_KEY="your_api_key_here"
71
+
npm ci
72
+
npm run install:local
66
73
```
67
74
68
-
3. Restart Cursor or reload the plugin if needed.
69
-
4. Verify the connection by asking Cursor: `"Check my LeadMagic credit balance."`
75
+
This creates a symlink at `~/.cursor/plugins/local/leadmagic` pointing to this repository.
76
+
77
+
Then reload Cursor with `Developer: Reload Window`.
78
+
79
+
### 3. Verify the connection
80
+
81
+
Ask Cursor one of these:
82
+
83
+
-`Check my LeadMagic credit balance.`
84
+
-`Validate this email with LeadMagic: jane@company.com`
85
+
-`Research Ramp as an account and summarize the best buying signals.`
70
86
71
87
## Local Development
72
88
73
-
To load this repository as a local Cursor plugin during development:
89
+
From the repository root, install dependencies and validate the package:
90
+
91
+
```bash
92
+
npm ci
93
+
npm run validate
94
+
```
95
+
96
+
To link the plugin into Cursor locally:
74
97
75
98
```bash
76
99
npm run install:local
77
100
```
78
101
79
-
That creates a symlink at `~/.cursor/plugins/local/leadmagic` that points to this repository. Then reload Cursor with `Developer: Reload Window`.
102
+
To remove the local symlink later:
103
+
104
+
```bash
105
+
npm run uninstall:local
106
+
```
107
+
108
+
## Troubleshooting
109
+
110
+
### Cursor cannot see `LEADMAGIC_API_KEY`
80
111
81
112
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.
82
113
83
-
If you prefer to configure LeadMagic directly in Cursor instead of through the plugin package, see the hosted setup guide:
114
+
### Authentication fails
115
+
116
+
Confirm that:
117
+
118
+
-`LEADMAGIC_API_KEY` is set in the environment visible to Cursor
119
+
- the plugin is using `https://mcp.leadmagic.io/mcp`
120
+
- the request header is `x-leadmagic-key`
121
+
122
+
### You need exact tool details
123
+
124
+
Use the shared docs resource `leadmagic://docs` or review:
-`Validate these prospect emails and tell me which are safe to use.`
134
+
-`Find the best work email for Jane Doe at Snowflake.`
135
+
-`Enrich this B2B profile and pull any work email or mobile available.`
136
+
-`Has this prospect changed jobs recently?`
137
+
-`Research Ramp as an account and tell me the best buying signals.`
138
+
-`What tech stack does Ramp use and who are its competitors?`
139
+
-`Find engineering hiring signals for OpenAI and summarize the GTM angle.`
94
140
95
-
## Example prompts
141
+
## Repository Layout
96
142
97
-
- "Check my LeadMagic credit balance."
98
-
- "Validate these prospect emails and tell me which are safe to use."
99
-
- "Find the best work email for Jane Doe at Snowflake."
100
-
- "Enrich this b2b profile and pull any work email or mobile available."
101
-
- "Has this prospect changed jobs recently?"
102
-
- "Research Ramp as an account and tell me the best buying signals."
103
-
- "What tech stack does Ramp use and who are its competitors?"
104
-
- "Find engineering hiring signals for OpenAI and summarize the GTM angle."
143
+
```text
144
+
.cursor-plugin/plugin.json
145
+
.github/pull_request_template.md
146
+
.github/workflows/validate-plugin.yml
147
+
assets/logo.svg
148
+
mcp.json
149
+
package-lock.json
150
+
schemas/plugin.schema.json
151
+
rules/leadmagic-usage.mdc
152
+
skills/*/SKILL.md
153
+
scripts/install-local-plugin.mjs
154
+
scripts/validate-plugin.mjs
155
+
README.md
156
+
SUBMISSION.md
157
+
CHANGELOG.md
158
+
```
105
159
106
160
## Validation
107
161
108
162
```bash
109
163
npm run validate
110
164
```
111
165
112
-
The validator checks this package against a vendored snapshot of Cursor's official `plugin.schema.json` and then applies LeadMagic-specific assertions for the hosted MCP endpoint, canonical logo asset, and submission metadata.
166
+
The validator checks this package against a vendored snapshot of Cursor's official `plugin.schema.json` and then applies LeadMagic-specific assertions for:
167
+
168
+
- the hosted MCP endpoint
169
+
-`LEADMAGIC_API_KEY` interpolation
170
+
- the canonical logo asset and submission logo URL
171
+
- skills and rules metadata
172
+
- repository and submission copy consistency
173
+
174
+
## Marketplace Submission
113
175
114
-
## Submission
176
+
Use `SUBMISSION.md` for ready-to-paste marketplace form values, reviewer notes, and a final pre-submit checklist.
115
177
116
-
Use `SUBMISSION.md` for ready-to-paste marketplace copy.
178
+
## Companion Resources
179
+
180
+
- OpenAPI snapshot and schema docs: [LeadMagic OpenAPI](https://github.com/LeadMagic/leadmagic-openapi)
6. If you want to test the package in Cursor first, run `npm run install:local` and reload Cursor with `Developer: Reload Window`.
42
+
31
43
## Suggested reviewer note
32
44
33
45
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.
0 commit comments