Tomba MCP

公式

Tombaは、ユニークなB2Bメールファインダーおよび検証ツールであり、リーチを簡単かつ効果的に拡大するための独自のリードデータベースを提供します。

GitHub
8
このMCPを試すスポンサー

Tomba MCPで何ができますか？

  • ドメインのメールアドレスを検索 — domain_search を使用して、部署や国などのフィルタを指定し、企業のすべての連絡先を取得します。
  • 個人のメールアドレスを生成 — email_finder を使用して、名前とドメインから可能性のあるアドレスを構築し、それを検証します。
  • メールの到達可能性を検証 — email_verifier を使用して、アドレスが有効で送信しても安全かどうかを確認します。
  • 連絡先プロファイルを補完 — email_enrichment を使用して、メールから役職、会社、ソーシャルリンクを取得します。
  • 企業のテックスタックを発見 — technology_finder を使用して、ウェブサイトが使用しているツールやプラットフォームを特定します。
  • 類似企業を検索 — similar_finder を使用して、見込み客開拓や分析に適した類似ドメインを見つけます。

ドキュメント

Tomba Tomba.io MCPサーバー

Tomba.io APIと統合するためのModel Context Protocol（MCP）サーバーです。このサーバーは、標準化されたMCPインターフェースを通じて、包括的なメールアドレスの発見、検証、エンリッチメント機能を提供します。

特徴

ツール（28個利用可能）

メールアドレス発見

検証

  • メール検証：メールの到達可能性を検証し、データベース内の存在を確認します

エンリッチメント

電話

ドメインインテリジェンス

企業検索

  • 企業検索：高度なフィルターを使用した自然言語クエリで企業を検索します

アカウントと管理

  • アカウント情報：現在のアカウント情報、プラン、クレジットを取得します
  • 使用状況情報：全エンドポイントの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サーバーの速度、ウェブサイトの応答性、キャッチオール検出の深さによって異なります。

指数バックオフ付きリトライ

すべてのAPI呼び出しは、以下の場合に指数バックオフ付きで最大3回自動的にリトライします：

  • 429 Too Many Requests（レート制限超過）
  • 5xxサーバーエラー

リトライ遅延：1秒→2秒→4秒。

レート制限

レート制限はエンドポイントごと、プランごとに適用されます：

プラン毎秒毎分毎日
無料125
ベーシック350500
グロース5801,000
プロ81504,000
50,000+プラン無制限無制限無制限

Tombaが結果を提供できない場合、クレジットは請求されません。30日以内の重複リクエストは再度カウントされません。

トランスポートオプション

  • stdio - 標準入出力（デフォルト、Claude Desktop用）
  • http - RESTエンドポイント付きHTTPサーバー

インストール

前提条件

スクリーンショット

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スキル

このリポジトリには、skills/tomba-contact-intelligence/SKILL.mdにあるワークスペースローカルのOpenClawスキルが含まれています。

このスキルは、連絡先の発見、企業調査、メール検証、電話番号検索、見込み客エンリッチメントのワークフローにおいて、OpenClawが適切なTomba MCPツールを選択するのを支援するように設計されています。

使用方法：

  1. このリポジトリをOpenClawワークスペースとして開くか、skills/tomba-contact-intelligenceディレクトリをOpenClawスキルディレクトリにコピーします。
  2. Tomba MCPサーバーが設定され、OpenClawで利用可能であることを確認します。
  3. スキルが読み込まれるように、新しい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資格情報の取得

  1. https://tomba.ioにアクセス
  2. アカウントにサインアップするか、ログインします
  3. ダッシュボードに移動します
  4. API設定に移動します
  5. 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 - 通知用のServer-Sent Events（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インスペクター（推奨）

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ソースを直接デバッグ
  • インスペクターでのデバッグ：MCPインスペクターでデバッグ
  • テストの実行：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
    }
}

ベストプラクティス

  1. 使用状況の監視: tomba.io/dashboardでダッシュボードを確認
  2. バックオフの実装: 429レスポンスには指数バックオフで対応
  3. バッチ操作: 同じドメインの複数メールにはドメイン検索を使用
  4. 結果のキャッシュ: 重複リクエストを避けるため結果をローカルに保存
  5. 計画的な対応: 使用パターンに基づいてプランをアップグレード

利用のヒント

  • ドメイン検索は1リクエストで複数のメールを返します（個別検索より効率的）
  • メール検証は有効なメール形式の場合のみクレジットを消費します
  • 電話番号検索は1リクエストで複数の番号を返す場合があります
  • エンリッチメントは1リクエストで包括的なデータを提供します

トラブルシューティング

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について

2020年に設立されたTombaは、どこよりも信頼性が高く、正確で、詳細なメールアドレスデータのソースであることを誇りとしています。当社はテラバイト規模のデータを処理してEmail finder APIを提供しています。

image

コントリビューション

  1. フォークする (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. 新しいプルリクエストを作成する

ライセンス

詳細についてはライセンスファイルを参照してください。

サポート