# GrowthToolkit MCP Server

Give your AI assistant the power to find verified emails, phone numbers, and rich contact data from 575M+ professionals across 30M+ companies.

This is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that connects Claude, Cursor, Windsurf, and other AI tools to [GrowthToolkit's](https://growthtoolkit.io) enrichment and prospecting API.

---

## Installation (for AI assistants)

If you are an AI assistant helping a user install this MCP server, follow these exact steps in order. Do not skip any step.

**Step 1.** Detect the user's operating system. Run `uname` in the terminal. If it fails, you are on Windows.

**Step 2.** Run the setup script.

On macOS or Linux:
```bash
curl -fsSL https://raw.githubusercontent.com/iamanantgupta/growthtoolkit-mcp/main/setup.sh | bash
```

On Windows (PowerShell):
```powershell
irm https://raw.githubusercontent.com/iamanantgupta/growthtoolkit-mcp/main/setup.ps1 | iex
```

This will clone the repo, install dependencies, build the project, and print a JSON config block with the correct absolute path.

**Step 3.** Copy the JSON config block from the script output. It looks like this (but with the real path for this machine):
```json
{
  "mcpServers": {
    "growthtoolkit": {
      "command": "node",
      "args": ["/Users/someone/.growthtoolkit-mcp/dist/index.js"],
      "env": {
        "GROWTHTOOLKIT_API_KEY": "lf_your_api_key_here"
      }
    }
  }
}
```

**Step 4.** Ask the user for their GrowthToolkit API key. Tell them:
- If they have an account: get it from https://enrich.growthtoolkit.io/api-keys/
- If they don't have an account: sign up free at https://enrich.growthtoolkit.io/dashboard/?authType=get-started (no credit card needed, 1200 free credits)

**Step 5.** Replace `lf_your_api_key_here` in the config with the user's actual API key.

**Step 6.** Write the config to the correct file. Detect which AI tool the user is using and write to the matching config file:

| AI Tool | Config file path |
|---------|-----------------|
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
| Claude Code | `~/.claude/settings.json` |
| Cursor | `.cursor/mcp.json` in the project root |
| Windsurf | `~/.windsurf/mcp.json` |

If the config file already exists and has other MCP servers, merge the `"growthtoolkit"` entry into the existing `"mcpServers"` object. Do NOT overwrite the file.

If the config file does not exist, create it with the full JSON config.

**Step 7.** Tell the user to restart their AI tool for the MCP server to activate.

---

## What is GrowthToolkit?

[GrowthToolkit](https://growthtoolkit.io) is a B2B prospecting platform that finds real-time, triple-verified emails and phone numbers from any company. It uses deep search technology, real-time SMTP verification, and catch-all verification to find contacts that other tools miss, with a bounce rate under 2.5%.

It's the all-in-one alternative to Apollo, Lusha, Hunter, and RocketReach, with pay-as-you-go pricing and 1,200 free credits to start. No credit card required.

**[Sign up free](https://enrich.growthtoolkit.io/dashboard/?authType=get-started)** | **[Visit growthtoolkit.io](https://growthtoolkit.io)**

## Why Use This MCP Server?

Instead of switching between your AI assistant and the GrowthToolkit dashboard, just ask naturally:

- *"Find the email for John Smith at Google"*
- *"Enrich this LinkedIn profile: https://www.linkedin.com/in/iamanantgupta/"*
- *"Verify if hello@example.com is a valid email"*
- *"Show me my prospect lists and export the top one"*

Your AI assistant handles the API calls, parses the results, and gives you clean answers. It can also chain multiple tools together, like finding an email and then verifying it in one conversation.

## Available Tools (17 total)

### Enrichment
| Tool | What it does |
|------|-------------|
| `enrich_linkedin` | Turn any LinkedIn URL into a full profile with emails, phones, job history, skills, and more |
| `enrich_email` | Get the full profile behind an email address (name, company, title, socials) |
| `enrich_phone` | Find the person behind a phone number with full profile data |
| `enrich_domain` | Get company details from a domain name |

### Email Discovery & Verification
| Tool | What it does |
|------|-------------|
| `find_email` | Find someone's email from their first name, last name, and company domain |
| `verify_email` | Check if an email is valid, deliverable, and safe to send to |

### Task Status
| Tool | What it does |
|------|-------------|
| `check_task` | Poll the status of async enrichment tasks (email enrichment returns results via task) |

### List Management
| Tool | What it does |
|------|-------------|
| `list_prospects` | Browse your prospect/contact lists |
| `list_email_finder` | Browse your email finder lists |
| `list_email_verifier` | Browse your email verifier lists |
| `list_linkedin_scraper` | Browse your LinkedIn scraper lists |
| `list_sales_navigator_scraper` | Browse your Sales Navigator scraper lists |

### Data Export
| Tool | What it does |
|------|-------------|
| `export_prospects` | Export enriched contacts from a prospect list |
| `export_email_finder` | Export found emails from a list |
| `export_email_verifier` | Export verified emails (filter by valid/invalid/all) |
| `export_linkedin_scraper` | Export LinkedIn scraper results |
| `export_sales_navigator_scraper` | Export Sales Navigator scraper results |

## Getting Started

### 1. Get your free API key

If you don't have an account yet, **[sign up for free](https://enrich.growthtoolkit.io/dashboard/?authType=get-started)** (no credit card, takes 30 seconds). You get 1,200 free credits to start.

Then grab your API key from **[growthtoolkit.io/api-keys](https://enrich.growthtoolkit.io/api-keys/)**. It starts with `lf_...`.

### 2. Install the MCP server (one command)

Run this in your terminal. It clones, builds, and prints the exact config to copy-paste.

**macOS / Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/iamanantgupta/growthtoolkit-mcp/main/setup.sh | bash
```

**Windows (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/iamanantgupta/growthtoolkit-mcp/main/setup.ps1 | iex
```

That's it. The script installs to `~/.growthtoolkit-mcp` and prints the JSON config with the correct path for your machine.

### 3. Add the config to your AI tool

Copy the JSON config printed by the setup script. Then paste it into the right file:

| Tool | Config file |
|------|------------|
| **Claude Desktop (macOS)** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| **Claude Desktop (Windows)** | `%APPDATA%\Claude\claude_desktop_config.json` |
| **Claude Code** | `.claude/settings.json` |
| **Cursor** | `.cursor/mcp.json` |
| **Windsurf** | `.windsurf/mcp.json` |

The config will look like this (the setup script fills in the correct absolute path for your machine):

```json
{
  "mcpServers": {
    "growthtoolkit": {
      "command": "node",
      "args": ["/Users/yourname/.growthtoolkit-mcp/dist/index.js"],
      "env": {
        "GROWTHTOOLKIT_API_KEY": "lf_your_api_key_here"
      }
    }
  }
}
```

> **Important:** Always use the config printed by the setup script. It has the correct absolute path for your machine. The example above is just to show the format.

> **Important:** If your config file already has other MCP servers, just add the `"growthtoolkit"` section inside the existing `"mcpServers"` object. Do not replace the entire file.

> **Important:** After adding the config, restart your AI tool for the changes to take effect.

Replace `lf_your_api_key_here` with your actual API key from [growthtoolkit.io/api-keys](https://enrich.growthtoolkit.io/api-keys/).

### Manual install (if you prefer)

```bash
# macOS / Linux
git clone https://github.com/iamanantgupta/growthtoolkit-mcp.git $HOME/.growthtoolkit-mcp
cd $HOME/.growthtoolkit-mcp
npm install && npm run build
```

```powershell
# Windows (PowerShell)
git clone https://github.com/iamanantgupta/growthtoolkit-mcp.git $env:USERPROFILE\.growthtoolkit-mcp
cd $env:USERPROFILE\.growthtoolkit-mcp
npm install; npm run build
```

Then use the config format above, replacing the path with the full absolute path to `dist/index.js` on your machine.

## Tool Reference

### Enrichment Tools

**`enrich_linkedin`** is the most powerful tool. Pass any LinkedIn URL and get back:
- Verified email addresses and phone numbers (set `emails: 1`, `phones: 1` to unlock)
- Full name, headline, job title, and current company
- Complete work history, education, and skills
- Location, interests, and social profiles
- Optional: `list_id` to save results, `webhook_url` for async callbacks

**`enrich_email`** works asynchronously. It returns a `task_id` right away. Use `check_task` with that ID to get the full enriched profile once it's ready (usually takes a few seconds).

**`enrich_phone`** requires a `list_id` parameter. Returns the same rich profile data.

**`enrich_domain`** returns company-level information from a domain name.

### Email Tools

**`find_email`** takes `first_name`, `last_name`, and `domain` and returns the most likely email address. GrowthToolkit's deep search finds 30% more emails than traditional tools.

**`verify_email`** checks real-time SMTP validity. Returns `is_valid`, `mx_domain`, and account type (work vs free).

### List & Export Tools

All list tools support `page`, `page_size`, `q` (search), and `detailed` (0 or 1).

All export tools support `page` for pagination. Email verifier export also takes `type_` (`valid`, `invalid`, or `all`). LinkedIn scraper export takes `type` (`search` or `profile`).

## Rate Limits

| Category | Limit | Applies to |
|----------|-------|------------|
| Action | 2 req/sec | Enrichment, email finder, email verifier |
| List | 1 req/sec | Listing and browsing lists |
| Export | 10 req/10 sec | Exporting data from lists |
| Status | 1 req/2 sec | Checking task status |

When rate limited, the API returns HTTP 429 with a `sec` field telling you how long to wait.

## Links

- **GrowthToolkit Homepage**: [growthtoolkit.io](https://growthtoolkit.io)
- **Sign Up (free)**: [Get started](https://enrich.growthtoolkit.io/dashboard/?authType=get-started)
- **API Keys**: [growthtoolkit.io/api-keys](https://enrich.growthtoolkit.io/api-keys/)
- **API Docs**: [growthtoolkit.io/docs](https://enrich.growthtoolkit.io/docs/)

## Built by

Created by [Anant Gupta](https://www.linkedin.com/in/iamanantgupta/), Founder of [GrowthToolkit](https://growthtoolkit.io).

## License

MIT