sales-leadmagic

What this skill does

# LeadMagic Platform Help

Help the user with LeadMagic platform questions — from email/mobile finding and company enrichment through ads intelligence, job tracking, API integration, and MCP server setup for AI agents.

## Step 1 — Gather context


If `references/learnings.md` exists, read it first for accumulated knowledge.

Ask the user:

1. **What area of LeadMagic do you need help with?**
   - A) Email Finder — finding verified work emails from name + company
   - B) Email Validation — verifying emails, catch-all detection, deliverability scoring
   - C) Mobile Finder — finding direct dial phone numbers
   - D) Profile Search — enriching contacts from LinkedIn/B2B profile URLs
   - E) Company Intelligence — company search, funding, technographics, competitors
   - F) Employee/Role Finder — discovering employees or specific roles at companies
   - G) Job Change Detector — tracking contacts changing jobs
   - H) Ads Intelligence — Google, Meta, B2B ad research
   - I) API Integration — REST API setup, authentication, endpoints
   - J) MCP Server — setting up LeadMagic tools in Claude, Cursor, Windsurf, VS Code
   - K) CLI — command-line usage
   - L) Credits & Billing — credit costs, plan optimization
   - M) Something else — describe it

2. **What's your role?**
   - A) Sales rep / AE / BDR
   - B) RevOps / GTM Ops / GTM Engineer
   - C) Developer / Engineer
   - D) Marketing / Growth
   - E) Founder / solo seller
   - F) Agency
   - G) Other

3. **What are you trying to accomplish?** (describe your specific goal or question)

**If the user's request already provides most of this context, skip directly to the relevant step.** Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.

## Step 2 — Route or answer directly

If the request maps to a specialized skill, route:
- Enrichment strategy / provider comparison → `/sales-enrich`
- Prospect list building strategy → `/sales-prospect-list`
- Intent signal strategy / prioritization → `/sales-intent`
- Competitive intelligence strategy → `/sales-compete`
- Email deliverability strategy → `/sales-deliverability`
- Tool integration architecture → `/sales-integration`

Otherwise, answer directly using the platform reference below.

## Step 3 — LeadMagic platform reference

### Core concepts

| Concept | What it is |
|---------|-----------|
| **Credit** | Currency for API calls. Different endpoints cost different amounts. You only pay for valid results — not_found results are free. |
| **API Key** | Authentication token passed as `X-API-Key` header. Get from Settings > API in your dashboard. |
| **MCP Server** | Model Context Protocol server that exposes all 19 LeadMagic tools to AI agents (Claude, Cursor, Windsurf, VS Code). |
| **CLI** | Command-line interface for running LeadMagic lookups from terminal. |

### Endpoints by category

#### People Data (10 endpoints)

| Endpoint | Path | Credits | What it does |
|----------|------|---------|-------------|
| **Email Finder** | `POST /v1/people/email-finder` | 1 | Name + domain → verified work email. 97% accuracy. |
| **Email Validation** | `POST /v1/people/email-validation` | 0.25 | Verify email deliverability. Returns `valid`, `invalid`, or `unknown`. Catch-all detection. |
| **Mobile Finder** | `POST /v1/people/mobile-finder` | 5 | Find direct dial mobile numbers for decision-makers. |
| **Profile Search** | `POST /v1/people/profile-search` | 1 | Enrich from LinkedIn/B2B profile URL — work history, education, skills. 300 req/min rate limit. |
| **Email to Profile** | `POST /v1/people/b2b-profile` | 10 | Work email → B2B profile URL and details. |
| **Profile to Email** | `POST /v1/people/b2b-profile-email` | 1-2 | B2B profile URL → work email. |
| **Personal Email Finder** | `POST /v1/people/personal-email-finder` | 1-2 | Find personal email addresses from B2B profiles. |
| **Role Finder** | `POST /v1/people/role-finder` | 1-2 | Find specific roles at a company (e.g., "VP Sales at Acme"). |
| **Employee Finder** | `POST /v1/people/employee-finder` | 0.05 | Discover employees at target companies. Low-cost bulk discovery. |
| **Job Change Detector** | `POST /v1/people/job-change` | 3 | Track when contacts change jobs. |

