Tomba MCP Server

Tomba.io MCP 服务

用于集成 Tomba.io API 的模型上下文协议（MCP）服务。此服务通过标准化的 MCP 接口，提供全面的电子邮件发现、验证和丰富功能。

功能

工具（共 28 个）

电子邮件发现

• 域名搜索：查找与某个域名关联的所有电子邮件地址
• 电子邮件查找器：根据姓名和域名生成可能的电子邮件地址
• 作者查找器：发现文章作者的电子邮件地址
• LinkedIn 查找器：根据 LinkedIn 个人资料 URL 查找电子邮件地址
• 电子邮件数量：获取域名的电子邮件地址总数
• 电子邮件来源：查找某个电子邮件地址在网上的发现位置
• 电子邮件格式：获取域名使用的电子邮件格式模式

验证

• 电子邮件验证器：验证电子邮件是否可送达，并检查其是否存在于数据库中

信息丰富

• 电子邮件信息丰富：为电子邮件补充额外的联系人数据
• 个人信息丰富：根据电子邮件查找个人数据（姓名、职位、社交资料）
• 公司信息丰富：根据域名查找公司数据（行业、规模、位置）
• 综合信息丰富：根据电子邮件综合补充个人和公司信息

电话

• 电话查找器：根据电子邮件、域名或 LinkedIn 搜索电话号码
• 电话验证器：验证电话号码并检查运营商信息

域名情报

• 域名状态：检查域名是否为 Web 邮箱或一次性邮箱
• 自动补全：提供公司名称建议以及徽标和域名信息
• 相似项查找器：根据目标域名查找相似域名
• 技术查找器：发现网站使用的技术栈
• 位置：获取各国员工数量

公司搜索

• 公司搜索：使用自然语言查询和高级筛选条件搜索公司

账户与管理

• 账户信息：获取当前账户信息、套餐和额度
• 使用情况信息：获取所有端点的 API 使用统计数据
• 标记列表：列出已提交的数据标记，包括状态和额度退款信息
• 创建标记：报告错误数据（硬退信、无效电子邮件）以恢复额度
• 线索列表：列出线索，可选按域名筛选
• 创建线索：向列表添加新线索
• 密钥列表：列出 API 密钥
• 获取日志：获取近期 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 行业代码 V2（包含 140 多个行业，例如计算机软件、金融服务、医院与医疗保健等）

性能与可靠性

超时

所有 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+ plans	不限	不限	不限

Tomba 无法提供结果时，不会扣除额度。30 天内的重复请求不会再次计数。

传输选项

• stdio - 标准输入/输出（默认，用于 Claude Desktop）
• http - 带 REST 端点的 HTTP 服务

安装

前置条件

• Node.js 18 或更高版本
• npm 或 yarn
• Tomba API 账户（在此注册）

截图

注意： 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 技能

此代码仓库在 skills/ 中包含工作区本地技能。Cursor 插件（.cursor-plugin/plugin.json）也会加载这些技能。

skills/tomba-contact-intelligence/SKILL.md 是主要技能。它可帮助 Agent 为联系人发现、公司研究、电子邮件验证、电话号码查询和潜在客户信息丰富工作流选择合适的 Tomba MCP 工具。

每个 MCP 工具也都有自己的技能文件夹 skills/tomba-<tool-name>/SKILL.md。每个文件夹都介绍该工具的输入、工作流、预期输出和调用示例：

Group	Skills
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

使用方法：

1. 将此仓库作为 OpenClaw 工作区打开，或将所需的 skills/tomba-* 目录复制到 OpenClaw 技能目录中。
2. 确保已配置 Tomba MCP 服务，并且 OpenClaw 可以使用该服务。
3. 启动新的 OpenClaw 会话，以加载技能。

示例提示词：

