explee-mcp

MCP server wrapping the Explee B2B data API. Gives AI agents tools to search companies and people, enrich emails and phones, run AI agents, and manage deduplication lists.

Tools

Tool	Description
search_companies	Search companies by industry, geography, size, revenue, tech stack, funding, traffic
search_companies_by_domains	Bulk-enrich company profiles by domain
search_people	Search professionals by job title and company filters
search_people_by_domains	Find contacts at companies by domain
nl_to_filters	Convert natural-language ICP description to structured filters
enrich_email	Find verified professional email by name + domain
enrich_phone	Find work phone via LinkedIn URL
create_batch_email_enrichment	Async bulk email enrichment — returns a task_id
get_batch_enrichment	Poll results of a batch enrichment job
create_find_and_enrich	Combined search + email enrichment in one async job
get_find_and_enrich	Poll results of a find-and-enrich job
list_tasks	List all async jobs on your account
list_agents	Browse available pre-built Explee AI agents
start_agent_run_by_id	Run a pre-built agent by ID
start_custom_agent_run	Run a custom agent with your own system prompt and schema
get_agent_run_status	Poll status and results of an agent run
web_search	Web search within agent workflows
get_billing_balance	Check your Explee credit balance
topup_credits	Purchase additional credits
list_people_dedup_lists	List people deduplication lists
create_people_dedup_list	Create an exclusion list of LinkedIn URLs
get_people_dedup_list	Retrieve contents of a people dedup list
delete_people_dedup_list	Delete a people dedup list
list_company_dedup_lists	List company deduplication lists
create_company_dedup_list	Create an exclusion list of company domains
get_company_dedup_list	Retrieve contents of a company dedup list
delete_company_dedup_list	Delete a company dedup list

Prerequisites

• An Explee API key

---

Option A — Use the hosted server (recommended)

No local setup needed. Pass your Explee API key as a Bearer token when registering the server.

Claude Code

claude mcp add --transport http explee https://explee.drreamer.digital/mcp \
  --header "Authorization: Bearer YOUR_EXPLEE_API_KEY"

Or add manually to .mcp.json at your project root:

{
  "mcpServers": {
    "explee": {
      "type": "http",
      "url": "https://explee.drreamer.digital/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_EXPLEE_API_KEY"
      }
    }
  }
}

Codex CLI

Codex reads the token from an environment variable rather than embedding it in the command:

export EXPLEE_API_KEY=your_api_key_here
codex mcp add explee --url https://explee.drreamer.digital/mcp \
  --bearer-token-env-var EXPLEE_API_KEY

Or add manually to ~/.codex/config.toml (global) or .codex/config.toml (project):

[mcp_servers.explee]
url = "https://explee.drreamer.digital/mcp"
bearer_token_env_var = "EXPLEE_API_KEY"

---

Option B — Run locally

Setup

git clone https://github.com/digitaldrreamer/explee-mcp
cd explee-mcp
npm install
cp .env.example .env

Edit .env:

EXPLEE_API_KEY=your_api_key_here
PORT=3000

Build and start:

npm run build
npm start

For development with auto-reload:

npm run dev

The server listens at http://localhost:3000/mcp.

Claude Code

claude mcp add --transport http explee http://localhost:3000/mcp

No --header needed — the server reads EXPLEE_API_KEY from its own .env.

Or manually in .mcp.json:

{
  "mcpServers": {
    "explee": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Codex CLI

codex mcp add explee --url http://localhost:3000/mcp

Or manually in .codex/config.toml:

[mcp_servers.explee]
url = "http://localhost:3000/mcp"

---

Health check

curl http://localhost:3000/health
# {"ok":true,"server":"explee-mcp","version":"1.0.0"}