Tomba MCP

resmi

Tomba, pencari dan pemverifikasi email B2B unik Anda, menyediakan basis data prospek yang khas untuk memperluas jangkauan secara mudah dan efektif.

GitHub
8

Apa yang bisa Anda lakukan dengan Tomba MCP?

  • Temukan email kontak — Minta semua alamat email yang terkait dengan domain melalui domain_search, dengan filter seperti departemen atau negara.
  • Hasilkan alamat yang mungkin — Gunakan email_finder untuk menyusun email yang mungkin dari nama seseorang dan domain perusahaan.
  • Verifikasi keterkiriman — Periksa apakah email valid dan dapat dikirim dengan email_verifier, termasuk pemeriksaan SMTP dan MX.
  • Perkaya data kontak — Tarik profil terperinci (nama, posisi, media sosial) untuk email yang diketahui menggunakan email_enrichment.
  • Temukan email penulis — Ekstrak email penulis artikel dari URL dengan author_finder.

Dokumentasi

Tomba Server MCP Tomba.io

Server Model Context Protocol (MCP) untuk integrasi dengan API Tomba.io. Server ini menyediakan kemampuan penemuan email, verifikasi, dan pengayaan yang komprehensif melalui antarmuka MCP yang terstandarisasi.

Fitur

Alat (28 tersedia)

Penemuan Email

Verifikasi

  • Email Verifier: Verifikasi keterkiriman email dan periksa keberadaan di database

Pengayaan

Telepon

  • Phone Finder: Cari nomor telepon berdasarkan email, domain, atau LinkedIn
  • Phone Validator: Validasi nomor telepon dan periksa informasi operator

Intelijen Domain

  • Domain Status: Periksa apakah sebuah domain adalah webmail atau sekali pakai
  • Autocomplete: Saran nama perusahaan dengan logo dan informasi domain
  • Similar Finder: Temukan domain serupa berdasarkan domain target
  • Technology Finder: Temukan tumpukan teknologi yang digunakan oleh situs web
  • Location: Dapatkan jumlah lokasi karyawan berdasarkan negara

Pencarian Perusahaan

  • Companies Search: Cari perusahaan menggunakan kueri bahasa alami dengan filter lanjutan

Akun & Manajemen

  • Account Info: Dapatkan informasi akun saat ini, paket, dan kredit
  • Usage Info: Dapatkan statistik penggunaan API di semua endpoint
  • List Flags: Daftarkan flag data yang dikirim dengan status dan pengembalian kredit
  • Create Flag: Laporkan data yang salah (hard bounce, email tidak valid) untuk pemulihan kredit
  • List Leads: Daftarkan prospek dengan filter domain opsional
  • Create Lead: Tambahkan prospek baru ke daftar
  • List Keys: Daftarkan kunci API
  • Get Logs: Dapatkan log permintaan API terbaru

Sumber Daya (7 tersedia)

  • tomba://api/status - Status API dan informasi akun
  • tomba://domain/{domain} - Informasi domain
  • tomba://email/{email} - Informasi email
  • tomba://similar/{domain} - Analisis domain serupa
  • tomba://technology/{domain} - Informasi tumpukan teknologi
  • tomba://docs/api - Dokumentasi API
  • tomba://docs/tools - Dokumentasi alat

Prompt (16 alur kerja siap pakai)

  • find_contact - Temukan informasi kontak lengkap untuk seseorang
  • verify_email_list - Verifikasi alamat email secara batch
  • research_company - Riset kontak dan struktur perusahaan
  • enrich_lead - Perkaya prospek dengan semua data yang tersedia
  • find_journalists - Temukan kontak jurnalis dari artikel
  • phone_finder - Temukan nomor telepon untuk kontak
  • validate_phone - Validasi nomor telepon
  • competitor_analysis - Analisis pesaing menggunakan domain serupa dan teknologi
  • technology_audit - Audit teknologi komprehensif dari sebuah situs web
  • domain_insights - Dapatkan wawasan komprehensif tentang sebuah domain termasuk jumlah email dan teknologi
  • bulk_domain_research - Riset beberapa domain untuk jumlah email dan informasi dasar
  • find_target_companies - Temukan perusahaan dengan filter lanjutan (ukuran, jenis, pendapatan, industri)
  • market_research - Riset perusahaan di segmen pasar dengan penyaringan komprehensif
  • lead_generation - Hasilkan prospek dengan menemukan perusahaan dan kontaknya
  • prospect_enrichment - Perkaya prospek perusahaan dengan data komprehensif
  • industry_analysis - Analisis perusahaan dalam sebuah industri dengan segmentasi terperinci