#### Company Data (4 endpoints)

| Endpoint | Path | Credits | What it does |
|----------|------|---------|-------------|
| **Company Search** | `POST /v1/companies/company-search` | 1-2 | Firmographics by domain, name, or LinkedIn URL — industry, size, revenue, location. |
| **Company Funding** | `POST /v1/companies/company-funding` | 4 | Funding rounds, investors, amounts, dates. |
| **Technographics** | via Company Search | incl. | Tech stack identification — what tools/technologies a company uses. |
| **Competitors Search** | via Company Search | incl. | Discover competitor companies in the same space. |

#### Jobs & Ads (4 endpoints)

| Endpoint | Path | Credits | What it does |
|----------|------|---------|-------------|
| **Jobs Finder** | `POST /v1/jobs/jobs-finder` | 1/result | Search job listings across industries. Filter by country, type, keywords. |
| **Google Ads Search** | `POST /v1/ads/google-ads-search` | 1/ad | Analyze competitor Google search ads — ad copy, keywords, landing pages. |
| **Meta Ads Search** | `POST /v1/ads/meta-ads-search` | 1/ad | Research Facebook/Instagram ads — creative, targeting, engagement. |
| **B2B Ads Search** | `POST /v1/ads/b2b-ads-search` | 1/ad | B2B advertising intelligence — display and social campaigns. |

#### Utility

| Endpoint | Path | Credits | What it does |
|----------|------|---------|-------------|
| **Get Credits** | `GET /v1/credits` | 0 | Check current credit balance. |
| **Job Countries** | `GET /v1/jobs/countries` | 0 | List available countries for job search. |
| **Job Types** | `GET /v1/jobs/job-types` | 0 | List available job type filters. |

### API quick reference

```bash
# Base URL
https://api.leadmagic.io

# Authentication — X-API-Key header
curl -X POST "https://api.leadmagic.io/v1/people/email-finder" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "company_name": "acme.com"}'

# Check credit balance
curl "https://api.leadmagic.io/v1/credits" \
  -H "X-API-Key: your_api_key"
```

- **Response format**: JSON, mix of snake_case and camelCase depending on endpoint
- **Response times**: <200ms average, <100ms for many endpoints
- **Uptime**: 99.9%
- **Failed lookups**: Return `null` — no credits charged

### MCP Server setup

LeadMagic provides an official MCP server with 19 tools for AI agents:

```bash
# Install
npx leadmagic-mcp

# Or add to Claude Code MCP config
# Settings > MCP Servers > Add:
# Name: leadmagic
# Command: npx leadmagic-mcp
# Env: LEADMAGIC_API_KEY=your_key
```

**Supported clients**: Claude Code, Cursor, Windsurf, VS Code, Continue.dev, ChatGPT

### Pricing & credits (as of April 2026 — verify current pricing)

| Plan | Price | Credits/mo | Per credit | Rollover |
|------|-------|-----------|-----------|----------|
| **Trial** | $0 | 100 | Free | No |
| **Basic** | $59.99/mo | 2,500 | ~$0.024 | No |
| **Essential** | $99.99/mo | 10,000 | ~$0.010 | Yes |
| **Growth** | $179.99/mo | 20,000 | ~$0.009 | Yes |
| **Advanced** | $259.99/mo | 30,000 | ~$0.008 | Yes |

- **Pay only for valid results** — not_found results cost 0 credits
- Credit rollover on Essential plan and above (up to plan limit)
- All plans include all 19 endpoints, API + CLI + MCP access, unlimited team members

### Integrations

**Data platforms**: Clay (native), Apollo, ZoomInfo, Databar
**Outbound tools**: Instantly, Smartlead
**CRM**: Salesforce
**Automation**: Zapier, Make, n8n
**AI agents**: Claude (MCP), Cursor (MCP), Windsurf (MCP), VS Code (MCP), ChatGPT
**CLI**: Direct command-line access

## Step 4 — Actionable guidance

When answering, always: