Tomba MCP

官方

Tomba，您獨特的B2B電子郵件查找與驗證工具，提供獨特的潛在客戶資料庫，讓您輕鬆有效地擴大業務拓展規模。

GitHub

你可以用 Tomba MCP 做什麼？

尋找聯絡電子郵件 — 透過 domain_search 查詢與某個網域相關的所有電子郵件地址，並可依部門或國家等條件篩選。
產生可能的地址 — 使用 email_finder 根據個人姓名與公司網域，建構出可能的電子郵件。
驗證可送達性 — 使用 email_verifier 檢查電子郵件是否有效且可送達，包含 SMTP 與 MX 檢查。
豐富聯絡人資料 — 針對已知電子郵件，使用 email_enrichment 取得詳細的個人檔案（姓名、職位、社群媒體）。
找出作者電子郵件 — 使用 author_finder 從文章 URL 中擷取作者的電子郵件地址。

文件

Tomba.io MCP 伺服器

一個用於整合 Tomba.io API 的 Model Context Protocol (MCP) 伺服器。此伺服器透過標準化的 MCP 介面提供全面的電子郵件發現、驗證和豐富化功能。

功能特色

工具（共 28 個）

電子郵件發現

Domain Search：查找與某個網域關聯的所有電子郵件地址
Email Finder：根據姓名和網域生成可能的電子郵件地址
Author Finder：發現文章作者的電子郵件地址
LinkedIn Finder：從 LinkedIn 個人檔案 URL 查找電子郵件
Email Count：獲取網域的電子郵件總數
Email Sources：查找電子郵件地址在網路上的來源位置
Email Format：獲取某個網域使用的電子郵件格式模式

驗證

Email Verifier：驗證電子郵件的可送達性並檢查資料庫是否存在

豐富化

Email Enrichment：使用額外的聯絡人資料豐富化電子郵件
Person Enrichment：透過電子郵件查找個人資料（姓名、職位、社交檔案）
Company Enrichment：透過網域查找公司資料（產業、規模、地點）
Combined Enrichment：透過電子郵件進行個人 + 公司的綜合豐富化

電話

Phone Finder：透過電子郵件、網域或 LinkedIn 搜尋電話號碼
Phone Validator：驗證電話號碼並檢查電信業者資訊

網域情報

Domain Status：檢查網域是否為網路郵件或一次性網域
Autocomplete：提供公司名稱建議，包含標誌和網域資訊
Similar Finder：根據目標網域查找相似網域
Technology Finder：發現網站使用的技術堆疊
Location：獲取按國家/地區劃分的員工位置數量

公司搜尋

Companies Search：使用自然語言查詢和高級篩選器搜尋公司

帳戶與管理

Account Info：獲取目前帳戶資訊、方案和點數
Usage Info：獲取所有端點的 API 使用統計
List Flags：列出已提交的資料標記及其狀態和點數退款
Create Flag：回報不正確的資料（硬退信、無效電子郵件）以進行點數恢復
List Leads：列出潛在客戶，可選擇網域篩選
Create Lead：將新的潛在客戶加入清單
List Keys：列出 API 金鑰
Get Logs：獲取最近的 API 請求日誌

資源（共 7 個）

tomba://api/status - API 狀態和帳戶資訊
tomba://domain/{domain} - 網域資訊
tomba://email/{email} - 電子郵件資訊
tomba://similar/{domain} - 相似網域分析
tomba://technology/{domain} - 技術堆疊資訊
tomba://docs/api - API 文件
tomba://docs/tools - 工具文件

提示詞（16 個預建工作流程）

