Tomba MCP Server

Tomba.io MCP Server

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

機能

ツール（28 種類）

メールアドレスの検索

• Domain Search：ドメインに関連付けられたすべてのメールアドレスを検索します
• Email Finder：氏名とドメインから、可能性の高いメールアドレスを生成します
• Author Finder：記事の著者のメールアドレスを検索します
• LinkedIn Finder：LinkedIn プロフィール URL からメールアドレスを検索します
• Email Count：ドメインのメールアドレス総数を取得します
• Email Sources：ウェブ上でメールアドレスが見つかった場所を検索します
• Email Format：ドメインで使用されているメールアドレス形式のパターンを取得します

検証

• Email Verifier：メールの配信可能性を検証し、データベースに登録されているかを確認します

エンリッチメント

• Email Enrichment：メールアドレスに連絡先データを追加します
• Person Enrichment：メールアドレスから人物データ（氏名、役職、ソーシャルプロフィール）を検索します
• Company Enrichment：ドメインから企業データ（業種、規模、所在地）を検索します
• Combined Enrichment：メールアドレスから人物情報と企業情報をまとめてエンリッチメントします

電話番号

• Phone Finder：メールアドレス、ドメイン、LinkedIn から電話番号を検索します
• Phone Validator：電話番号を検証し、通信事業者の情報を確認します

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

• Domain Status：ドメインがウェブメール用か使い捨て用かを確認します
• Autocomplete：ロゴとドメイン情報を含む企業名の候補を提示します
• Similar Finder：指定したドメインに類似するドメインを検索します
• Technology Finder：ウェブサイトで使用されている技術スタックを特定します
• Location：国別の従業員数を取得します

企業検索

• Companies Search：高度なフィルターを使い、自然言語のクエリで企業を検索します

アカウントと管理

• Account Info：現在のアカウント情報、プラン、クレジットを取得します
• Usage Info：すべてのエンドポイントの API 使用統計を取得します
• List Flags：送信されたデータフラグを、ステータスとクレジット返還情報とともに一覧表示します
• Create Flag：誤ったデータ（恒久的なバウンス、無効なメールアドレス）を報告し、クレジットの回復を申請します
• List Leads：任意のドメインフィルターを指定してリードを一覧表示します
• Create Lead：リストに新しいリードを追加します
• List Keys：API キーを一覧表示します
• Get Logs：最近の API リクエストログを取得します

リソース（7 種類）

• tomba://api/status - API のステータスとアカウント情報
• tomba://domain/{domain} - ドメイン情報
• tomba://email/{email} - メールアドレス情報
• tomba://similar/{domain} - 類似ドメインの分析
• tomba://technology/{domain} - 技術スタック情報
• tomba://docs/api - API ドキュメント
• tomba://docs/tools - ツールドキュメント

プロンプト（事前構築済みのワークフロー 16 種）

• find_contact - 人物の連絡先情報をすべて取得
• verify_email_list - メールアドレスを一括検証
• research_company - 企業の連絡先と組織構造を調査
• enrich_lead - 利用可能なすべてのデータでリードを拡充
• find_journalists - 記事からジャーナリストの連絡先を検索
• phone_finder - 連絡先の電話番号を検索
• validate_phone - 電話番号を検証
• competitor_analysis - 類似ドメインとテクノロジーを使って競合他社を分析
• technology_audit - Web サイトの包括的なテクノロジー監査
• 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 Industry Codes V2 に基づく（コンピューターソフトウェア、金融サービス、病院・医療など、140 以上の業界）

パフォーマンスと信頼性

タイムアウト

すべての API 呼び出しには120 秒のタイムアウトが設定されています。Tomba の検索は稼働中のインフラストラクチャを対象にリアルタイムで実行されます。応答時間は、対象企業の SMTP サーバーの速度、Web サイトの応答性、キャッチオール検出の深度によって異なります。

指数バックオフによる再試行

次の場合、すべての API 呼び出しは指数バックオフを使用して自動的に最大3 回再試行されます。

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

再試行の間隔：1 秒 → 2 秒 → 4 秒。

レート制限

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

プラン	1 秒あたり	1 分あたり	1 日あたり
無料	1	2	5
ベーシック	3	50	500
グロース	5	80	1,000
プロ	8	150	4,000
50,000+ プラン	無制限	無制限	無制限

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

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

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

インストール

前提条件

• Node.js 18 以降
• npm または yarn
• Tomba API アカウント（こちらから登録）

スクリーンショット

Note: 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 はメインスキルです。連絡先の発見、企業調査、メールアドレスの検証、電話番号の検索、見込み客情報の充実化のワークフローに適した 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 Plugin

このリポジトリは 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 Plugin

.codex-plugin/plugin.json は、同じスキルを OpenAI Codex 用にパッケージ化します。リモートサーバーは .mcp.json から読み込まれます。プラグインをインストールした後、OAuth でサインインします：