• “查找 stripe.com 上最适合负责合作事宜的联系人，并在返回邮箱前验证邮箱。”
• “调研德国的金融科技公司，然后找出最符合条件的公司中可能负责销售的联系人。”
• “补充此潜在客户的信息，包括邮箱、电话、公司技术栈和类似的竞争对手：[email protected]”

Claude Code 插件

此仓库也是一个 Claude Code 插件市场（.claude-plugin/）。该插件包含 skills/ 中的所有技能，并连接到托管的 MCP 服务 https://mcp.tomba.io/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，请向 https://mcp.tomba.io/mcp 发送 X-Tomba-Key 和 X-Tomba-Secret 标头，或发送 Authorization: Bearer <base64(ta_key:ts_secret)>。

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 凭据

1. 访问 https://tomba.io
2. 注册账号或登录
3. 前往控制面板
4. 进入 API 设置
5. 复制 API Key 和 Secret Key

替代方案：使用 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

这会打开一个 Web 界面，你可以在其中：

• 📋 查看所有可用工具
• 🧪 交互式测试工具
• 📊 检查请求和响应
• 🐛 实时调试

其他调试方法

# 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，请使用附带的调试配置：

• 调试 MCP 服务：调试编译后的 JavaScript
• 调试 TypeScript：直接调试 TypeScript 源代码
• 使用 Inspector 调试：使用 MCP Inspector 调试
• 运行测试：调试 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": "[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 查找器

根据域名、名字和姓氏生成可能的邮箱地址。

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

响应：

{
    "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 验证器

验证邮箱地址是否可送达，并检查其是否存在于数据库中。

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

响应：

{
    "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 信息丰富

为邮箱地址补充其他联系信息。

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

响应：

{
    "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. 作者查找器

根据 URL 查找文章作者的邮箱地址。

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

响应：

{
    "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 查找器

根据 LinkedIn 个人资料 URL 查找邮箱地址。

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

响应：

{
    "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. 电话查找器

根据邮箱、域名或 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. Email 数量

获取域名对应的邮箱地址总数。

{
    "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 Industry Codes 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 次请求
• Growth 计划：每月 5,000 次请求 + 10,000 次验证请求
• Pro 计划：每月 10,000 次请求
• Enterprise 计划：每月 50,000 次请求
• Custom 计划：自定义限制

详细了解 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
    }
}

最佳实践

1. 监控用量：在 tomba.io/dashboard 查看仪表板
2. 实施退避机制：使用指数退避处理 429 响应
3. 批量操作：从同一域名查找多个邮箱时使用域名搜索
4. 缓存结果：在本地存储结果，避免重复请求
5. 合理规划：根据用量模式升级计划

用量提示

• 域名搜索每次请求会返回多个邮箱（比逐个查询更高效）
• 邮箱验证仅对格式有效的邮箱消耗额度
• 电话查找器每次请求可能会返回多个号码
• 信息丰富功能可通过单次请求提供全面数据

故障排除

Claude Desktop 中的服务无法启动

1. 检查 Node.js 版本：确保 Node.js 版本为 18 或更高

   node --version
   

2. 使用 NPX：

   • 确保首次运行时网络连接稳定
   • -y 标志应自动接受安装
   • NPX 会在首次使用后缓存软件包

3. 使用本地安装：

   • 确认配置中的绝对路径正确
   • 确保 server/index.js 存在：ls -la server/index.js
   • 确保已成功运行 yarn build

4. 验证 API 凭据：确保 Tomba API 密钥正确

5. 检查 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 的数据，为我们的电子邮件查找 API 提供支持。

参与贡献

1. Fork 项目（https://github.com/tomba-io/tomba-mcp-server/fork）
2. 创建功能分支（git checkout -b my-new-feature）
3. 提交更改（git commit -am 'Add some feature'）
4. 推送到分支（git push origin my-new-feature）
5. 创建新的 Pull Request

许可证

更多信息请参阅 许可证 文件。

支持

• GitHub 问题
• 电子邮件支持
• 网站