Opsi Filter untuk Prompt Pencarian Perusahaan

FilterNilai yang Tersedia
Ukuran1-10 (Mikro), 11-50 (Kecil), 51-250 (Menengah), 251-1K (Menengah-besar), 1K-5K (Besar), 5K-10K (Sangat besar), 10K-50K (Enterprise), 50K-100K (Masif), 100K+ (Global)
Jeniseducation, government, nonprofit, private, public, personal
Pendapatan$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
IndustriBerdasarkan Kode Industri LinkedIn V2 (140+ industri termasuk Computer Software, Financial Services, Hospital & Health Care, dll.)

Performa & Keandalan

Batas Waktu

Semua panggilan API memiliki batas waktu 120 detik. Pencarian Tomba berjalan secara real-time terhadap infrastruktur langsung — waktu respons bervariasi tergantung pada kecepatan server SMTP perusahaan target, responsivitas situs web, dan kedalaman deteksi catch-all.

Coba Ulang dengan Backoff Eksponensial

Semua panggilan API otomatis mencoba ulang hingga 3 kali dengan backoff eksponensial pada:

  • 429 Too Many Requests (batas kecepatan terlampaui)
  • 5xx kesalahan server

Penundaan coba ulang: 1 detik → 2 detik → 4 detik.

Batas Kecepatan

Batas kecepatan diberlakukan per endpoint dan per paket:

PaketPer DetikPer MenitPer Hari
Gratis125
Basic350500
Growth5801.000
Pro81504.000
Paket 50.000+Tanpa BatasTanpa BatasTanpa Batas

Tidak ada kredit yang dikenakan ketika Tomba tidak dapat memberikan hasil. Permintaan duplikat dalam 30 hari tidak dihitung lagi.

Opsi Transportasi

  • stdio - Input/output standar (default, untuk Claude Desktop)
  • http - Server HTTP dengan endpoint REST

Instalasi

Prasyarat

  • Node.js 18 atau lebih tinggi
  • npm atau yarn
  • Akun API Tomba (Daftar di sini)

Tangkapan Layar

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Catatan: Paket npm telah diubah namanya dari tomba-mcp-server menjadi @tomba-io/tomba-mcp-server. Harap perbarui konfigurasi Anda sesuai.

Opsi 1: Instal melalui NPX (Direkomendasikan)

Cara termudah untuk menggunakan server MCP Tomba adalah melalui npx, yang tidak memerlukan kloning repositori:

macOS/Linux

Tambahkan ke 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

Tambahkan ke 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"
            }
        }
    }
}

Catatan: Bendera -y secara otomatis menerima prompt instalasi, dan npx akan selalu mengambil versi terbaru.

Opsi 2: Instal dari Sumber

Jika Anda ingin memodifikasi server atau berkontribusi pada pengembangan:

# 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

Konfigurasi

Keterampilan OpenClaw

Repositori ini menyertakan keterampilan lokal workspace di skills/. Plugin Cursor (.cursor-plugin/plugin.json) juga memuatnya.

skills/tomba-contact-intelligence/SKILL.md adalah keterampilan utama. Ini membantu agen memilih alat MCP Tomba yang tepat untuk penemuan kontak, riset perusahaan, verifikasi email, pencarian telepon, dan alur kerja pengayaan prospek.

Setiap alat MCP juga memiliki folder keterampilan sendiri, skills/tomba-<tool-name>/SKILL.md. Masing-masing mencakup input alat, alur kerja, output yang diharapkan, dan contoh panggilan:

GrupKeterampilan
Emailtomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
Discoverytomba-domain-search, tomba-author-finder, tomba-linkedin-finder
Telepontomba-phone-finder, tomba-phone-validator
Perusahaantomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
Pengayaantomba-person-enrichment, tomba-combined-enrichment
Prospektomba-list-leads, tomba-create-lead
Kualitas datatomba-list-flags, tomba-create-flag
Akuntomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

