Tomba MCP Server

官方

Tomba，您独特的B2B邮箱查找与验证工具，提供独特的潜在客户数据库，助力轻松高效地扩展外联。

GitHub

文档

Tomba.io MCP 服务器

一个用于集成 Tomba.io API 的模型上下文协议 (MCP) 服务器。该服务器通过标准化的 MCP 接口提供全面的电子邮件发现、验证和充实功能。

功能特性

工具 (共12个)

域名搜索：查找与某个域名关联的所有电子邮件地址
电子邮件查找器：根据姓名和域名生成可能的电子邮件地址
电子邮件验证器：验证电子邮件的可投递性并检查数据库中的存在情况
电子邮件充实：用额外的联系人数据充实电子邮件
作者查找器：发现文章作者的电子邮件地址
LinkedIn 查找器：从 LinkedIn 个人资料 URL 查找电子邮件
电话查找器：通过电子邮件、域名或 LinkedIn 搜索电话号码
电话验证器：验证电话号码并检查运营商信息
电子邮件计数：获取域名的电子邮件总数
相似域名查找器：基于目标域名查找相似域名
技术查找器：发现网站使用的技术栈
公司搜索：使用自然语言查询和高级筛选器搜索公司

资源 (共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 - 从文章中查找记者联系方式
finder_phone - 查找联系人的电话号码
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+ (全球级)
类型	教育, 政府, 非营利, 私营, 公共, 个人
收入	$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
行业	基于 LinkedIn 行业代码 V2（140+ 个行业，包括计算机软件、金融服务、医院与医疗保健等）

传输选项

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

安装

前提条件

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

截图

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

选项 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-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-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/tomba-contact-intelligence/SKILL.md 的工作区本地 OpenClaw 技能。

该技能旨在帮助 OpenClaw 为联系人发现、公司研究、电子邮件验证、电话查找和潜在客户充实工作流选择合适的 Tomba MCP 工具。

使用方法：

将此仓库作为您的 OpenClaw 工作区打开，或将 skills/tomba-contact-intelligence 目录复制到您的 OpenClaw 技能目录中。
确保 Tomba MCP 服务器已配置并对 OpenClaw 可用。
启动一个新的 OpenClaw 会话以加载该技能。

示例提示词：

"查找 stripe.com 用于合作的最佳联系人，并在返回前验证电子邮件。"
"研究德国的金融科技公司，然后为最佳匹配项确定可能的销售联系人。"
"用电子邮件、电话、公司技术和相似竞争对手充实此潜在客户：[email protected]"

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-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-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-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，请使用包含的调试配置：

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": "[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. 电子邮件查找器

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

{
    "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. 电子邮件验证器

验证电子邮件地址的可投递性并检查数据库中的存在情况。

{
    "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. 电子邮件充实

用额外的联系信息充实电子邮件地址。

{
    "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. 电子邮件计数

获取某个域名的电子邮件地址总数。

{
    "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-mcp-server
尝试清除 npm 缓存：npm cache clean --force

始终下载软件包：

这是使用 -y 标志的正常行为
NPX 在首次下载后缓存软件包
如需永久安装，请使用本地安装方法

身份验证错误

在 https://app.tomba.io/dashboard 验证您的 API 密钥
确保在配置中正确设置了环境变量
检查您的 API 订阅是否处于活动状态

工具无响应

检查您的 Tomba API 速率限制
验证网络连接
查看服务器日志中的错误消息

关于 Tomba

Tomba 成立于 2020 年，以成为全球最可靠、最准确、最深入的电子邮件地址数据源而自豪。我们处理数 TB 的数据来生成我们的电子邮件查找器 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 Server

文档

Tomba.io MCP 服务器

功能特性

工具 (共12个)

资源 (共7个)

提示词 (16个预置工作流)

公司搜索提示词的筛选选项

传输选项

安装

前提条件

截图

选项 1：通过 NPX 安装（推荐）

macOS/Linux

Windows

选项 2：从源代码安装

配置

OpenClaw 技能

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

贡献

许可证

支持