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?

  • Menemukan alamat email berdasarkan domain — Minta untuk mencantumkan semua email untuk sebuah perusahaan melalui domain_search, dengan paginasi dan filter.
  • Membuat email seseorang — Gunakan email_finder untuk menyusun alamat yang mungkin dari nama dan domain, lalu verifikasi.
  • Memverifikasi keterkiriman email — Periksa sebuah alamat dengan email_verifier untuk status, skor, dan pemeriksaan MX/SMTP.
  • Memperkaya profil kontak — Ambil detail lengkap seperti jabatan, LinkedIn, dan telepon untuk sebuah email menggunakan email_enrichment.
  • Menemukan email penulis atau LinkedIn — Ekstrak kontak dari URL artikel melalui author_finder atau dari profil dengan linkedin_finder.
  • Meneliti perusahaan dan tumpukan teknologi — Gunakan companies_search dengan filter, similar_finder untuk pesaing, dan technology_finder untuk wawasan tumpukan.

Dokumentasi

Tomba Tomba.io MCP Server

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

Fitur

Alat (12 tersedia)

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 bawaan)

  • 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
  • finder_phone - 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, tipe, pendapatan, industri)
  • market_research - Riset perusahaan dalam 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
Size1-10 (Mikro), 11-50 (Kecil), 51-250 (Menengah), 251-1K (Menengah-besar), 1K-5K (Besar), 5K-10K (Sangat besar), 10K-50K (Perusahaan), 50K-100K (Sangat besar), 100K+ (Global)
Typeeducation, government, nonprofit, private, public, personal
Revenue$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
IndustryBerdasarkan LinkedIn Industry Codes V2 (140+ industri termasuk Computer Software, Financial Services, Hospital & Health Care, dll.)

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 Tomba API (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. Perbarui konfigurasi Anda sesuai.

Opsi 1: Instal melalui NPX (Disarankan)

Cara termudah untuk menggunakan server Tomba MCP 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

OpenClaw Skill

Repositori ini sekarang menyertakan skill OpenClaw lokal untuk workspace di skills/tomba-contact-intelligence/SKILL.md.

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

Untuk menggunakannya:

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

Contoh prompt:

  • "Temukan kontak terbaik untuk kemitraan di stripe.com dan verifikasi email sebelum Anda mengembalikannya."
  • "Riset perusahaan fintech di Jerman, lalu identifikasi kontak penjualan yang mungkin 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 (Disarankan)

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 Tomba API 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 Tomba API

  1. Kunjungi https://tomba.io
  2. Daftar untuk akun atau masuk
  3. Navigasi ke dasbor Anda
  4. Buka pengaturan API
  5. Salin API Key dan Secret Key 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 Berdiri Sendiri

Anda juga dapat menjalankan server sebagai layanan HTTP berdiri sendiri:

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 - Hentikan 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 (Disarankan)

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:

  • 📋 Lihat semua alat yang tersedia
  • 🧪 Uji alat secara interaktif
  • 📊 Periksa permintaan/respons
  • 🐛 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 MCP Server: Debug JavaScript yang dikompilasi
  • Debug TypeScript: Debug sumber TypeScript secara langsung
  • Debug dengan Inspector: Debug dengan MCP Inspector
  • Jalankan Tes: Debug tes Jest

Lihat DEBUG_GUIDE.md untuk instruksi debugging yang komprehensif.

🧪 Pengujian Alat Individu

1. Domain Search

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. Email Finder

Hasilkan alamat email yang mungkin 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. Email Verifier

Verifikasi keterkiriman alamat email dan periksa keberadaan 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. Email Enrichment

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. Author Finder

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. LinkedIn Finder

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. Phone Finder

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. Phone Validator

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. Email Count

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. Similar Finder

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. Technology Finder

Langsung ungkapkan tumpukan teknologi dari situs web mana pun.

{
    "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. Companies Search

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 LinkedIn Industry Codes V2 - 140+ industri)
  • type: Filter berdasarkan tipe 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 kisaran 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

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 Bijak: 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
  • Pengayaan menyediakan data komprehensif dalam satu permintaan

Pemecahan Masalah

Server Tidak Menyala 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 menjalankan pertama kali
    • Bendera -y seharusnya menerima pemasangan 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 terinstal: npm --version
  • NPX hadir 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 bendera -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 bahwa 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

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 berkas Lisensi untuk informasi lebih lanjut.

Dukungan