find_contact - 查找個人的完整聯絡資訊
verify_email_list - 批次驗證電子郵件地址
research_company - 研究公司聯絡人和組織結構
enrich_lead - 使用所有可用資料豐富化潛在客戶
find_journalists - 從文章中查找記者聯絡方式
phone_finder - 查找聯絡人的電話號碼
validate_phone - 驗證電話號碼
competitor_analysis - 使用相似網域和技術分析競爭對手
technology_audit - 網站的全面技術稽核
domain_insights - 獲取網域的全面洞察，包括電子郵件數量和技術
bulk_domain_research - 研究多個網域的電子郵件數量和基本資訊
find_target_companies - 使用高級篩選器（規模、類型、營收、產業）查找公司
market_research - 使用全面篩選研究市場區隔中的公司
lead_generation - 透過查找公司及其聯絡人來生成潛在客戶
prospect_enrichment - 使用全面資料豐富化公司潛在客戶
industry_analysis - 分析某個產業內的公司並進行詳細分層

公司搜尋提示詞的篩選選項

篩選器	可用值
規模	1-10（微型）、11-50（小型）、51-250（中型）、251-1K（中大型）、1K-5K（大型）、5K-10K（超大型）、10K-50K（企業級）、50K-100K（巨型）、100K+（全球級）
類型	education、government、nonprofit、private、public、personal
營收	$0-$1M、$1M-$10M、$10M-$50M、$50M-$100M、$100M-$250M、$250M-$500M、$500M-$1B、$1B-$10B、$10B+
產業	基於 LinkedIn Industry Codes V2（140+ 個產業，包括 Computer Software、Financial Services、Hospital & Health Care 等）

效能與可靠性

逾時

所有 API 呼叫都有 120 秒逾時。Tomba 搜尋會即時針對實際基礎設施執行 — 回應時間會因目標公司的 SMTP 伺服器速度、網站回應性以及 catch-all 偵測的深度而有所不同。

指數退避重試

所有 API 呼叫在以下情況會自動重試最多 3 次，並採用指數退避：

429 Too Many Requests（超出速率限制）
5xx 伺服器錯誤

重試延遲：1 秒 → 2 秒 → 4 秒。

速率限制

速率限制按端點和方案執行：

方案	每秒	每分鐘	每天
Free	1	2	5
Basic	3	50	500
Growth	5	80	1,000
Pro	8	150	4,000
50,000+ 方案	無限制	無限制	無限制

當 Tomba 無法提供結果時，不會收取任何點數。30 天內的重複請求不會再次計費。

傳輸選項

stdio - 標準輸入/輸出（預設，適用於 Claude Desktop）
http - 具有 REST 端點的 HTTP 伺服器

安裝

先決條件

Node.js 18 或更高版本
npm 或 yarn
Tomba API 帳戶（在此註冊）

截圖

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

注意： npm 套件已從 tomba-mcp-server 重新命名為 @tomba-io/tomba-mcp-server。請相應地更新您的設定。

選項 1：透過 NPX 安裝（建議）

使用 Tomba MCP 伺服器最簡單的方式是透過 npx，這不需要複製儲存庫：

macOS/Linux

新增至您的 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

新增至您的 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"
            }
        }
    }
}

注意： -y 旗標會自動接受安裝提示，且 npx 將始終取得最新版本。

選項 2：從原始碼安裝

如果您想要修改伺服器或為開發做出貢獻：

# 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

設定

OpenClaw Skill

此儲存庫包含 skills/ 中的工作區本地 skills。Cursor 外掛程式（.cursor-plugin/plugin.json）也會載入它們。

skills/tomba-contact-intelligence/SKILL.md 是主要的 skill。它協助代理程式為聯絡人發現、公司研究、電子郵件驗證、電話查詢和潛在客戶豐富化工作流程選擇正確的 Tomba MCP 工具。

每個 MCP 工具也有自己的 skill 資料夾，skills/tomba-<tool-name>/SKILL.md。每個都涵蓋工具的輸入、工作流程、預期輸出和範例呼叫：

