# Derrick MCP — B2B enrichment for every AI agent

> The Derrick MCP server gives Claude, Cursor, Windsurf, and any MCP-compliant agent 12 real-time B2B enrichment tools: find emails, phones, LinkedIn data, company info, tech stacks, SIRET/SIREN. One paste, no scaffolding.

*Canonical: https://derrick-app.com/mcp*

---

## Install

The MCP installs **without an API key**. The server prompts for one on the first tool call. Optionally pre-seed the key via the `DERRICK_API_KEY` env var or `--env` flag.

### Claude Code (CLI)

```
claude mcp add derrick -- npx -y derrick-mcp
```

To skip the first-call prompt:

```
claude mcp add derrick --env DERRICK_API_KEY=$YOUR_KEY -- npx -y derrick-mcp
```

### Claude Desktop (JSON config)

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "derrick": {
      "command": "npx",
      "args": ["-y", "derrick-mcp"]
    }
  }
}
```

### Claude.ai web (Customize)

Settings → Customize → Connectors → Add MCP server:

- URL: `https://app1.derrick-app.com/mcp`
- Auth: server prompts for key on first call, or pre-seed via Authorization: Bearer <your-key>

### Cursor / Windsurf

Same JSON snippet as Claude Desktop, but stored at `~/.cursor/mcp.json` (Cursor) or `~/.codeium/windsurf/mcp_config.json` (Windsurf).

---

## 12 tools exposed

| Tool | Description | Credits |
|---|---|---|
| `derrick_find_email` | Email from LinkedIn URL or name + company | 5 |
| `derrick_find_phone` | Mobile/office phone from LinkedIn URL or contact name | 150 |
| `derrick_enrich_profile` | 30+ data points on a LinkedIn profile | 1 |
| `derrick_enrich_companies` | Company data: headcount, industry, funding, HQ, social | 1 |
| `derrick_data_gouv` | French SIRET/SIREN/NAF code from data.gouv.fr | 1 |
| `derrick_find_tech` | Tech stack a company uses (CRM, analytics, hosting) | 1 |
| `derrick_verify_email` | Real-time SMTP verification: valid/risky/catch-all | 1 |
| `derrick_search_linkedin_profile` | Search profiles by job title + company + location | 1 |
| `derrick_search_companies` | Search companies by industry, size, geo, tech stack | 1 |
| `derrick_search_leads_in_companies` | Find leads matching a job-title pattern in a target company | 2 |
| `derrick_website_contact_social` | Scrape a website's footer/contact page | 2 |
| `derrick_serp_first_result` | Google's #1 result for any query | 1 |

Credit cost is **per endpoint**, not flat.

---

## Skill recipes (paste these prompts into Claude)

### 1. Build a target-account list

> Find 50 Series-A SaaS companies in France with 50-200 employees that use HubSpot. For each, return name, domain, HQ city, and the LinkedIn URL of the Head of Sales.

Uses: `derrick_search_companies`, `derrick_enrich_companies`, `derrick_search_leads_in_companies`.

### 2. Enrich a CSV of leads

> I'll paste a CSV of 30 LinkedIn URLs. For each, give me the person's professional email, phone, current company, job title, and country. Output as a Markdown table.

Uses: `derrick_enrich_profile`, `derrick_find_email`, `derrick_find_phone`.

### 3. Verify a batch of emails

> I'll paste 100 emails. Verify each (valid / risky / invalid). Group by status. For 'risky', explain the reason in 1 line each.

Uses: `derrick_verify_email`.

### 4. Track competitor tech stack changes

> List the technologies used by competitor.com. Compare with my notes from 3 months ago (I'll paste them) and highlight added/removed tools.

Uses: `derrick_find_tech`.

---

## Pricing

The MCP installs free, but calling tools requires an API key — API/MCP access unlocks from the **Standard plan upward**.

| Plan | €/month | Credits/month | €/credit | API/MCP |
|---|---|---|---|---|
| Free | 0 | 100 | — | No |
| Mini | 9 | 4,000 | 0.00225 | No |
| Standard | 20 | 10,000 | 0.0020 | Yes |
| Plus | 47.5 | 25,000 | 0.0019 | Yes |
| Pro | 175 | 100,000 | 0.00175 | Yes |

Unused credits roll over on all paid plans.

---

## Rate limits

60 requests / minute on all paid plans. Exponential backoff with jitter on 429. The derrick-mcp npm package handles retries automatically.

---

## FAQ

### Can I install the MCP without an API key?

Yes. The server prompts for one on the first tool call. Pre-seeding via env var skips the prompt.

### Do I need a paid Derrick plan?

The MCP installs free. Calling tools requires a key, which is unlocked from the Standard plan (€20/mo).

### How much does an MCP call cost?

Credit cost is per endpoint — see the tools table above. €/credit varies by plan.

### Is it real-time?

Yes. Every call hits the same backend as the Sheets add-on, cross-referencing 15+ data providers per request.

### Can I use it with Cursor, Windsurf, or other MCP clients?

Yes. The Derrick MCP follows the official Model Context Protocol spec, so any compliant client connects.

### Is it GDPR-compliant?

Yes. EU data residency, no persistent storage, only public B2B data. DPA available at /data-processing-agreement.

### What's the rate limit?

60 requests / minute on all paid plans. Backoff is exponential with jitter on 429.

### Where do I get the API key?

Open the Derrick Google Sheets add-on → Settings → API access → Copy your key. Requires the Standard plan or above.

---

## Discovery endpoints for AI agents

- `/.well-known/mcp/server-card.json` — rich MCP server card with tools list, install snippets, pricing
- `/.well-known/llms-full.txt` — extended description for LLMs
- `/.well-known/api-catalog` — RFC 9727 linkset to the REST API
- `/.well-known/ai-plugin.json` — legacy ChatGPT plugin manifest
- `/llms.txt` — short overview

## Links

- [npm package](https://www.npmjs.com/package/derrick-mcp)
- [REST API docs](https://app1.derrick-app.com/api/v1/docs/)
- [Homepage](https://derrick-app.com/)
- [Install Derrick free](https://workspace.google.com/marketplace/app/linkedin_email_phone_finder_ia_%E2%80%94_derrick/3746789989?flow_type=2)