Cara menggunakannya:

  1. Buka repositori ini sebagai workspace OpenClaw Anda, atau salin direktori skills/tomba-* yang Anda perlukan ke direktori keterampilan OpenClaw Anda.
  2. Pastikan server MCP Tomba sudah dikonfigurasi dan tersedia untuk OpenClaw.
  3. Mulai sesi OpenClaw baru agar keterampilan dimuat.

Contoh prompt:

  • "Temukan kontak terbaik untuk kemitraan di stripe.com dan verifikasi emailnya sebelum Anda mengembalikannya."
  • "Riset perusahaan fintech di Jerman, lalu identifikasi kontak penjualan yang mungkin untuk hasil teratas."
  • "Perkaya prospek ini dengan email, telepon, teknologi perusahaan, dan pesaing serupa: jane@acme.com"

Plugin Claude Code

Repositori ini juga merupakan marketplace plugin Claude Code (.claude-plugin/). Plugin ini menggabungkan setiap keterampilan di skills/ dan terhubung ke server MCP yang di-hosting di https://mcp.tomba.io/mcp:

/plugin marketplace add tomba-io/tomba-mcp-server
/plugin install tomba@tomba

Kemudian jalankan /mcp dan autentikasi server tomba dengan OAuth. Tidak diperlukan kunci API. Keterampilan plugin diberi namespace, misalnya /tomba:tomba-domain-search zapier.com.

Plugin Codex

.codex-plugin/plugin.json mengemas keterampilan yang sama untuk OpenAI Codex. Plugin ini memuat server jarak jauh dari .mcp.json. Setelah menginstal plugin, masuk dengan OAuth:

codex mcp login tomba

Untuk menggunakan kunci API alih-alih OAuth, kirim header X-Tomba-Key dan X-Tomba-Secret, atau Authorization: Bearer <base64(ta_key:ts_secret)>, ke https://mcp.tomba.io/mcp.

Pengaturan Claude Desktop

Untuk menggunakan server ini dengan Claude Desktop, tambahkan konfigurasi ke file claude_desktop_config.json Anda.

Menggunakan NPX (Direkomendasikan)

Metode ini secara otomatis menggunakan versi terbaru yang dipublikasikan:

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"
            }
        }
    }
}

Menggunakan Instalasi Lokal

Jika Anda membangun dari sumber, gunakan jalur absolut ke instalasi Anda:

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"
            }
        }
    }
}

Catatan Penting:

  • Ganti your-api-key-here dan your-secret-key-here dengan kredensial API Tomba Anda yang sebenarnya
  • Untuk instalasi lokal, ganti /ABSOLUTE/PATH/TO/tomba-mcp-server dengan jalur lengkap ke direktori instalasi Anda
  • Mulai ulang Claude Desktop setelah memperbarui konfigurasi

Mendapatkan Kredensial API Tomba

  1. Kunjungi https://tomba.io
  2. Daftar untuk akun atau masuk
  3. Navigasikan ke dasbor Anda
  4. Buka pengaturan API
  5. Salin Kunci API dan Kunci Rahasia Anda

Alternatif: Menggunakan Transport HTTP

Untuk transport HTTP dengan npx:

{
    "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"
            }
        }
    }
}

Untuk transport HTTP dengan instalasi lokal:

{
    "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"
            }
        }
    }
}

Penggunaan

Opsi Baris Perintah

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

Server HTTP Standalone

Anda juga dapat menjalankan server sebagai layanan HTTP standalone:

export TOMBA_API_KEY="your-api-key"
export TOMBA_SECRET_KEY="your-secret-key"
node server/index.js --transport http --port 3000

Endpoint API HTTP

  • POST /mcp - Kirim permintaan JSON-RPC
  • GET /mcp - Server-Sent Events untuk notifikasi (memerlukan header X-Session-Id)
  • DELETE /mcp - Akhiri sesi (memerlukan header X-Session-Id)
  • GET /health - Endpoint pemeriksaan kesehatan
  • GET /sessions - Daftar sesi aktif (memerlukan autentikasi)

Contoh Permintaan 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
  }'

🔧 Pengembangan

Perintah Pengembangan

# 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

🔍 Debugging & Pengujian

MCP Inspector (Direkomendasikan)

Cara termudah untuk menguji dan men-debug server MCP Anda:

# Build and launch MCP Inspector
yarn debug

