Tomba MCP Server

io.github.tomba-io由 GitHub 帳號 tomba-io 發布v1.10.0更新於 Oct 24, 2026

MCP server for Tomba email finder, verification, and contact enrichment API

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取溝通與協作商業與電商

概覽

AI 產生的概覽

Tomba MCP 伺服器，透過 Tomba API 提供電子郵件尋找、驗證、電話查詢，以及聯絡人與公司資料補全。

可以做什麼
  • 尋找與驗證電子郵件：網域搜尋、電子郵件尋找器、作者與 LinkedIn 尋找、郵件數量、來源、格式規則及可投遞性驗證
  • 補全聯絡人與公司：個人、公司與合併補全，以及電話號碼尋找與驗證
  • 調查網域與公司：網域狀態、自動完成、相似網域、技術堆疊、員工地區分布及附篩選條件的公司搜尋
  • 管理帳戶：帳戶與用量資訊、資料標記、潛在客戶、API 金鑰與請求日誌
  • 讀取 Tomba 資源，並執行聯絡人開發、潛在客戶產生與市場研究等預設提示詞
適用情境
適合需要尋找或驗證商務電子郵件、查詢電話號碼、補全潛在客戶資料，或為業務、招募與市場研究了解公司與技術堆疊的情境。
執行需求
可使用 mcp.tomba.io 託管端點並以 OAuth 登入，或在本地以 Node.js 18 以上執行 npm 套件。本地與 API 金鑰方式需要 Tomba 帳戶，並設定 TOMBA_API_KEY 與 TOMBA_SECRET_KEY 環境變數，或使用由兩者產生的 Authorization bearer 權杖。需要能連線至 Tomba API 的網路。
安裝前請注意
需要 Tomba API 憑證（TOMBA_API_KEY、TOMBA_SECRET_KEY 或 Authorization bearer 權杖），應避免寫入共用設定。呼叫會消耗方案額度，並受方案等級限流。部分工具會寫入資料，例如建立潛在客戶與提交資料標記。關於個人、電子郵件與網域的查詢會傳送至 Tomba 第三方服務，補全個人聯絡資料前請考量隱私與同意問題。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tomba MCP Server，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.tomba-io%2Ftomba-mcp-server/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "tomba": {
      "type": "http",
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

README

[Tomba] 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
Verification
  • Email Verifier: Verify email deliverability and check database presence
Enrichment
Phone
Domain Intelligence
Company Search
  • Companies Search: 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
FilterAvailable Values
Size1-10 (Micro), 11-50 (Small), 51-250 (Mid-sized), 251-1K (Medium-large), 1K-5K (Large), 5K-10K (Very large), 10K-50K (Enterprise), 50K-100K (Massive), 100K+ (Global)
Typeeducation, government, nonprofit, private, public, personal
Revenue$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
IndustryBased on LinkedIn Industry Codes V2 (140+ industries including Computer Software, Financial Services, Hospital & Health Care, etc.)

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:

PlanPer SecondPer MinutePer Day
Free125
Basic350500
Growth5801,000
Pro81504,000
50,000+ plansUnlimitedUnlimitedUnlimited

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

[Screenshot 1] [Screenshot 2] [Screenshot 3] [Screenshot 4] [Screenshot 5]

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):

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):

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:

bash
# Clone the repositorygit clone https://github.com/tomba-io/tomba-mcp-server.gitcd tomba-mcp-server
# Install dependenciesyarn install
# Build the projectyarn 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-<tool-name>/SKILL.md. Each one covers the tool's inputs, workflow, expected output, and an example call:

GroupSkills
Emailtomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
Discoverytomba-domain-search, tomba-author-finder, tomba-linkedin-finder
Phonetomba-phone-finder, tomba-phone-validator
Companytomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
Enrichmenttomba-person-enrichment, tomba-combined-enrichment
Leadstomba-list-leads, tomba-create-lead
Data qualitytomba-list-flags, tomba-create-flag
Accounttomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

To use it:

  1. Open this repository as your OpenClaw workspace, or copy the skills/tomba-* directories you need into your OpenClaw skills directory.
  2. Ensure the Tomba MCP server is configured and available to OpenClaw.
  3. Start a new OpenClaw session so the skill is loaded.

Example prompts:

  • "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: [email protected]"

Claude Code Plugin

This repository is also a Claude Code plugin marketplace (.claude-plugin/). The plugin bundles every skill in skills/ and connects to the hosted MCP server at https://mcp.tomba.io/mcp:

bash
/plugin marketplace add tomba-io/tomba-mcp-server/plugin install tomba@tomba