群組	技能
Email	`tomba-email-finder`, `tomba-email-verifier`, `tomba-email-enrichment`, `tomba-email-count`, `tomba-email-sources`, `tomba-email-format`
Discovery	`tomba-domain-search`, `tomba-author-finder`, `tomba-linkedin-finder`
Phone	`tomba-phone-finder`, `tomba-phone-validator`
Company	`tomba-companies-search`, `tomba-company-enrichment`, `tomba-similar-finder`, `tomba-technology-finder`, `tomba-autocomplete`, `tomba-location`, `tomba-domain-status`
Enrichment	`tomba-person-enrichment`, `tomba-combined-enrichment`
Leads	`tomba-list-leads`, `tomba-create-lead`
Data quality	`tomba-list-flags`, `tomba-create-flag`
Account	`tomba-account-info`, `tomba-usage-info`, `tomba-list-keys`, `tomba-get-logs`

使用方法：

將此儲存庫作為您的 OpenClaw 工作區開啟，或將您需要的 skills/tomba-* 目錄複製到您的 OpenClaw 技能目錄中。
確保 Tomba MCP 伺服器已設定完成且可供 OpenClaw 使用。
啟動新的 OpenClaw 工作階段，以便載入技能。

範例提示：

"在 stripe.com 尋找最適合合作夥伴關係的聯絡人，並在回傳前驗證電子郵件。"
"研究德國的金融科技公司，然後為最符合的對象找出可能的銷售聯絡人。"
"使用電子郵件、電話、公司技術和類似競爭對手來豐富此潛在客戶資料：jane@acme.com"

Claude Code 外掛程式

此儲存庫同時也是 Claude Code 外掛程式市集 (.claude-plugin/)。此外掛程式將 skills/ 中的所有技能打包，並連線到位於 https://mcp.tomba.io/mcp 的託管 MCP 伺服器：

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

然後執行 /mcp 並使用 OAuth 驗證 tomba 伺服器。不需要 API 金鑰。外掛程式技能具有命名空間，例如 /tomba:tomba-domain-search zapier.com。

Codex 外掛程式

.codex-plugin/plugin.json 為 OpenAI Codex 打包了相同的技能。它會從 .mcp.json 載入遠端伺服器。安裝外掛程式後，使用 OAuth 登入：

codex mcp login tomba

若要使用 API 金鑰而非 OAuth，請將 X-Tomba-Key 和 X-Tomba-Secret 標頭，或 Authorization: Bearer <base64(ta_key:ts_secret)>，傳送至 https://mcp.tomba.io/mcp。

Claude Desktop 設定

若要將此伺服器與 Claude Desktop 搭配使用，請將設定新增至您的 claude_desktop_config.json 檔案。

使用 NPX（建議）

此方法會自動使用最新發佈的版本：

macOS/Linux (~/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 (%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"
            }
        }
    }
}

使用本機安裝

如果您是從原始碼建置，請使用您安裝的絕對路徑：

macOS/Linux：

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

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

重要注意事項：

將 your-api-key-here 和 your-secret-key-here 替換為您實際的 Tomba API 憑證
對於本機安裝，請將 /ABSOLUTE/PATH/TO/tomba-mcp-server 替換為您安裝目錄的完整路徑
更新設定後請重新啟動 Claude Desktop

取得 Tomba API 憑證

造訪 https://tomba.io
註冊帳戶或登入
導覽至您的儀表板
前往 API 設定
複製您的 API 金鑰和密鑰

替代方案：使用 HTTP 傳輸

搭配 npx 使用 HTTP 傳輸：

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

搭配本機安裝使用 HTTP 傳輸：

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

獨立 HTTP 伺服器

您也可以將伺服器作為獨立的 HTTP 服務執行：

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

HTTP API 端點

POST /mcp - 傳送 JSON-RPC 請求
GET /mcp - 用於通知的伺服器傳送事件（需要 X-Session-Id 標頭）
DELETE /mcp - 終止工作階段（需要 X-Session-Id 標頭）
GET /health - 健康檢查端點
GET /sessions - 列出作用中的工作階段（需要驗證）

HTTP 請求範例

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

🔍 除錯與測試

MCP Inspector（建議）

