Tomba MCP

官方

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

GitHub

你可以用 Tomba MCP 做什么？

按域名查找电子邮件地址 — 通过 domain_search 查询某公司的所有邮箱，支持分页和筛选。
生成某人的电子邮件 — 使用 email_finder 根据姓名和域名构造可能的地址，然后进行验证。
验证电子邮件的可投递性 — 使用 email_verifier 检查地址的状态、评分以及 MX/SMTP 检查结果。
丰富联系人资料 — 通过 email_enrichment 获取某邮箱的完整详细信息，如职位、LinkedIn 和电话。
发现作者或 LinkedIn 电子邮件 — 通过 author_finder 从文章 URL 提取联系人，或通过 linkedin_finder 从个人资料中提取。
研究公司和技术栈 — 使用带筛选条件的 companies_search、用于查找竞争对手的 similar_finder 以及用于获取技术栈洞察的 technology_finder。

文档

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+（全球性）
类型	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+ 个行业，包括计算机软件、金融服务、医院与医疗保健等）

传输选项

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 技能

此仓库现在包含一个工作区本地的 OpenClaw 技能，位于 skills/tomba-contact-intelligence/SKILL.md。

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

使用方法：

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

示例提示：

“在 stripe.com 找到最适合合作伙伴的联系人，并在返回前验证电子邮件。”
“研究德国的金融科技公司，然后为最匹配的公司确定可能的销售联系人。”
“丰富此潜在客户，包含电子邮件、电话、公司技术栈和类似竞争对手：jane@acme.com”

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

这将打开一个 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": "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 的数据来生成我们的电子邮件查找器 API。

贡献

分叉它（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）
创建一个新的拉取请求

许可证

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

Tomba MCP

你可以用 Tomba MCP 做什么？

文档

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

贡献

许可证

支持