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
Coba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Tomba MCP?

  • Menemukan alamat email untuk sebuah domain — Minta semua kontak di sebuah perusahaan melalui domain_search, dengan filter seperti departemen atau negara.
  • Membuat email seseorang — Gunakan email_finder untuk menyusun alamat yang mungkin dari nama dan domain, lalu verifikasi.
  • Memverifikasi keterkiriman email — Periksa apakah sebuah alamat valid dan aman untuk dikirim menggunakan email_verifier.
  • Memperkaya profil kontak — Ambil jabatan, perusahaan, dan tautan sosial untuk sebuah email dengan email_enrichment.
  • Menemukan tumpukan teknologi perusahaan — Identifikasi alat dan platform yang digunakan sebuah situs web melalui technology_finder.
  • Menemukan perusahaan serupa — Gunakan similar_finder untuk menemukan domain yang sebanding untuk prospek atau analisis.

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

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

Pengayaan

Telepon

Intelijen Domain

  • Status Domain: Periksa apakah domain adalah webmail atau sekali pakai
  • Lengkapi Otomatis: Saran nama perusahaan dengan logo dan info domain
  • Pencari Serupa: Temukan domain serupa berdasarkan domain target
  • Pencari Teknologi: Temukan tumpukan teknologi yang digunakan oleh situs web
  • Lokasi: Dapatkan jumlah lokasi karyawan berdasarkan negara

Pencarian Perusahaan

Akun & Manajemen

  • Info Akun: Dapatkan informasi akun saat ini, paket, dan kredit
  • Info Penggunaan: Dapatkan statistik penggunaan API di semua endpoint
  • Daftar Bendera: Daftar bendera data yang dikirim dengan status dan pengembalian kredit
  • Buat Bendera: Laporkan data yang salah (hard bounce, email tidak valid) untuk pemulihan kredit
  • Daftar Prospek: Daftar prospek dengan filter domain opsional
  • Buat Prospek: Tambahkan prospek baru ke daftar
  • Daftar Kunci: Daftar kunci API
  • Dapatkan Log: Dapatkan log permintaan API terbaru

Sumber Daya (7 tersedia)

  • tomba://api/status - Status API dan info 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 info 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 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 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 (Perusahaan), 50K-100K (Masif), 100K+ (Global)
Jenispendidikan, pemerintah, nirlaba, swasta, publik, pribadi
Pendapatan$0-$1J, $1J-$10J, $10J-$50J, $50J-$100J, $100J-$250J, $250J-$500J, $500J-$1M, $1M-$10M, $10M+
IndustriBerdasarkan Kode Industri LinkedIn V2 (140+ industri termasuk Perangkat Lunak Komputer, Layanan Keuangan, Rumah Sakit & Perawatan Kesehatan, dll.)

Kinerja & 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 secara 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
Dasar350500
Pertumbuhan5801.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 Anda (~/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 Anda (%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 sekarang menyertakan keterampilan OpenClaw lokal ruang kerja di skills/tomba-contact-intelligence/SKILL.md.

Keterampilan ini dirancang untuk membantu OpenClaw memilih alat MCP Tomba yang tepat untuk penemuan kontak, riset perusahaan, verifikasi email, pencarian telepon, dan alur kerja pengayaan prospek.

Untuk menggunakannya:

  1. Buka repositori ini sebagai ruang kerja OpenClaw Anda, atau salin direktori skills/tomba-contact-intelligence ke direktori keterampilan OpenClaw Anda.
  2. Pastikan server MCP Tomba 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 email sebelum Anda mengembalikannya."
  • "Riset perusahaan fintech di Jerman, lalu identifikasi kemungkinan kontak penjualan untuk kecocokan teratas."
  • "Perkaya prospek ini dengan email, telepon, teknologi perusahaan, dan pesaing serupa: jane@acme.com"

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 diterbitkan:

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 Transportasi HTTP

Untuk transportasi 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 transportasi 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 Mandiri

Anda juga dapat menjalankan server sebagai layanan HTTP mandiri:

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

Inspektur MCP (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 Debug 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 Server MCP: Debug JavaScript yang dikompilasi
  • Debug TypeScript: Debug sumber TypeScript secara langsung
  • Debug dengan Inspektur: Debug dengan Inspektur MCP
  • Jalankan Tes: 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 Domain 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

Temukan tumpukan teknologi dari situs web mana 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 include/exclude
  • location_state: Filter berdasarkan negara bagian dengan array include/exclude
  • location_country: Filter berdasarkan negara dengan array include/exclude
  • industry: Filter berdasarkan industri (berdasarkan Kode Industri LinkedIn 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 include/exclude
  • keywords: Filter berdasarkan kata kunci dengan array include/exclude
  • sic: Filter berdasarkan kode SIC dengan array include/exclude
  • naics: Filter berdasarkan kode NAICS dengan array include/exclude
  • similar: Filter berdasarkan domain serupa dengan array include/exclude

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

Saat 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 komprehensif 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 harus menerima instalasi secara otomatis
    • NPX akan menyimpan paket dalam cache 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 terinstal: npm --version
  • NPX tersedia dengan npm 5.2.0+, perbarui jika perlu: npm install -g npm

Paket tidak ditemukan:

  • Verifikasi paket telah 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 paket dalam cache 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 laju 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

Kontribusi

  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