測試和除錯 MCP 伺服器最簡單的方式：

# Build and launch MCP Inspector
yarn debug

這會開啟一個網頁介面，您可以在其中：

📋 檢視所有可用的工具
🧪 互動式測試工具
📊 檢查請求/回應
🐛 即時除錯

替代除錯方法

# 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

VS Code 除錯

如果您使用 VS Code，請使用內建的除錯設定：

Debug MCP Server：除錯已編譯的 JavaScript
Debug TypeScript：直接除錯 TypeScript 原始碼
Debug with Inspector：使用 MCP Inspector 除錯
Run Tests：除錯 Jest 測試

請參閱 DEBUG_GUIDE.md 以取得完整的除錯說明。

🧪 測試個別工具

1. 網域搜尋

搜尋與網域名稱關聯的電子郵件地址。

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

2. 電子郵件尋找器

從網域、名字和姓氏產生可能的電子郵件地址。

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

3. 電子郵件驗證器

驗證電子郵件地址的可送達性並檢查資料庫是否存在。

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

4. 電子郵件豐富化

使用額外的聯絡資訊豐富化電子郵件地址。

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

5. 作者尋找器

從 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
            }
        ]
    }
}

6. LinkedIn 尋找器

從 LinkedIn 個人檔案 URL 尋找電子郵件地址。

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

7. 電話尋找器

根據電子郵件、網域或 LinkedIn 個人檔案搜尋電話號碼。

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

8. 電話驗證器

驗證電話號碼並檢查電信業者資訊。

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

9. 電子郵件計數

取得某個網域的電子郵件地址總數。

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

10. 相似尋找器

根據特定網域尋找相似的網域。

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

11. 技術尋找器

立即揭露任何網站的技術堆疊。

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

回應：

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

12. 公司搜尋

使用自然語言查詢搭配進階篩選條件（包括地點、產業、規模和營收）搜尋公司。

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

回應：

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

可用的篩選條件：

location_city：使用包含/排除陣列依城市篩選
location_state：使用包含/排除陣列依州篩選
location_country：使用包含/排除陣列依國家篩選
industry：依產業篩選（根據 LinkedIn 產業代碼 V2 - 140+ 種產業）
type：依公司類型篩選：education、government、nonprofit、private、public、personal
size：依公司規模篩選：1-10、11-50、51-250、251-1K、1K-5K、5K-10K、10K-50K、50K-100K、100K+
revenue：依營收範圍篩選：$0-$1M、$1M-$10M、$10M-$50M、$50M-$100M、$100M-$250M、$250M-$500M、$500M-$1B、$1B-$10B、$10B+
founded：使用包含/排除陣列依成立年份篩選
keywords：使用包含/排除陣列依關鍵字篩選
sic：使用包含/排除陣列依 SIC 代碼篩選
naics：使用包含/排除陣列依 NAICS 代碼篩選
similar：使用包含/排除陣列依相似網域篩選

速率限制與使用方式

API 速率限制

Tomba.io 根據您的訂閱方案實施速率限制：

免費方案：每月 50 次請求
成長方案：每月 5,000 次請求 + 10,000 次驗證請求
專業方案：每月 10,000 次請求
企業方案：每月 50,000 次請求
自訂方案：自訂限制

深入瞭解 Tomba 定價方案。

速率限制標頭

每個 API 回應都包含速率限制資訊：

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

深入瞭解 Tomba API 速率限制。

處理速率限制

當您超過速率限制時，API 會傳回 429 Too Many Requests 狀態，並包含：

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

最佳實務

監控使用量：在 tomba.io/dashboard 檢查您的儀表板
實作退避機制：使用指數退避處理 429 回應
批次操作：使用網域搜尋取得同一網域的多個電子郵件
快取結果：在本機儲存結果以避免重複請求
妥善規劃：根據使用模式升級您的方案

使用提示

