Skip to content

Commit 8034931

Browse files
committed
chore: align Cursor plugin with expanded MCP surface (v0.1.2)
Document ten hosted tools in README, rules, and skills. Update CHANGELOG and plugin metadata so marketplace installs match mcp.leadmagic.io capabilities. Made-with: Cursor
1 parent a687b8c commit 8034931

8 files changed

Lines changed: 25 additions & 15 deletions

File tree

.cursor-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
22
"name": "leadmagic",
33
"displayName": "LeadMagic",
4-
"version": "0.1.0",
5-
"description": "Official LeadMagic plugin for Cursor with hosted MCP-powered work email validation, email finding, account research, and credit-aware enrichment.",
4+
"version": "0.1.2",
5+
"description": "Official LeadMagic plugin for Cursor with hosted MCP: emails, mobile, LinkedIn-to-email, job changes, company research, competitors, technographics, and credits.",
66
"author": {
77
"name": "LeadMagic",
88
"email": "plugins@leadmagic.io"

CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@ All notable changes to the LeadMagic Cursor plugin will be documented in this fi
44

55
## [Unreleased]
66

7+
### Changed
8+
- README, rules, and skills now describe the expanded hosted MCP tool set (mobile, LinkedIn-to-email, job change, competitors, technographics, people-by-role).
9+
- Rules: avoid speculative deliverability or catch-all commentary; stick to tool output for validation.
10+
- Aligns with hosted MCP email-validation summaries that surface `email_status` correctly.
11+
712
### Added
813
- Initial public Cursor plugin package structure
914
- Hosted MCP configuration for `https://mcp.leadmagic.io/mcp`

README.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The package includes:
1010

1111
- Hosted LeadMagic MCP connectivity for Cursor
1212
- The current LeadMagic MCP surface:
13-
- 4 tools for credit checks, work email validation, work email finding, and account research
13+
- 10 tools: credits, work email validate/find, mobile, LinkedIn-to-email, job-change detection, account research, competitors, technographics, people-by-role
1414
- 1 shared docs resource: `leadmagic://docs`
1515
- 2 built-in prompts: `account_research` and `contact_lookup`
1616
- Four focused Cursor skills aligned to the current hosted MCP surface:
@@ -40,14 +40,13 @@ Users provide their API key through the `LEADMAGIC_API_KEY` environment variable
4040

4141
## What The MCP Supports Today
4242

43-
The current hosted MCP surface is strongest for:
43+
The hosted MCP surface supports:
4444

45-
- checking credit balance with `check_credit_balance`
46-
- validating known work emails with `validate_work_email`
47-
- finding likely work emails with `find_work_email`
48-
- researching companies with `research_account`
45+
- `check_credit_balance`, `validate_work_email`, `find_work_email`
46+
- `find_mobile_number`, `linkedin_profile_to_work_email`, `detect_job_change`
47+
- `research_account`, `list_company_competitors`, `get_company_technographics`, `find_people_by_role`
4948

50-
The broader REST API and OpenAPI snapshot include additional surfaces, but this plugin is documented against the current hosted MCP surface only. That keeps the marketplace listing accurate and avoids implying support for endpoints that are not currently exposed through MCP.
49+
The broader REST API includes more endpoints (jobs, ads, analytics, etc.); this plugin tracks the hosted MCP tool list above. See `leadmagic://docs` in Cursor for the live tool reference.
5150

5251
## Quick Start
5352

rules/leadmagic-usage.mdc

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ alwaysApply: true
66

77
When this plugin is available:
88

9-
1. Prefer LeadMagic tools for work email validation, work email discovery, and account research before suggesting manual research.
9+
1. Prefer LeadMagic tools for work email validation, discovery, mobile lookup, LinkedIn-to-email, job-change checks, company research, competitors, technographics, and role-based people search before suggesting manual research.
1010
2. Minimize unnecessary credit spend:
1111
- For bulk or credit-sensitive work, check balance first with `check_credit_balance`.
1212
- If the user already has an email, validate it with `validate_work_email` before trying to find another one.
@@ -22,5 +22,6 @@ When this plugin is available:
2222
- the key results,
2323
- any important null, not-found, or unknown outcomes,
2424
- and any obvious next best step.
25-
6. If parameter requirements, supported inputs, or pricing are unclear, consult the shared MCP docs resource `leadmagic://docs` before guessing.
26-
7. If the API key is missing or authentication fails, tell the user they need to set `LEADMAGIC_API_KEY`.
25+
6. For email validation, summarize only what appears in the tool output (including the stated result line). Do not speculate about “missing” deliverability details, catch-all behavior, or fields the response does not include.
26+
7. If parameter requirements, supported inputs, or pricing are unclear, consult the shared MCP docs resource `leadmagic://docs` before guessing.
27+
8. If the API key is missing or authentication fails, tell the user they need to set `LEADMAGIC_API_KEY`.

skills/account-intelligence/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Use when the user wants company research, ICP fit, or a target account brief fro
1212
- company domain preferred,
1313
- otherwise company name.
1414
2. Run `research_account` to establish the canonical account record.
15-
3. Keep the work scoped to the current MCP surface. If the user asks for technographics, competitors, ad intelligence, or other API-only surfaces, be explicit that those may exist in the broader API/docs surface but are not part of the current hosted MCP tool set.
15+
3. When the user asks for a dedicated competitor list or tech stack, follow with `list_company_competitors` or `get_company_technographics`. Ad intelligence and other marketing APIs remain outside the hosted MCP tool set—say so if asked.
1616
4. Keep the summary operator-friendly:
1717
- what the company is,
1818
- why it matters,

skills/contact-enrichment/SKILL.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ Use when the user needs a validated work email or wants LeadMagic to find the li
1010
## Workflow
1111
1. Start from the strongest identifier the user already has.
1212
- Existing work email: validate it first with `validate_work_email`.
13+
- B2B profile URL (e.g. LinkedIn): use `linkedin_profile_to_work_email`; then validate if needed.
14+
- Work email or profile URL + wants phone: `find_mobile_number`.
1315
- Full name + company or domain: use `find_work_email`.
1416
2. Prefer the cheapest path that can answer the question.
1517
3. If the user already has an email, do not jump straight to finding another one.
@@ -21,6 +23,7 @@ Use when the user needs a validated work email or wants LeadMagic to find the li
2123
- Existing email fails validation or no email exists -> `find_work_email`
2224
- Name + company + wants work email -> `find_work_email`
2325
- Person + company + wants confidence before spending more credits -> `check_credit_balance` -> `find_work_email`
26+
- Recent role change signal -> `detect_job_change` (email, profile URL, or name + company)
2427

2528
## Output
2629
Return:

skills/prospect-list-qc/SKILL.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,10 @@ Use when the user has many prospects and wants the highest-confidence sequence f
1212
2. Prioritize validation before expensive enrichment whenever emails already exist.
1313
3. Separate records into buckets:
1414
- already have work email -> `validate_work_email`,
15+
- have B2B profile URL -> `linkedin_profile_to_work_email` then validate if needed,
16+
- have email or profile + need phone -> `find_mobile_number`,
1517
- have name + company only -> `find_work_email`,
16-
- company-only records -> `research_account`.
18+
- company-only records -> `research_account`; add `list_company_competitors` or `get_company_technographics` when the list needs those angles.
1719
4. Remove duplicates before enrichment.
1820
5. Preserve null and unknown outcomes instead of forcing guesses.
1921
6. Recommend the cheapest sensible order of operations before bulk runs.

skills/signal-research/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Use when the user wants evidence that an account is relevant now and needs a con
1212
2. Use `research_account` to collect the strongest current account context LeadMagic can provide through MCP.
1313
3. Synthesize the results into GTM implications, not just raw data.
1414
4. Highlight uncertainty when signals are partial or the hosted MCP surface does not expose the exact field the user wants.
15-
5. Stay within the current MCP surface. If the user asks for jobs, competitors, funding, technographics, or ad intelligence, call out that those may belong to the wider API/docs surface rather than the current hosted MCP tool set.
15+
5. Stay within the hosted MCP tools. Competitors and technographics are available via `list_company_competitors` and `get_company_technographics`. Job postings and ad intelligence are not in MCP—point to the REST docs if the user needs those.
1616

1717
## Output
1818
Return:

0 commit comments

Comments
 (0)