tomba

The Tomba MCP Server exposes a suite of email discovery, verification, and enrichment tools through the MCP interface. It integrates with the Tomba.io API to provide capabilities such as domain search, email finding, email verification, enrichment, author and LinkedIn email discovery, phone lookup and validation, email counts, and technology/domain insights. You can query these tools via the MCP protocol, enabling Claude (or other MCP clients) to request data, validate emails, enrich leads, and perform bulk research across domains and companies. The server is designed to be used with the standard Claude Desktop MCP configuration, making it easy to swap in the Tomba server as a data provider for your workflows.

Prerequisites

• Node.js 18 or higher
• npm or yarn
• A Tomba API account (sign up at https://tomba.io)

Option A: Install via NPX (Recommended) This method runs the latest published version without cloning the repository.

macOS/Linux

Add to your claude_desktop_config.json (path varies by OS):

{
  "mcpServers": {
    "tomba": {
      "command": "npx",
      "args": ["-y", "tomba-mcp-server"],
      "env": {
        "TOMBA_API_KEY": "your-api-key-here",
        "TOMBA_SECRET_KEY": "your-secret-key-here"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "tomba": {
      "command": "npx",
      "args": ["-y", "tomba-mcp-server"],
      "env": {
        "TOMBA_API_KEY": "your-api-key-here",
        "TOMBA_SECRET_KEY": "your-secret-key-here"
      }
    }
  }
}

Note: The -y flag automatically accepts the installation prompt, and npx will fetch the latest version.

Option B: Install from Source If you want to modify the server or contribute to development:

# Clone the repository
git clone https://github.com/tomba-io/tomba-mcp-server.git
cd tomba-mcp-server

# Install dependencies
yarn install

# Build the project
yarn build

After building, you can point Claude Desktop to the local installation (see the Local Installation steps in the README) using the absolute path to the server entry script.

Environment variables: TOMBA_API_KEY and TOMBA_SECRET_KEY are required for API access. Keep these secrets secure. If you encounter authentication errors, verify your API credentials in your Tomba account. The MCP server supports standard transport via stdio or HTTP as per the Claude integration; ensure your Claude Desktop or client is configured to use the 'stdio' transport unless you have set up an HTTP endpoint. When using NPX, you’ll always pull the latest version of tomba-mcp-server, so configuration should be compatible across updates. If you run into port or path issues during local deployment, ensure you provide absolute paths for local installs and that the Node.js version matches the prerequisites.