Tomba Email Finder

- Find email addresses by domain— Ask to list all emails for a company viadomain_search, with pagination and filters.
- Generate a person's email— Useemail_finderto construct a likely address from a name and domain, then verify it.
- Verify email deliverability— Check an address withemail_verifierfor status, score, and MX/SMTP checks.
- Enrich a contact profile— Pull full details like job title, LinkedIn, and phone for an email usingemail_enrichment.
- Discover author or LinkedIn emails— Extract contacts from an article URL viaauthor_finderor from a profile withlinkedin_finder.
- Research companies and tech stacks— Usecompanies_searchwith filters,similar_finderfor competitors, andtechnology_finderfor stack insights.

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.

- Domain Search: Find all email addresses associated with a domain
- Email Finder: Generate likely email addresses from names and domains
- Email Verifier: Verify email deliverability and check database presence
- Email Enrichment: Enrich emails with additional contact data
- Author Finder: Discover email addresses of article authors
- LinkedIn Finder: Find emails from LinkedIn profile URLs
- Phone Finder: Search phone numbers by email, domain, or LinkedIn
- Phone Validator: Validate phone numbers and check carrier info
- Email Count: Get total email counts for domains
- Similar Finder: Find similar domains based on a target domain
- Technology Finder: Discover technology stacks used by websites
- Companies Search: Search for companies using natural language queries with advanced filters

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

{ "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" } } } }

Add to yourclaude_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-yflag automatically accepts the installation prompt, and npx will always fetch the latest version.

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

This repository now includes a workspace-local OpenClaw skill atskills/tomba-contact-intelligence/SKILL.md.

The skill is designed to help OpenClaw choose the right Tomba MCP tools for contact discovery, company research, email verification, phone lookup, and prospect enrichment workflows.
- Open this repository as your OpenClaw workspace, or copy theskills/tomba-contact-intelligencedirectory into your OpenClaw skills directory.
- Ensure the Tomba MCP server is configured and available to OpenClaw.
- Start a new OpenClaw session so the skill is loaded.

- "Find the best contact for partnerships at stripe.com and verify the email before you return it."
- "Research fintech companies in Germany, then identify likely sales contacts for the top matches."
- "Enrich this prospect with email, phone, company technology, and similar competitors:jane@acme.com"

{ "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(%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" } } } }

If you've built from source, use the absolute path to your installation:

{ "mcpServers": { "tomba": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js"], "env": { "TOMBA_API_KEY": "your-api-key-here", "TOMBA_SECRET_KEY": "your-secret-key-here" } } } }

{ "mcpServers": { "tomba": { "command": "node", "args": [ "C:\\ABSOLUTE\\PATH\\TO\\tomba-mcp-server\\server\\index.js" ], "env": { "TOMBA_API_KEY": "your-api-key-here", "TOMBA_SECRET_KEY": "your-secret-key-here" } } } }

- Replaceyour-api-key-hereandyour-secret-key-herewith your actual Tomba API credentials
- For local installation, replace/ABSOLUTE/PATH/TO/tomba-mcp-serverwith the full path to your installation directory
- Restart Claude Desktop after updating the configuration
- Visithttps://tomba.io
- Sign up for an account or log in
- Navigate to your dashboard
- Go to API settings
- Copy your API Key and Secret Key

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

For HTTP transport with local installation:

{ "mcpServers": { "tomba": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js", "--transport", "http", "--port", "3000" ], "env": { "TOMBA_API_KEY": "your-api-key-here", "TOMBA_SECRET_KEY": "your-secret-key-here" } } } }

Usage: tomba-mcp-server [options] Options: --transport <type> Transport type: 'stdio' or 'http' (default: stdio) --port <number> Port number for HTTP transport (default: 3000) --help Show help message Environment Variables: TOMBA_API_KEY Your Tomba API key (required) TOMBA_SECRET_KEY Your Tomba secret key (required) Examples: # Run with stdio transport (default) node server/index.js # Run with HTTP transport on default port (3000) node server/index.js --transport http # Run with HTTP transport on custom port node server/index.js --transport http --port 8080

You can also run the server as a standalone HTTP service:

export TOMBA_API_KEY="your-api-key" export TOMBA_SECRET_KEY="your-secret-key" node server/index.js --transport http --port 3000

- POST /mcp- Send JSON-RPC requests
- GET /mcp- Server-Sent Events for notifications (requires X-Session-Id header)
- DELETE /mcp- Terminate a session (requires X-Session-Id header)
- GET /health- Health check endpoint
- GET /sessions- List active sessions (requires authentication)

curl -X POST http://localhost:3000/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "email_finder", "arguments": { "domain": "stripe.com", "firstName": "Patrick", "lastName": "Collison" } }, "id": 1 }'

# Run in development mode yarn dev # Build the project yarn build # Run tests yarn test # Run tests in watch mode yarn test:watch # Run tests with coverage yarn test:coverage # Lint code yarn lint # Fix linting errors yarn lint:fix

The easiest way to test and debug your MCP server:

# Build and launch MCP Inspector yarn debug

This opens a web interface where you can:

- 📋 View all available tools
- 🧪 Test tools interactively
- 📊 Inspect requests/responses
- 🐛 Debug in real-time

# Debug TypeScript directly yarn debug:dev # Run integration tests yarn test:integration # Manual testing yarn build echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node server/index.js

If using VS Code, use the included debug configurations:

- Debug MCP Server: Debug the compiled JavaScript
- Debug TypeScript: Debug TypeScript source directly
- Debug with Inspector: Debug with MCP Inspector
- Run Tests: Debug Jest tests

SeeDEBUG_GUIDE.mdfor comprehensive debugging instructions.

Search for email addresses associated with a domain name.

{ "name": "domain_search", "arguments": { "domain": "tomba.io", "limit": 10, "page": 1 } }

{ "data": { "organization": { "website_url": "tomba.io", "organization": "Tomba technology web service LLC", "location": { "country": "US", "city": "Claymont", "state": "Delaware", "street_address": "1228 claymont", "postal_code": "19703" }, "social_links": { "twitter_url": "https://twitter.com/tombaplatforum", "facebook_url": "https://www.facebook.com/tombaplatforum", "linkedin_url": "https://www.linkedin.com/company/tomba-io" }, "disposable": false, "webmail": false, "phone_number": "(850) 790-5575", "industries": "Information Technology and Services", "founded": "2021", "company_size": "1-10", "company_type": "privately held", "revenue": "$0-$1M", "accept_all": false, "description": "the most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.", "pattern": "{l}.{first}", "total_similar": 35, "keywords": [ "lead generation software" ], "ranking": 661495, "whois": { "registrar_name": "namecheap, inc.", "created_date": "2020-07-07T20:54:07+02:00", "referral_url": "https://www.namecheap.com/" }, "last_updated": "2025-09-06T00:22:01+02:00" }, "emails": [ { "email": "b.mohamed@tomba.io", "first_name": "Mohamed", "last_name": "Ben rebia", "full_name": "Mohamed Ben rebia", "gender": "male", "phone_number": false, "type": "personal", "country": "DZ", "position": "CEO", "department": "executive", "seniority": "senior", "twitter": null, "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia", "score": 100, "verification": { "date": "2025-09-22T00:00:00+02:00", "status": "valid" }, "sources": [ { "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts", "website_url": "github.com", "extracted_on": "2021-02-08T20:09:54+01:00", "last_seen_on": "2021-02-08T22:43:40+01:00", "still_on_page": true }, .... ] }, ... ... ... ... ... ] }, "meta": { "total": 21, "pageSize": 10, "current": 1, "total_pages": 3, "params": { "domain": "tomba.io", "page": 1, "limit": 10, "department": null, "country": null, "type": "all", "live": false } } }

Generate likely email addresses from domain, first name, and last name.

{ "name": "email_finder", "arguments": { "domain": "example.com", "firstName": "John", "lastName": "Doe" } }

{ "data": { "email": "b.mohamed@tomba.io", "first_name": "Mohamed", "last_name": "Ben rebia", "full_name": "Mohamed Ben rebia", "website_url": "tomba.io", "company": "Tomba technology web service LLC", "position": "CEO", "country": "DZ", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia", "score": 100, "accept_all": null, "phone_number": false, "verification": { "date": "2025-09-22T00:00:00+02:00", "status": "valid" }, "sources": [ { "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts", "website_url": "github.com", "extracted_on": "2021-02-08T20:09:54+01:00", "last_seen_on": "2021-02-08T22:43:40+01:00", "still_on_page": true } ] } }

Verify email address deliverability and check database presence.

{ "name": "email_verifier", "arguments": { "email": "b.mohamed@tomba.io" } }

{ "data": { "email": { "email": "b.mohamed@tomba.io", "result": "deliverable", "status": "valid", "score": 99, "smtp_provider": "Google Workspace", "mx": { "records": [ "aspmx.l.google.com", "alt2.aspmx.l.google.com", "alt1.aspmx.l.google.com", "alt4.aspmx.l.google.com", "alt3.aspmx.l.google.com" ] }, "mx_check": true, "smtp_server": true, "smtp_check": true, "accept_all": false, "greylisted": false, "block": true, "gibberish": false, "disposable": false, "webmail": false, "regex": true, "whois": { "registrar_name": "namecheap, inc.", "referral_url": "https://www.namecheap.com/", "created_date": "2020-07-07T20:54:07+02:00" } }, "sources": [ { "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts", "website_url": "github.com", "extracted_on": "2021-02-08T20:09:54+01:00", "last_seen_on": "2021-02-08T22:43:40+01:00", "still_on_page": true } ] } }

Enrich an email address with additional contact information.

{ "name": "email_enrichment", "arguments": { "email": "b.mohamed@tomba.io" } }

{ "data": { "email": "b.mohamed@tomba.io", "first_name": "Mohamed", "last_name": "Ben rebia", "full_name": "Mohamed Ben rebia", "website_url": "tomba.io", "company": "Tomba technology web service LLC", "position": "CEO", "country": "DZ", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia", "score": 100, "accept_all": null, "phone_number": false, "verification": { "date": "2025-09-22T00:00:00+02:00", "status": "valid" }, "sources": [ { "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts", "website_url": "github.com", "extracted_on": "2021-02-08T20:09:54+01:00", "last_seen_on": "2021-02-08T22:43:40+01:00", "still_on_page": true } ] } }

Find email addresses of article authors from a URL.

{ "name": "author_finder", "arguments": { "url": "https://example.com/article" } }

{ "data": { "email": "b.mohamed@tomba.io", "first_name": "Mohamed", "last_name": "Ben rebia", "full_name": "Mohamed Ben rebia", "website_url": "tomba.io", "company": "Tomba technology web service LLC", "position": "CEO", "country": "DZ", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia", "score": 100, "accept_all": null, "phone_number": false, "verification": { "date": "2025-09-22T00:00:00+02:00", "status": "valid" }, "sources": [ { "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts", "website_url": "github.com", "extracted_on": "2021-02-08T20:09:54+01:00", "last_seen_on": "2021-02-08T22:43:40+01:00", "still_on_page": true } ] } }

Find email addresses from LinkedIn profile URLs.

{ "name": "linkedin_finder", "arguments": { "url": "https://linkedin.com/in/johndoe" } }

{ "data": { "email": "b.mohamed@tomba.io", "first_name": "Mohamed", "last_name": "Ben rebia", "full_name": "Mohamed Ben rebia", "website_url": "tomba.io", "company": "Tomba technology web service LLC", "position": "CEO", "country": "DZ", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia", "score": 100, "accept_all": null, "phone_number": false, "verification": { "date": "2025-09-22T00:00:00+02:00", "status": "valid" }, "sources": [ { "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts", "website_url": "github.com", "extracted_on": "2021-02-08T20:09:54+01:00", "last_seen_on": "2021-02-08T22:43:40+01:00", "still_on_page": true } ] } }

Search for phone numbers based on email, domain, or LinkedIn profile.

{ "name": "phone_finder", "arguments": { "domain": "tomba.io" } }

{ "data": { "domain": "tomba.io", "valid": true, "local_format": "(850) 790-5575", "intl_format": "+1 850-790-5575", "e164_format": "+18507905575", "rfc3966_format": "tel:+1-850-790-5575", "country_code": "US", "line_type": "FIXED_LINE_OR_MOBILE", "carrier": "", "timezones": ["America/New_York"] } }

Validate phone numbers and check carrier information.

{ "name": "phone_validator", "arguments": { "phone": "+213667945402" } }

{ "data": { "valid": true, "local_format": "0667 94 54 02", "intl_format": "+213 667 94 54 02", "e164_format": "+213667945402", "rfc3966_format": "tel:+213-667-94-54-02", "country_code": "DZ", "line_type": "MOBILE", "carrier": "Mobilis", "timezones": ["Europe/Paris"] } }

Get the total number of email addresses for a domain.

{ "name": "email_count", "arguments": { "domain": "tomba.io" } }

{ "domain": "tomba.io", "total": 245, "personalEmails": 198, "genericEmails": 47, "department": { "engineering": 45, "sales": 38, "marketing": 32, "hr": 15, "finance": 12, "legal": 8, "executive": 25, "support": 28, "other": 42 }, "seniority": { "junior": 89, "senior": 125, "executive": 31 }, "source": "tomba_email_count" }

Find similar domains based on a specific domain.

{ "name": "similar_finder", "arguments": { "domain": "tomba.io" } }

{ "data": [ { "website_url": "summit.com", "name": "Summit", "industries": "Wholesale" }, { "website_url": "hunter.io", "name": "Hunter", "industries": "Information Technology and Services" }, { "website_url": "voilaNorbert.com", "name": "VoilaNorbert", "industries": "Information Technology and Services" } ] }