Ini membuka antarmuka web di mana Anda dapat:

  • 📋 Melihat semua alat yang tersedia
  • 🧪 Menguji alat secara interaktif
  • 📊 Memeriksa permintaan/respons
  • 🐛 Men-debug secara real-time

Metode Debugging Alternatif

# 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

Debugging VS Code

Jika menggunakan VS Code, gunakan konfigurasi debug yang disertakan:

  • Debug MCP Server: Debug JavaScript yang dikompilasi
  • Debug TypeScript: Debug sumber TypeScript secara langsung
  • Debug with Inspector: Debug dengan MCP Inspector
  • Run Tests: Debug tes Jest

Lihat DEBUG_GUIDE.md untuk instruksi debugging yang komprehensif.

🧪 Menguji Alat Individual

1. Pencarian Domain

Cari alamat email yang terkait dengan nama domain.

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

Respons:

{
  "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. Pencari Email

Hasilkan kemungkinan alamat email dari domain, nama depan, dan nama belakang.

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

Respons:

{
    "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. Verifikator Email

Verifikasi keterkiriman alamat email dan periksa keberadaan di database.

{
    "name": "email_verifier",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Respons:

{
    "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. Pengayaan Email

Perkaya alamat email dengan informasi kontak tambahan.

{
    "name": "email_enrichment",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Respons:

{
    "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. Pencari Penulis

Temukan alamat email penulis artikel dari URL.

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

Respons:

{
    "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. Pencari LinkedIn

Temukan alamat email dari URL profil LinkedIn.

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

Respons:

{
    "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. Pencari Telepon

Cari nomor telepon berdasarkan email, domain, atau profil LinkedIn.

{
    "name": "phone_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Respons:

{
    "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. Validator Telepon

Validasi nomor telepon dan periksa informasi operator.

{
    "name": "phone_validator",
    "arguments": {
        "phone": "+213667945402"
    }
}

Respons:

{
    "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. Jumlah Email

Dapatkan jumlah total alamat email untuk sebuah domain.

{
    "name": "email_count",
    "arguments": {
        "domain": "tomba.io"
    }
}

Respons:

{
    "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. Pencari Serupa

Temukan domain serupa berdasarkan domain tertentu.

{
    "name": "similar_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Respons:

{
    "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. Pencari Teknologi

Ungkapkan tumpukan teknologi situs web apa pun secara instan.

{
    "name": "technology_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Respons:

{
    "domain": "tomba.io",
    "data": [
        {
            "slug": "intercom",
            "name": "Intercom",
            "icon": "Intercom.png",
            "website": "https://www.intercom.com",
            "categories": {
                "id": 10,
                "slug": "analytics",
                "name": "Analytics"
            }
        }
    ]
}

12. Pencarian Perusahaan

Cari perusahaan menggunakan kueri bahasa alami dengan filter lanjutan termasuk lokasi, industri, ukuran, dan pendapatan.

{
    "name": "companies_search",
    "arguments": {
        "filters": {
            "location_city": {
                "include": ["san francisco"]
            },
            "industry": {
                "include": ["technology"]
            },
            "size": {
                "include": ["51-200", "201-500"]
            }
        },
        "page": 1,
        "limit": 10
    }
}

Respons:

{
    "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
    }
}

Filter yang Tersedia:

  • location_city: Filter berdasarkan kota dengan array sertakan/kecualikan
  • location_state: Filter berdasarkan negara bagian dengan array sertakan/kecualikan
  • location_country: Filter berdasarkan negara dengan array sertakan/kecualikan
  • industry: Filter berdasarkan industri (berdasarkan LinkedIn Industry Codes V2 - 140+ industri)
  • type: Filter berdasarkan jenis perusahaan: education, government, nonprofit, private, public, personal
  • size: Filter berdasarkan ukuran perusahaan: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Filter berdasarkan rentang pendapatan: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Filter berdasarkan tahun pendirian dengan array sertakan/kecualikan
  • keywords: Filter berdasarkan kata kunci dengan array sertakan/kecualikan
  • sic: Filter berdasarkan kode SIC dengan array sertakan/kecualikan
  • naics: Filter berdasarkan kode NAICS dengan array sertakan/kecualikan
  • similar: Filter berdasarkan domain serupa dengan array sertakan/kecualikan

Pembatasan Laju & Penggunaan

Batas Laju API

Tomba.io menerapkan pembatasan laju berdasarkan paket langganan Anda:

  • Paket Gratis: 50 permintaan per bulan
  • Paket Growth: 5.000 permintaan per bulan + 10.000 permintaan verifikasi
  • Paket Pro: 10.000 permintaan per bulan
  • Paket Enterprise: 50.000 permintaan per bulan
  • Paket Kustom: Batas kustom

Pelajari lebih lanjut tentang Paket Harga Tomba.

Header Batas Laju

Setiap respons API menyertakan informasi batas laju:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

Pelajari lebih lanjut tentang Batas Laju API Tomba.

Menangani Batas Laju

Ketika Anda melebihi batas laju, API mengembalikan status 429 Too Many Requests dengan:

{
    "error": {
        "type": "rate_limit",
        "message": "Rate limit exceeded. Please try again in 60 seconds",
        "code": 429
    }
}

Praktik Terbaik

  1. Pantau Penggunaan: Periksa dasbor Anda di tomba.io/dashboard
  2. Terapkan Backoff: Tangani respons 429 dengan backoff eksponensial
  3. Operasi Batch: Gunakan pencarian domain untuk beberapa email dari domain yang sama
  4. Cache Hasil: Simpan hasil secara lokal untuk menghindari permintaan duplikat
  5. Rencanakan dengan Baik: Tingkatkan paket Anda berdasarkan pola penggunaan

Tips Penggunaan

  • Pencarian domain mengembalikan beberapa email per permintaan (lebih efisien daripada pencarian individual)
  • Verifikasi email hanya menghabiskan kredit untuk format email yang valid
  • Pencari telepon dapat mengembalikan beberapa nomor per permintaan
  • Enrichment menyediakan data lengkap dalam satu permintaan

Pemecahan Masalah

Server Tidak Berjalan di Claude Desktop

  1. Periksa versi Node.js: Pastikan Anda memiliki Node.js 18 atau lebih tinggi

    node --version

  2. Menggunakan NPX:

    • Pastikan Anda memiliki koneksi internet yang stabil untuk pertama kali dijalankan
    • Flag -y seharusnya menerima instalasi secara otomatis
    • NPX akan menyimpan cache paket setelah penggunaan pertama

  3. Menggunakan Instalasi Lokal:

    • Verifikasi jalur absolut sudah benar di konfigurasi Anda
    • Pastikan server/index.js ada: ls -la server/index.js
    • Pastikan Anda menjalankan yarn build dengan sukses

  4. Verifikasi kredensial API: Pastikan kunci API Tomba Anda benar

  5. Periksa log Claude:

    • macOS: ~/Library/Logs/Claude/mcp*.log
    • Windows: %APPDATA%\Claude\logs\mcp*.log

Masalah Khusus NPX

"perintah npx tidak ditemukan":

  • Pastikan npm sudah terinstal: npm --version
  • NPX tersedia dengan npm 5.2.0+, perbarui jika diperlukan: npm install -g npm

Paket tidak ditemukan:

  • Verifikasi paket sudah dipublikasikan: npm view @tomba-io/tomba-mcp-server
  • Coba bersihkan cache npm: npm cache clean --force

Selalu mengunduh paket:

  • Ini adalah perilaku normal dengan flag -y
  • NPX menyimpan cache paket setelah unduhan pertama
  • Untuk instalasi permanen, gunakan metode instalasi lokal

Kesalahan Autentikasi

  • Verifikasi kunci API Anda di https://app.tomba.io/dashboard
  • Pastikan variabel lingkungan diatur dengan benar di konfigurasi
  • Periksa apakah langganan API Anda aktif

Alat Tidak Merespons

  • Periksa batas kecepatan API Tomba Anda
  • Verifikasi konektivitas jaringan
  • Tinjau log server untuk pesan kesalahan

Tentang Tomba

Didirikan pada tahun 2020, Tomba bangga menjadi sumber data alamat email yang paling andal, akurat, dan mendalam yang tersedia di mana pun. Kami memproses terabyte data untuk menghasilkan API Pencari Email kami.

image

Berkontribusi

  1. Fork repositori (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Buat cabang fitur Anda (git checkout -b my-new-feature)
  3. Komit perubahan Anda (git commit -am 'Add some feature')
  4. Dorong ke cabang (git push origin my-new-feature)
  5. Buat Pull Request baru

Lisensi

Silakan lihat file Lisensi untuk informasi lebih lanjut.

Dukungan