Then run /mcp and authenticate the tomba server with OAuth. No API keys are needed. Plugin skills are namespaced, for example /tomba:tomba-domain-search zapier.com.

Codex Plugin

.codex-plugin/plugin.json packages the same skills for OpenAI Codex. It loads the remote server from .mcp.json. After installing the plugin, sign in with OAuth:

bash
codex mcp login tomba

To use API keys instead of OAuth, send the X-Tomba-Key and X-Tomba-Secret headers, or Authorization: Bearer <base64(ta_key:ts_secret)>, to https://mcp.tomba.io/mcp.

Claude Desktop Setup

To use this server with Claude Desktop, add the configuration to your claude_desktop_config.json file.

Using NPX (Recommended)

This method automatically uses the latest published version:

macOS/Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

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 (%APPDATA%\Claude\claude_desktop_config.json):

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"            }        }    }}
Using Local Installation

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

macOS/Linux:

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

Windows:

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

Important Notes:

  • Replace your-api-key-here and your-secret-key-here with your actual Tomba API credentials
  • For local installation, replace /ABSOLUTE/PATH/TO/tomba-mcp-server with the full path to your installation directory
  • Restart Claude Desktop after updating the configuration

Getting Tomba API Credentials

  1. Visit https://tomba.io
  2. Sign up for an account or log in
  3. Navigate to your dashboard
  4. Go to API settings
  5. Copy your API Key and Secret Key

Alternative: Using HTTP Transport

For HTTP transport with npx:

json
{    "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:

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

Command-line Options

bash
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

Standalone HTTP Server

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

bash
export TOMBA_API_KEY="your-api-key"export TOMBA_SECRET_KEY="your-secret-key"node server/index.js --transport http --port 3000
HTTP API Endpoints
  • 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)
Example HTTP Request
bash
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  }'

🔧 Development

Development Commands

bash
# Run in development modeyarn dev
# Build the projectyarn build
# Run testsyarn test
# Run tests in watch modeyarn test:watch
# Run tests with coverageyarn test:coverage
# Lint codeyarn lint
# Fix linting errorsyarn lint:fix

🔍 Debugging & Testing

MCP Inspector (Recommended)

The easiest way to test and debug your MCP server:

bash
# Build and launch MCP Inspectoryarn debug

This opens a web interface where you can:

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

Alternative Debug Methods

bash
# Debug TypeScript directlyyarn debug:dev
# Run integration testsyarn test:integration
# Manual testingyarn buildecho '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node server/index.js

VS Code Debugging

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

See DEBUG_GUIDE.md for comprehensive debugging instructions.

🧪 Testing Individual Tools

1. Domain Search

Search for email addresses associated with a domain name.

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

Response:

json
{  "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": "[email protected]",        "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    }  }}

2. Email Finder

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

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

Response:

json
{    "data": {        "email": "[email protected]",        "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            }        ]    }}

3. Email Verifier

Verify email address deliverability and check database presence.

json
{    "name": "email_verifier",    "arguments": {        "email": "[email protected]"    }}

Response:

json
{    "data": {        "email": {            "email": "[email protected]",            "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            }        ]    }}

4. Email Enrichment

Enrich an email address with additional contact information.

json
{    "name": "email_enrichment",    "arguments": {        "email": "[email protected]"    }}

Response:

json
{    "data": {        "email": "[email protected]",        "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            }        ]    }}

5. Author Finder

Find email addresses of article authors from a URL.

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

Response:

json
{    "data": {        "email": "[email protected]",        "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            }        ]    }}

6. LinkedIn Finder

Find email addresses from LinkedIn profile URLs.

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

Response:

json
{    "data": {        "email": "[email protected]",        "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            }        ]    }}

7. Phone Finder

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

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

Response:

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

8. Phone Validator

Validate phone numbers and check carrier information.

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

Response:

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

9. Email Count

Get the total number of email addresses for a domain.

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

Response:

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

10. Similar Finder

Find similar domains based on a specific domain.

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

Response:

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

11. Technology Finder

Instantly reveal the technology stack of any website.

json
{    "name": "technology_finder",    "arguments": {        "domain": "tomba.io"    }}

Response:

json
{    "domain": "tomba.io",    "data": [        {            "slug": "intercom",            "name": "Intercom",            "icon": "Intercom.png",            "website": "https://www.intercom.com",            "categories": {                "id": 10,                "slug": "analytics",                "name": "Analytics"            }        }    ]}

12. Companies Search

Search for companies using natural language queries with advanced filters including location, industry, size, and revenue.

json
{    "name": "companies_search",    "arguments": {        "filters": {            "location_city": {                "include": ["san francisco"]            },            "industry": {                "include": ["technology"]            },            "size": {                "include": ["51-200", "201-500"]            }        },        "page": 1,        "limit": 10    }}

Response:

json
{    "data": {        "companies": [            {                "name": "Tech Company Inc",                "domain": "techcompany.com",                "industry": "Technology",                "location": {                    "city": "San Francisco",                    "state": "California",                    "country": "United States"                },                "size": "51-200",                "revenue": "$10M-$50M"            }        ],        "total": 150,        "page": 1    }}

Available Filters:

  • location_city: Filter by city with include/exclude arrays
  • location_state: Filter by state with include/exclude arrays
  • location_country: Filter by country with include/exclude arrays
  • industry: Filter by industry (based on LinkedIn Industry Codes V2 - 140+ industries)
  • type: Filter by company type: education, government, nonprofit, private, public, personal
  • size: Filter by company size: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Filter by revenue range: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Filter by founding year with include/exclude arrays
  • keywords: Filter by keywords with include/exclude arrays
  • sic: Filter by SIC codes with include/exclude arrays
  • naics: Filter by NAICS codes with include/exclude arrays
  • similar: Filter by similar domains with include/exclude arrays

Rate Limiting & Usage

API Rate Limits

Tomba.io implements rate limiting based on your subscription plan:

  • Free Plan: 50 requests per month
  • Growth Plan: 5,000 requests per month + 10,000 verifications requests
  • Pro Plan: 10,000 requests per month
  • Enterprise Plan: 50,000 requests per month
  • Custom Plan: Custom limits

Learn more about Tomba Pricing Plans.

Rate Limit Headers

Each API response includes rate limit information:

X-RateLimit-Limit: 1000X-RateLimit-Remaining: 999X-RateLimit-Reset: 1609459200

Learn more about Tomba API Rate Limits.

Handling Rate Limits

When you exceed your rate limit, the API returns a 429 Too Many Requests status with:

json
{    "error": {        "type": "rate_limit",        "message": "Rate limit exceeded. Please try again in 60 seconds",        "code": 429    }}

Best Practices

  1. Monitor Usage: Check your dashboard at tomba.io/dashboard
  2. Implement Backoff: Handle 429 responses with exponential backoff
  3. Batch Operations: Use domain search for multiple emails from the same domain
  4. Cache Results: Store results locally to avoid duplicate requests
  5. Plan Accordingly: Upgrade your plan based on usage patterns

Usage Tips

  • Domain search returns multiple emails per request (more efficient than individual lookups)
  • Email verification consumes credits only for valid email formats
  • Phone finder may return multiple numbers per request
  • Enrichment provides comprehensive data in a single request

Troubleshooting

Server Not Starting in Claude Desktop

  1. Check Node.js version: Ensure you have Node.js 18 or higher

    bash
    node --version

  2. Using NPX:

    • Ensure you have a stable internet connection for the first run
    • The -y flag should auto-accept the installation
    • NPX will cache the package after first use

  3. Using Local Installation:

    • Verify absolute path is correct in your config
    • Ensure server/index.js exists: ls -la server/index.js
    • Make sure you ran yarn build successfully

  4. Verify API credentials: Ensure your Tomba API keys are correct

  5. Check Claude logs:

    • macOS: ~/Library/Logs/Claude/mcp*.log
    • Windows: %APPDATA%\Claude\logs\mcp*.log

NPX-Specific Issues

"npx command not found":

  • Ensure npm is installed: npm --version
  • NPX comes with npm 5.2.0+, update if needed: npm install -g npm

Package not found:

  • Verify the package is published: npm view @tomba-io/tomba-mcp-server
  • Try clearing npm cache: npm cache clean --force

Always downloading package:

  • This is normal behavior with -y flag
  • NPX caches the package after first download
  • For a permanent installation, use local installation method

Authentication Errors

  • Verify your API keys at https://app.tomba.io/dashboard
  • Ensure environment variables are properly set in the config
  • Check that your API subscription is active

Tools Not Responding

  • Check your Tomba API rate limits
  • Verify network connectivity
  • Review server logs for error messages

About Tomba

Founded in 2020, Tomba prides itself on being the most reliable, accurate, and in-depth source of email address data available anywhere. We process terabytes of data to produce our Email finder API.

[image]

Contributing

  1. Fork it (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

License

Please see the License file for more information.

Support

來源：README.md，提交 e492c11

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.10.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。