網域搜尋每次請求可回傳多個電子郵件（比個別查詢更有效率）
電子郵件驗證僅對有效的電子郵件格式消耗額度
電話搜尋每次請求可能回傳多個號碼
資料豐富化在單一請求中提供全面的資料

疑難排解

伺服器無法在 Claude Desktop 中啟動

檢查 Node.js 版本：確保您有 Node.js 18 或更高版本
```
node --version
```
使用 NPX：
- 確保首次執行時有穩定的網路連線
- -y 旗標應自動接受安裝
- NPX 會在首次使用後快取套件
使用本機安裝：
- 驗證設定中的絕對路徑是否正確
- 確保 server/index.js 存在：ls -la server/index.js
- 確認您已成功執行 yarn build
驗證 API 憑證：確保您的 Tomba API 金鑰正確
檢查 Claude 日誌：
- macOS：~/Library/Logs/Claude/mcp*.log
- Windows：%APPDATA%\Claude\logs\mcp*.log

NPX 特定問題

「找不到 npx 指令」：

確保已安裝 npm：npm --version
NPX 隨附於 npm 5.2.0+，如有需要請更新：npm install -g npm

找不到套件：

驗證套件是否已發布：npm view @tomba-io/tomba-mcp-server
嘗試清除 npm 快取：npm cache clean --force

持續下載套件：

這是使用 -y 旗標時的正常行為
NPX 會在首次下載後快取套件
若要永久安裝，請使用本機安裝方法

驗證錯誤

在 https://app.tomba.io/dashboard 驗證您的 API 金鑰
確保環境變數已在設定中正確設定
檢查您的 API 訂閱是否有效

工具無回應

檢查您的 Tomba API 速率限制
驗證網路連線
檢視伺服器日誌中的錯誤訊息

關於 Tomba

Tomba 成立於 2020 年，以提供市面上最可靠、最準確且最深入的電子郵件地址資料來源為傲。我們處理數 TB 的資料來產生我們的 Email finder API。

貢獻

Fork 它（https://github.com/tomba-io/tomba-mcp-server/fork）
建立您的功能分支（git checkout -b my-new-feature）
提交您的變更（git commit -am 'Add some feature'）
推送到分支（git push origin my-new-feature）
建立新的 Pull Request

授權

請參閱 License 檔案以取得更多資訊。

Tomba MCP

你可以用 Tomba MCP 做什麼？

文件

Tomba.io MCP 伺服器

功能特色

工具（共 28 個）

電子郵件發現

驗證

豐富化

電話

網域情報

公司搜尋

帳戶與管理

資源（共 7 個）

提示詞（16 個預建工作流程）

公司搜尋提示詞的篩選選項

效能與可靠性

逾時

指數退避重試

速率限制

傳輸選項

安裝

先決條件

截圖

選項 1：透過 NPX 安裝（建議）

macOS/Linux

Windows

選項 2：從原始碼安裝

設定

OpenClaw Skill

Claude Code 外掛程式

Codex 外掛程式

Claude Desktop 設定

使用 NPX（建議）

使用本機安裝

取得 Tomba API 憑證

替代方案：使用 HTTP 傳輸

使用方式

命令列選項

獨立 HTTP 伺服器

HTTP API 端點

HTTP 請求範例

🔧 開發

開發命令

🔍 除錯與測試

MCP Inspector（建議）

替代除錯方法

VS Code 除錯

🧪 測試個別工具

1. 網域搜尋

2. 電子郵件尋找器

3. 電子郵件驗證器

4. 電子郵件豐富化

5. 作者尋找器

6. LinkedIn 尋找器

7. 電話尋找器

8. 電話驗證器

9. 電子郵件計數

10. 相似尋找器

11. 技術尋找器

12. 公司搜尋

速率限制與使用方式

API 速率限制

速率限制標頭

處理速率限制

最佳實務

使用提示

疑難排解

伺服器無法在 Claude Desktop 中啟動

NPX 特定問題

驗證錯誤

工具無回應

關於 Tomba

貢獻

授權

支援