# Tomba MCP Server

Wires the Tomba API into your agent: it looks up addresses by domain or name, checks deliverability, and fills in person and company details.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: tomba-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tomba-io/tomba-mcp-server
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/mcp/tomba-mcp-server

## What it does

The server exposes 28 tools to the agent. Domain search returns every address tied to a domain, email finder guesses likely ones from a name plus domain, and there are separate tools for article authors and LinkedIn profile URLs. Verification sits in its own group: a deliverability checker, the format patterns a domain uses, and where an address was spotted on the web.

Enrichment adds a name, job title and social profiles to an email, and industry, headcount and location to a domain. Phone tools search numbers by email, domain or LinkedIn and validate them against carrier data. Domain intelligence covers webmail and disposable checks, similar domains, the site's technology stack, and employee counts by country. Company search works with filters for size, type, revenue and industry, and there is lead, key and request-log management on top. The package also ships 7 resources such as `tomba://domain/{domain}` and 16 pre-built prompt workflows.

You need `TOMBA_API_KEY` and `TOMBA_SECRET_KEY` set as environment variables at install time. Rate limits follow the plan — on Free that is 1 request per second, 2 per minute and 5 per day, so bulk list verification will not get far there. Calls wait up to 120 seconds for a response and retry up to 3 times on `429` and `5xx` with delays of 1s, 2s and 4s. Requests that come back empty cost no credits, and repeating the same lookup within 30 days is not billed twice.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.tomba.io/mcp`
- Environment variables: `TOMBA_API_KEY`, `TOMBA_SECRET_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add tomba-mcp-server -e TOMBA_API_KEY=<TOMBA_API_KEY> -e TOMBA_SECRET_KEY=<TOMBA_SECRET_KEY> -- npx -y @tomba-io/tomba-mcp-server
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http tomba-mcp-server https://mcp.tomba.io/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add tomba-mcp-server --url https://mcp.tomba.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add tomba-mcp-server --env TOMBA_API_KEY=<TOMBA_API_KEY> --env TOMBA_SECRET_KEY=<TOMBA_SECRET_KEY> -- npx -y @tomba-io/tomba-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tomba-mcp-server": {
            "url": "https://mcp.tomba.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tomba-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@tomba-io/tomba-mcp-server"
            ],
            "env": {
                "TOMBA_API_KEY": "<TOMBA_API_KEY>",
                "TOMBA_SECRET_KEY": "<TOMBA_SECRET_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tomba-mcp-server": {
            "type": "http",
            "url": "https://mcp.tomba.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tomba-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tomba-io/tomba-mcp-server"
            ],
            "env": {
                "TOMBA_API_KEY": "<TOMBA_API_KEY>",
                "TOMBA_SECRET_KEY": "<TOMBA_SECRET_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http tomba-mcp-server https://mcp.tomba.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e TOMBA_API_KEY=<TOMBA_API_KEY> -e TOMBA_SECRET_KEY=<TOMBA_SECRET_KEY> tomba-mcp-server npx -y @tomba-io/tomba-mcp-server
```
Replace <…> with your own values

## When to use it
- pull working employee addresses off a company domain
- get an article author's email for a pitch
- clean a mailing list of undeliverable addresses
- attach job title, social profiles and company data to a contact
- shortlist target companies by size, revenue and industry

## Example prompts
- Find every email address on `stripe.com` and tell me which format they use
- Verify `john@example.com` and tell me if it's deliverable
- Enrich `jane@acme.io`: name, position, company and industry

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md