Tomba MCP Server

Tomba.io MCP Server

A Model Context Protocol (MCP) server for integrating with the Tomba.io API. This server provides comprehensive email discovery, verification, and enrichment capabilities through a standardized MCP interface.

Features

Tools (28 available)

Email Discovery

• [Domain Search](https://tomba.io/domain-search): Find all email addresses associated with a domain
• [Email Finder](https://tomba.io/email-finder): Generate likely email addresses from names and domains
• [Author Finder](https://tomba.io/author-finder): Discover email addresses of article authors
• [LinkedIn Finder](https://tomba.io/linkedin-finder): Find emails from LinkedIn profile URLs
• [Email Count](https://tomba.io/email-count): Get total email counts for domains
• [Email Sources](https://docs.tomba.io/api): Find where an email address was found on the web
• [Email Format](https://docs.tomba.io/api): Get the email format patterns used by a domain

Verification

• [Email Verifier](https://tomba.io/email-verifier): Verify email deliverability and check database presence

Enrichment

• [Email Enrichment](https://tomba.io/enrichment): Enrich emails with additional contact data
• [Person Enrichment](https://docs.tomba.io/api): Find person data by email (name, position, social profiles)
• [Company Enrichment](https://docs.tomba.io/api): Find company data by domain (industry, size, location)
• [Combined Enrichment](https://docs.tomba.io/api): Combined person + company enrichment by email

Phone

• [Phone Finder](https://tomba.io/phone-finder): Search phone numbers by email, domain, or LinkedIn
• [Phone Validator](https://tomba.io/phone-validator): Validate phone numbers and check carrier info

Domain Intelligence

• [Domain Status](https://docs.tomba.io/api): Check if a domain is webmail or disposable
• [Autocomplete](https://docs.tomba.io/api): Company name suggestions with logo and domain info
• [Similar Finder](https://tomba.io/similar-domains): Find similar domains based on a target domain
• [Technology Finder](https://tomba.io/technology-finder): Discover technology stacks used by websites
• [Location](https://docs.tomba.io/api): Get employees location count by country

Company Search

• [Companies Search](https://app.tomba.io/reveal): Search for companies using natural language queries with advanced filters

Account & Management

• Account Info: Get current account information, plan, and credits
• Usage Info: Get API usage statistics across all endpoints
• List Flags: List submitted data flags with status and credit refunds
• Create Flag: Report incorrect data (hard bounces, invalid emails) for credit recovery
• List Leads: List leads with optional domain filter
• Create Lead: Add a new lead to a list
• List Keys: List API keys
• Get Logs: Get recent API request logs

Resources (7 available)

• tomba://api/status - API status and account info
• tomba://domain/{domain} - Domain information
• tomba://email/{email} - Email information
• tomba://similar/{domain} - Similar domains analysis
• tomba://technology/{domain} - Technology stack information
• tomba://docs/api - API documentation
• tomba://docs/tools - Tools documentation

Prompts (16 pre-built workflows)

• find_contact - Find complete contact info for a person
• verify_email_list - Batch verify email addresses
• research_company - Research company contacts and structure
• enrich_lead - Enrich a lead with all available data
• find_journalists - Find journalist contacts from articles
• phone_finder - Find phone numbers for contacts
• validate_phone - Validate a phone number
• competitor_analysis - Analyze competitors using similar domains and technology
• technology_audit - Comprehensive technology audit of a website
• domain_insights - Get comprehensive insights about a domain including email count and technology
• bulk_domain_research - Research multiple domains for email counts and basic information
• find_target_companies - Find companies with advanced filters (size, type, revenue, industry)
• market_research - Research companies in a market segment with comprehensive filtering
• lead_generation - Generate leads by finding companies and their contacts
• prospect_enrichment - Enrich company prospects with comprehensive data
• industry_analysis - Analyze companies within an industry with detailed segmentation

Filter Options for Company Search Prompts

Performance & Reliability

Timeout

All API calls have a 120-second timeout. Tomba searches run in real time against live infrastructure — response times vary with the target company's SMTP server speed, website responsiveness, and the depth of catch-all detection.

Retry with Exponential Backoff

All API calls automatically retry up to 3 times with exponential backoff on:

• 429 Too Many Requests (rate limit exceeded)
• 5xx server errors

Retry delays: 1s → 2s → 4s.

Rate Limits

Rate limits are enforced per endpoint and per plan:

No credits are charged when Tomba cannot provide a result. Duplicate requests within 30 days are not counted again.

Transport Options

• stdio - Standard input/output (default, for Claude Desktop)
• http - HTTP server with REST endpoints

Installation

Prerequisites

• Node.js 18 or higher
• npm or yarn
• Tomba API account (Sign up here)

Screenshots

Note: The npm package has been renamed from tomba-mcp-server to @tomba-io/tomba-mcp-server. Please update your configurations accordingly.

Option 1: Install via NPX (Recommended)

The easiest way to use the Tomba MCP server is via npx, which doesn't require cloning the repository:

macOS/Linux

Add to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json):

{

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

Windows

Add to your claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json):

{

"mcpServers": { "tomba": { "command": "npx", "args": ["-y", "@tomba-io/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 always fetch the latest version.

Option 2: 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

Configuration

OpenClaw Skill

This repository includes workspace-local skills in skills/. The Cursor plugin (.cursor-plugin/plugin.json) loads them as well.

skills/tomba-contact-intelligence/SKILL.md is the main skill. It helps the agent pick the right Tomba MCP tools for contact discovery, company research, email verification, phone lookup, and prospect enrichment workflows.

Each MCP tool also has its own skill folder, skills/tomba- /SKILL.md. Each one covers the tool's inputs, workflow, expected output, and an example call:

| Company | tomba-companies-search, [tomba-company-enrichment](skills/tomba-company