codex mcp login tomba

OAuth の代わりに API キーを使用するには、X-Tomba-Key ヘッダーと X-Tomba-Secret ヘッダー、または Authorization: Bearer <base64(ta_key:ts_secret)> を https://mcp.tomba.io/mcp に送信します。

Claude Desktop の設定

Claude Desktop でこのサーバーを使用するには、設定を claude_desktop_config.json ファイルに追加します。

NPX を使用する場合（推奨）

この方法では、公開済みの最新バージョンが自動的に使用されます：

macOS/Linux（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows（%APPDATA%\Claude\claude_desktop_config.json）：

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

ローカルインストールを使用する場合

ソースからビルドした場合は、インストール先の絶対パスを使用します：

macOS/Linux：

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows：

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "C:\\ABSOLUTE\\PATH\\TO\\tomba-mcp-server\\server\\index.js"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

重要な注意事項：

• your-api-key-here と your-secret-key-here を、実際の Tomba API 認証情報に置き換えます
• ローカルインストールの場合は、/ABSOLUTE/PATH/TO/tomba-mcp-server をインストールディレクトリの完全なパスに置き換えます
• 設定を更新した後、Claude Desktop を再起動します

Tomba API 認証情報の取得

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 - 通知用の 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 Inspector（推奨）

MCP サーバーをテストおよびデバッグする最も簡単な方法です：

# Build and launch MCP Inspector
yarn debug

次の操作ができるウェブインターフェースが開きます：

• 📋 利用可能なすべてのツールを表示
• 🧪 ツールを対話的にテスト
• 📊 リクエストとレスポンスを確認
• 🐛 リアルタイムでデバッグ

別のデバッグ方法

# Debug TypeScript directly
yarn debug:dev

# Run integration tests
yarn test:integration

# Manual testing
yarn build
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node server/index.js

VS Code でのデバッグ

VS Code を使用する場合は、付属のデバッグ設定を使用します：

• Debug MCP Server：コンパイル済み JavaScript をデバッグします
• Debug TypeScript：TypeScript ソースを直接デバッグします
• Debug with Inspector：MCP Inspector を使用してデバッグします
• Run Tests：Jest のテストをデバッグします

デバッグ手順の詳細は DEBUG_GUIDE.md を参照してください。

🧪 個別のツールをテストする

1. ドメイン検索

ドメイン名に関連付けられたメールアドレスを検索します。

{
    "name": "domain_search",
    "arguments": {
        "domain": "tomba.io",
        "limit": 10,
        "page": 1
    }
}

レスポンス：

{
  "data": {
    "organization": {
      "website_url": "tomba.io",
      "organization": "Tomba technology web service LLC",
      "location": {
        "country": "US",
        "city": "Claymont",
        "state": "Delaware",
        "street_address": "1228 claymont",
        "postal_code": "19703"
      },
      "social_links": {
        "twitter_url": "https://twitter.com/tombaplatforum",
        "facebook_url": "https://www.facebook.com/tombaplatforum",
        "linkedin_url": "https://www.linkedin.com/company/tomba-io"
      },
      "disposable": false,
      "webmail": false,
      "phone_number": "(850) 790-5575",
      "industries": "Information Technology and Services",
      "founded": "2021",
      "company_size": "1-10",
      "company_type": "privately held",
      "revenue": "$0-$1M",
      "accept_all": false,
      "description": "the most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.",
      "pattern": "{l}.{first}",
      "total_similar": 35,
      "keywords": [
        "lead generation software"
      ],
      "ranking": 661495,
      "whois": {
        "registrar_name": "namecheap, inc.",
        "created_date": "2020-07-07T20:54:07+02:00",
        "referral_url": "https://www.namecheap.com/"
      },
      "last_updated": "2025-09-06T00:22:01+02:00"
    },
    "emails": [
      {
        "email": "[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：include／exclude 配列を使って都市で絞り込みます
• location_state：include／exclude 配列を使って州で絞り込みます
• location_country：include／exclude 配列を使って国で絞り込みます
• 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：include／exclude 配列を使って設立年で絞り込みます
• keywords：include／exclude 配列を使ってキーワードで絞り込みます
• sic：include／exclude 配列を使って SIC コードで絞り込みます
• naics：include／exclude 配列を使って NAICS コードで絞り込みます
• similar：include／exclude 配列を使って類似ドメインで絞り込みます

レート制限と使用方法

API レート制限

Tomba.io は、サブスクリプションプランに基づいてレート制限を適用します。

• Free プラン：月 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. 計画的に利用する：使用状況に応じてプランをアップグレードします

使用のヒント

• ドメイン検索は 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 command not found」：

• 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 を提供するため、テラバイト単位のデータを処理しています。

コントリビュート

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. 新しい Pull Request を作成します。

ライセンス

詳しくは License ファイルをご覧ください。

サポート

• GitHub Issues
• メールサポート
• ウェブサイト