Tomba MCP

आधिकारिक

टोम्बा, आपका अनोखा B2B ईमेल फाइंडर और वेरिफायर, सहज और प्रभावी आउटरीच स्केलिंग के लिए एक विशिष्ट लीड डेटाबेस प्रदान करता है।

GitHub
8

Tomba MCP के साथ आप क्या कर सकते हैं?

  • संपर्क ईमेल खोजें — domain_search के माध्यम से किसी डोमेन से जुड़े सभी ईमेल पते मांगें, जिसमें विभाग या देश जैसे फ़िल्टर शामिल हों।
  • संभावित पते उत्पन्न करें — email_finder का उपयोग करके किसी व्यक्ति के नाम और कंपनी डोमेन से संभावित ईमेल बनाएं।
  • डिलिवरेबिलिटी सत्यापित करें — email_verifier से जांचें कि ईमेल मान्य और डिलिवरेबल है या नहीं, जिसमें SMTP और MX जांच शामिल हैं।
  • संपर्क डेटा समृद्ध करें — email_enrichment का उपयोग करके ज्ञात ईमेल के लिए विस्तृत प्रोफ़ाइल (नाम, पद, सोशल) प्राप्त करें।
  • लेखक के ईमेल खोजें — author_finder के साथ URL से किसी लेख के लेखक का ईमेल निकालें।

दस्तावेज़

Tomba Tomba.io MCP सर्वर

Tomba.io API के साथ एकीकरण के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर। यह सर्वर एक मानकीकृत MCP इंटरफ़ेस के माध्यम से व्यापक ईमेल खोज, सत्यापन और संवर्धन क्षमताएँ प्रदान करता है।

विशेषताएँ

उपकरण (28 उपलब्ध)

ईमेल खोज

सत्यापन

  • ईमेल सत्यापक: ईमेल डिलिवरेबिलिटी सत्यापित करें और डेटाबेस उपस्थिति जाँचें

संवर्धन

फ़ोन

डोमेन इंटेलिजेंस

कंपनी खोज

  • कंपनियाँ खोज: उन्नत फ़िल्टर के साथ प्राकृतिक भाषा क्वेरी का उपयोग करके कंपनियाँ खोजें

खाता और प्रबंधन

  • खाता जानकारी: वर्तमान खाता जानकारी, योजना और क्रेडिट प्राप्त करें
  • उपयोग जानकारी: सभी एंडपॉइंट्स में API उपयोग आँकड़े प्राप्त करें
  • फ़्लैग सूची: स्थिति और क्रेडिट रिफंड के साथ सबमिट किए गए डेटा फ़्लैग सूचीबद्ध करें
  • फ़्लैग बनाएँ: क्रेडिट पुनर्प्राप्ति के लिए गलत डेटा रिपोर्ट करें (हार्ड बाउंस, अमान्य ईमेल)
  • लीड सूची: वैकल्पिक डोमेन फ़िल्टर के साथ लीड सूचीबद्ध करें
  • लीड बनाएँ: सूची में नया लीड जोड़ें
  • कुंजी सूची: API कुंजियाँ सूचीबद्ध करें
  • लॉग प्राप्त करें: हाल के API अनुरोध लॉग प्राप्त करें

संसाधन (7 उपलब्ध)

  • tomba://api/status - API स्थिति और खाता जानकारी
  • tomba://domain/{domain} - डोमेन जानकारी
  • tomba://email/{email} - ईमेल जानकारी
  • tomba://similar/{domain} - समान डोमेन विश्लेषण
  • tomba://technology/{domain} - प्रौद्योगिकी स्टैक जानकारी
  • tomba://docs/api - API दस्तावेज़ीकरण
  • tomba://docs/tools - उपकरण दस्तावेज़ीकरण

प्रॉम्प्ट (16 पूर्व-निर्मित वर्कफ़्लो)

  • find_contact - किसी व्यक्ति के लिए पूर्ण संपर्क जानकारी खोजें
  • verify_email_list - बैच में ईमेल पते सत्यापित करें
  • research_company - कंपनी संपर्क और संरचना पर शोध करें
  • enrich_lead - सभी उपलब्ध डेटा के साथ लीड समृद्ध करें
  • find_journalists - लेखों से पत्रकार संपर्क खोजें
  • phone_finder - संपर्कों के लिए फ़ोन नंबर खोजें
  • validate_phone - फ़ोन नंबर सत्यापित करें
  • competitor_analysis - समान डोमेन और प्रौद्योगिकी का उपयोग करके प्रतिस्पर्धियों का विश्लेषण करें
  • technology_audit - वेबसाइट का व्यापक प्रौद्योगिकी ऑडिट
  • domain_insights - ईमेल गणना और प्रौद्योगिकी सहित डोमेन के बारे में व्यापक जानकारी प्राप्त करें
  • bulk_domain_research - ईमेल गणना और बुनियादी जानकारी के लिए कई डोमेन पर शोध करें
  • find_target_companies - उन्नत फ़िल्टर (आकार, प्रकार, राजस्व, उद्योग) के साथ कंपनियाँ खोजें
  • market_research - व्यापक फ़िल्टरिंग के साथ बाज़ार खंड में कंपनियों पर शोध करें
  • lead_generation - कंपनियों और उनके संपर्कों को खोजकर लीड उत्पन्न करें
  • prospect_enrichment - व्यापक डेटा के साथ कंपनी संभावित ग्राहकों को समृद्ध करें
  • industry_analysis - विस्तृत विभाजन के साथ उद्योग के भीतर कंपनियों का विश्लेषण करें

कंपनी खोज प्रॉम्प्ट के लिए फ़िल्टर विकल्प

फ़िल्टरउपलब्ध मान
आकार1-10 (माइक्रो), 11-50 (छोटा), 51-250 (मध्यम), 251-1K (मध्यम-बड़ा), 1K-5K (बड़ा), 5K-10K (बहुत बड़ा), 10K-50K (एंटरप्राइज़), 50K-100K (विशाल), 100K+ (वैश्विक)
प्रकारeducation, government, nonprofit, private, public, personal
राजस्व$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
उद्योगलिंक्डइन उद्योग कोड V2 पर आधारित (140+ उद्योग जिनमें कंप्यूटर सॉफ्टवेयर, वित्तीय सेवाएँ, अस्पताल और स्वास्थ्य देखभाल, आदि शामिल हैं)

प्रदर्शन और विश्वसनीयता

टाइमआउट

सभी API कॉल में 120-सेकंड टाइमआउट होता है। Tomba खोजें लाइव इंफ्रास्ट्रक्चर के खिलाफ वास्तविक समय में चलती हैं — प्रतिक्रिया समय लक्ष्य कंपनी के SMTP सर्वर गति, वेबसाइट प्रतिक्रियाशीलता और कैच-ऑल पहचान की गहराई के साथ भिन्न होता है।

एक्सपोनेंशियल बैकऑफ़ के साथ पुनः प्रयास

सभी API कॉल स्वचालित रूप से एक्सपोनेंशियल बैकऑफ़ के साथ 3 बार तक पुनः प्रयास करती हैं:

  • 429 Too Many Requests (दर सीमा पार)
  • 5xx सर्वर त्रुटियाँ

पुनः प्रयास विलंब: 1s → 2s → 4s।

दर सीमाएँ

दर सीमाएँ प्रति एंडपॉइंट और प्रति योजना लागू की जाती हैं:

योजनाप्रति सेकंडप्रति मिनटप्रति दिन
निःशुल्क125
बेसिक350500
ग्रोथ5801,000
प्रो81504,000
50,000+ योजनाएँअसीमितअसीमितअसीमित

जब Tomba परिणाम प्रदान नहीं कर सकता तो कोई क्रेडिट शुल्क नहीं लिया जाता है। 30 दिनों के भीतर डुप्लिकेट अनुरोधों की फिर से गणना नहीं की जाती है।

परिवहन विकल्प

  • stdio - मानक इनपुट/आउटपुट (डिफ़ॉल्ट, क्लॉड डेस्कटॉप के लिए)
  • http - REST एंडपॉइंट्स के साथ HTTP सर्वर

स्थापना

पूर्वापेक्षाएँ

स्क्रीनशॉट

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

नोट: npm पैकेज का नाम tomba-mcp-server से @tomba-io/tomba-mcp-server में बदल दिया गया है। कृपया अपने कॉन्फ़िगरेशन तदनुसार अपडेट करें।

विकल्प 1: NPX के माध्यम से स्थापित करें (अनुशंसित)

Tomba MCP सर्वर का उपयोग करने का सबसे आसान तरीका npx के माध्यम से है, जिसके लिए रिपॉजिटरी क्लोन करने की आवश्यकता नहीं है:

macOS/Linux

अपने claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json) में जोड़ें:

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

Windows

अपने claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json) में जोड़ें:

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

नोट: -y फ़्लैग स्वचालित रूप से स्थापना संकेत स्वीकार करता है, और npx हमेशा नवीनतम संस्करण प्राप्त करेगा।

विकल्प 2: स्रोत से स्थापित करें

यदि आप सर्वर को संशोधित करना चाहते हैं या विकास में योगदान देना चाहते हैं:

# Clone the repository
git clone https://github.com/tomba-io/tomba-mcp-server.git
cd tomba-mcp-server

# Install dependencies
yarn install

# Build the project
yarn build

कॉन्फ़िगरेशन

OpenClaw कौशल

इस रिपॉजिटरी में skills/ में वर्कस्पेस-स्थानीय कौशल शामिल हैं। Cursor प्लगइन (.cursor-plugin/plugin.json) उन्हें भी लोड करता है।

skills/tomba-contact-intelligence/SKILL.md मुख्य कौशल है। यह एजेंट को संपर्क खोज, कंपनी अनुसंधान, ईमेल सत्यापन, फ़ोन लुकअप और संभावित ग्राहक संवर्धन वर्कफ़्लो के लिए सही Tomba MCP उपकरण चुनने में मदद करता है।

प्रत्येक MCP उपकरण का अपना कौशल फ़ोल्डर भी है, skills/tomba-<tool-name>/SKILL.md। प्रत्येक उपकरण के इनपुट, वर्कफ़्लो, अपेक्षित आउटपुट और एक उदाहरण कॉल को कवर करता है:

समूहकौशल
ईमेलtomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
खोजtomba-domain-search, tomba-author-finder, tomba-linkedin-finder
फ़ोनtomba-phone-finder, tomba-phone-validator
कंपनीtomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
संवर्धनtomba-person-enrichment, tomba-combined-enrichment
लीड्सtomba-list-leads, tomba-create-lead
डेटा गुणवत्ताtomba-list-flags, tomba-create-flag
खाताtomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

इसे उपयोग करने के लिए:

  1. इस रिपॉजिटरी को अपने OpenClaw वर्कस्पेस के रूप में खोलें, या अपनी आवश्यकता के अनुसार skills/tomba-* निर्देशिकाओं को अपनी OpenClaw कौशल निर्देशिका में कॉपी करें।
  2. सुनिश्चित करें कि Tomba MCP सर्वर कॉन्फ़िगर किया गया है और OpenClaw के लिए उपलब्ध है।
  3. एक नया OpenClaw सत्र शुरू करें ताकि कौशल लोड हो सके।

उदाहरण प्रॉम्प्ट:

  • "stripe.com पर साझेदारी के लिए सर्वश्रेष्ठ संपर्क खोजें और लौटाने से पहले ईमेल सत्यापित करें।"
  • "जर्मनी में फिनटेक कंपनियों पर शोध करें, फिर शीर्ष मिलानों के लिए संभावित बिक्री संपर्कों की पहचान करें।"
  • "इस प्रॉस्पेक्ट को ईमेल, फ़ोन, कंपनी तकनीक और समान प्रतिस्पर्धियों के साथ संवर्धित करें: jane@acme.com"

Claude Code प्लगइन

यह रिपॉजिटरी एक Claude Code प्लगइन मार्केटप्लेस (.claude-plugin/) भी है। प्लगइन skills/ में हर कौशल को बंडल करता है और https://mcp.tomba.io/mcp पर होस्ट किए गए MCP सर्वर से जुड़ता है:

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

फिर /mcp चलाएँ और tomba सर्वर को OAuth से प्रमाणित करें। कोई API कुंजी आवश्यक नहीं है। प्लगइन कौशल नामस्थानित हैं, उदाहरण के लिए /tomba:tomba-domain-search zapier.com।

Codex प्लगइन

.codex-plugin/plugin.json OpenAI Codex के लिए समान कौशल पैकेज करता है। यह .mcp.json से रिमोट सर्वर लोड करता है। प्लगइन स्थापित करने के बाद, OAuth से साइन इन करें:

codex mcp login tomba

OAuth के बजाय API कुंजियों का उपयोग करने के लिए, X-Tomba-Key और X-Tomba-Secret हेडर, या Authorization: Bearer <base64(ta_key:ts_secret)>, को https://mcp.tomba.io/mcp पर भेजें।

Claude Desktop सेटअप

इस सर्वर को Claude Desktop के साथ उपयोग करने के लिए, अपनी claude_desktop_config.json फ़ाइल में कॉन्फ़िगरेशन जोड़ें।

NPX का उपयोग करना (अनुशंसित)

यह विधि स्वचालित रूप से नवीनतम प्रकाशित संस्करण का उपयोग करती है:

macOS/Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Windows (%APPDATA%\Claude\claude_desktop_config.json):

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

स्थानीय स्थापना का उपयोग करना

यदि आपने स्रोत से निर्माण किया है, तो अपनी स्थापना का पूर्ण पथ उपयोग करें:

macOS/Linux:

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

Windows:

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

महत्वपूर्ण नोट:

  • your-api-key-here और your-secret-key-here को अपनी वास्तविक Tomba API क्रेडेंशियल्स से बदलें
  • स्थानीय स्थापना के लिए, /ABSOLUTE/PATH/TO/tomba-mcp-server को अपनी स्थापना निर्देशिका के पूर्ण पथ से बदलें
  • कॉन्फ़िगरेशन अपडेट करने के बाद Claude Desktop को पुनरारंभ करें

Tomba API क्रेडेंशियल्स प्राप्त करना

  1. https://tomba.io पर जाएँ
  2. खाता बनाएँ या लॉग इन करें
  3. अपने डैशबोर्ड पर नेविगेट करें
  4. API सेटिंग्स पर जाएँ
  5. अपनी API कुंजी और गुप्त कुंजी कॉपी करें

वैकल्पिक: HTTP ट्रांसपोर्ट का उपयोग करना

npx के साथ HTTP ट्रांसपोर्ट के लिए:

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

स्थानीय स्थापना के साथ HTTP ट्रांसपोर्ट के लिए:

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

उपयोग

कमांड-लाइन विकल्प

Usage: tomba-mcp-server [options]

Options:
  --transport <type>    Transport type: 'stdio' or 'http' (default: stdio)
  --port <number>       Port number for HTTP transport (default: 3000)
  --help                Show help message

Environment Variables:
  TOMBA_API_KEY         Your Tomba API key (required)
  TOMBA_SECRET_KEY      Your Tomba secret key (required)

Examples:
  # Run with stdio transport (default)
  node server/index.js

  # Run with HTTP transport on default port (3000)
  node server/index.js --transport http

  # Run with HTTP transport on custom port
  node server/index.js --transport http --port 8080

स्टैंडअलोन HTTP सर्वर

आप सर्वर को एक स्टैंडअलोन HTTP सेवा के रूप में भी चला सकते हैं:

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

HTTP API एंडपॉइंट

  • POST /mcp - JSON-RPC अनुरोध भेजें
  • GET /mcp - अधिसूचनाओं के लिए सर्वर-सेंट इवेंट्स (X-Session-Id हेडर आवश्यक)
  • DELETE /mcp - एक सत्र समाप्त करें (X-Session-Id हेडर आवश्यक)
  • GET /health - स्वास्थ्य जांच एंडपॉइंट
  • GET /sessions - सक्रिय सत्रों की सूची (प्रमाणीकरण आवश्यक)

उदाहरण HTTP अनुरोध

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "email_finder",
      "arguments": {
        "domain": "stripe.com",
        "firstName": "Patrick",
        "lastName": "Collison"
      }
    },
    "id": 1
  }'

🔧 विकास

विकास कमांड

# Run in development mode
yarn dev

# Build the project
yarn build

# Run tests
yarn test

# Run tests in watch mode
yarn test:watch

# Run tests with coverage
yarn test:coverage

# Lint code
yarn lint

# Fix linting errors
yarn lint:fix

🔍 डिबगिंग और परीक्षण

MCP इंस्पेक्टर (अनुशंसित)

अपने MCP सर्वर का परीक्षण और डिबग करने का सबसे आसान तरीका:

# Build and launch MCP Inspector
yarn debug

यह एक वेब इंटरफ़ेस खोलता है जहाँ आप:

  • 📋 सभी उपलब्ध टूल देख सकते हैं
  • 🧪 टूल्स का इंटरैक्टिव रूप से परीक्षण कर सकते हैं
  • 📊 अनुरोध/प्रतिक्रियाएँ निरीक्षण कर सकते हैं
  • 🐛 वास्तविक समय में डिबग कर सकते हैं

वैकल्पिक डिबग विधियाँ

# Debug TypeScript directly
yarn debug:dev

# Run integration tests
yarn test:integration

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

VS Code डिबगिंग

यदि VS Code का उपयोग कर रहे हैं, तो शामिल डिबग कॉन्फ़िगरेशन का उपयोग करें:

  • Debug MCP Server: संकलित JavaScript डिबग करें
  • Debug TypeScript: TypeScript स्रोत को सीधे डिबग करें
  • Debug with Inspector: MCP इंस्पेक्टर के साथ डिबग करें
  • Run Tests: Jest परीक्षण डिबग करें

व्यापक डिबगिंग निर्देशों के लिए DEBUG_GUIDE.md देखें।

🧪 व्यक्तिगत टूल्स का परीक्षण

1. डोमेन खोज

डोमेन नाम से जुड़े ईमेल पतों की खोज करें।

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

प्रतिक्रिया:

{
  "data": {
    "organization": {
      "website_url": "tomba.io",
      "organization": "Tomba technology web service LLC",
      "location": {
        "country": "US",
        "city": "Claymont",
        "state": "Delaware",
        "street_address": "1228 claymont",
        "postal_code": "19703"
      },
      "social_links": {
        "twitter_url": "https://twitter.com/tombaplatforum",
        "facebook_url": "https://www.facebook.com/tombaplatforum",
        "linkedin_url": "https://www.linkedin.com/company/tomba-io"
      },
      "disposable": false,
      "webmail": false,
      "phone_number": "(850) 790-5575",
      "industries": "Information Technology and Services",
      "founded": "2021",
      "company_size": "1-10",
      "company_type": "privately held",
      "revenue": "$0-$1M",
      "accept_all": false,
      "description": "the most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.",
      "pattern": "{l}.{first}",
      "total_similar": 35,
      "keywords": [
        "lead generation software"
      ],
      "ranking": 661495,
      "whois": {
        "registrar_name": "namecheap, inc.",
        "created_date": "2020-07-07T20:54:07+02:00",
        "referral_url": "https://www.namecheap.com/"
      },
      "last_updated": "2025-09-06T00:22:01+02:00"
    },
    "emails": [
      {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "DZ",
        "position": "CEO",
        "department": "executive",
        "seniority": "senior",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "verification": {
          "date": "2025-09-22T00:00:00+02:00",
          "status": "valid"
        },
        "sources": [
          {
            "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
            "website_url": "github.com",
            "extracted_on": "2021-02-08T20:09:54+01:00",
            "last_seen_on": "2021-02-08T22:43:40+01:00",
            "still_on_page": true
          },
          ....
        ]
      },
      ...
      ...
      ...
      ...
      ...
    ]
  },
  "meta": {
    "total": 21,
    "pageSize": 10,
    "current": 1,
    "total_pages": 3,
    "params": {
      "domain": "tomba.io",
      "page": 1,
      "limit": 10,
      "department": null,
      "country": null,
      "type": "all",
      "live": false
    }
  }
}

2. ईमेल फाइंडर

डोमेन, पहला नाम और अंतिम नाम से संभावित ईमेल पते उत्पन्न करें।

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

प्रतिक्रिया:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

3. ईमेल वेरिफायर

ईमेल पते की डिलीवरेबिलिटी सत्यापित करें और डेटाबेस उपस्थिति जांचें।

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

प्रतिक्रिया:

{
    "data": {
        "email": {
            "email": "b.mohamed@tomba.io",
            "result": "deliverable",
            "status": "valid",
            "score": 99,
            "smtp_provider": "Google Workspace",
            "mx": {
                "records": [
                    "aspmx.l.google.com",
                    "alt2.aspmx.l.google.com",
                    "alt1.aspmx.l.google.com",
                    "alt4.aspmx.l.google.com",
                    "alt3.aspmx.l.google.com"
                ]
            },
            "mx_check": true,
            "smtp_server": true,
            "smtp_check": true,
            "accept_all": false,
            "greylisted": false,
            "block": true,
            "gibberish": false,
            "disposable": false,
            "webmail": false,
            "regex": true,
            "whois": {
                "registrar_name": "namecheap, inc.",
                "referral_url": "https://www.namecheap.com/",
                "created_date": "2020-07-07T20:54:07+02:00"
            }
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

4. ईमेल संवर्धन

एक ईमेल पते को अतिरिक्त संपर्क जानकारी के साथ संवर्धित करें।

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

प्रतिक्रिया:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

5. लेखक फाइंडर

URL से लेख के लेखकों के ईमेल पते खोजें।

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

प्रतिक्रिया:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

6. LinkedIn फाइंडर

LinkedIn प्रोफ़ाइल URL से ईमेल पते खोजें।

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

प्रतिक्रिया:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

7. फ़ोन फाइंडर

ईमेल, डोमेन या LinkedIn प्रोफ़ाइल के आधार पर फ़ोन नंबर खोजें।

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

प्रतिक्रिया:

{
    "data": {
        "domain": "tomba.io",
        "valid": true,
        "local_format": "(850) 790-5575",
        "intl_format": "+1 850-790-5575",
        "e164_format": "+18507905575",
        "rfc3966_format": "tel:+1-850-790-5575",
        "country_code": "US",
        "line_type": "FIXED_LINE_OR_MOBILE",
        "carrier": "",
        "timezones": ["America/New_York"]
    }
}

8. फ़ोन वैलिडेटर

फ़ोन नंबर सत्यापित करें और कैरियर जानकारी जांचें।

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

प्रतिक्रिया:

{
    "data": {
        "valid": true,
        "local_format": "0667 94 54 02",
        "intl_format": "+213 667 94 54 02",
        "e164_format": "+213667945402",
        "rfc3966_format": "tel:+213-667-94-54-02",
        "country_code": "DZ",
        "line_type": "MOBILE",
        "carrier": "Mobilis",
        "timezones": ["Europe/Paris"]
    }
}

9. ईमेल गणना

एक डोमेन के लिए ईमेल पतों की कुल संख्या प्राप्त करें।

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

प्रतिक्रिया:

{
    "domain": "tomba.io",
    "total": 245,
    "personalEmails": 198,
    "genericEmails": 47,
    "department": {
        "engineering": 45,
        "sales": 38,
        "marketing": 32,
        "hr": 15,
        "finance": 12,
        "legal": 8,
        "executive": 25,
        "support": 28,
        "other": 42
    },
    "seniority": {
        "junior": 89,
        "senior": 125,
        "executive": 31
    },
    "source": "tomba_email_count"
}

10. समान फाइंडर

एक विशिष्ट डोमेन के आधार पर समान डोमेन खोजें।

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

प्रतिक्रिया:

{
    "data": [
        {
            "website_url": "summit.com",
            "name": "Summit",
            "industries": "Wholesale"
        },
        {
            "website_url": "hunter.io",
            "name": "Hunter",
            "industries": "Information Technology and Services"
        },
        {
            "website_url": "voilaNorbert.com",
            "name": "VoilaNorbert",
            "industries": "Information Technology and Services"
        }
    ]
}

11. प्रौद्योगिकी फाइंडर

किसी भी वेबसाइट की तकनीकी स्टैक तुरंत प्रकट करें।

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

प्रतिक्रिया:

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

12. कंपनियाँ खोज

स्थान, उद्योग, आकार और राजस्व सहित उन्नत फ़िल्टर के साथ प्राकृतिक भाषा क्वेरी का उपयोग करके कंपनियों की खोज करें।

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

प्रतिक्रिया:

{
    "data": {
        "companies": [
            {
                "name": "Tech Company Inc",
                "domain": "techcompany.com",
                "industry": "Technology",
                "location": {
                    "city": "San Francisco",
                    "state": "California",
                    "country": "United States"
                },
                "size": "51-200",
                "revenue": "$10M-$50M"
            }
        ],
        "total": 150,
        "page": 1
    }
}

उपलब्ध फ़िल्टर:

  • location_city: शहर द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ
  • location_state: राज्य द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ
  • location_country: देश द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ
  • industry: उद्योग द्वारा फ़िल्टर करें (LinkedIn उद्योग कोड V2 पर आधारित - 140+ उद्योग)
  • type: कंपनी प्रकार द्वारा फ़िल्टर करें: education, government, nonprofit, private, public, personal
  • size: कंपनी आकार द्वारा फ़िल्टर करें: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: राजस्व सीमा द्वारा फ़िल्टर करें: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: स्थापना वर्ष द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ
  • keywords: कीवर्ड द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ
  • sic: SIC कोड द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ
  • naics: NAICS कोड द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ
  • similar: समान डोमेन द्वारा फ़िल्टर करें, शामिल/बहिष्कृत सरणियों के साथ

दर सीमा और उपयोग

API दर सीमाएँ

Tomba.io आपकी सदस्यता योजना के आधार पर दर सीमा लागू करता है:

  • निःशुल्क योजना: 50 अनुरोध प्रति माह
  • ग्रोथ योजना: 5,000 अनुरोध प्रति माह + 10,000 सत्यापन अनुरोध
  • प्रो योजना: 10,000 अनुरोध प्रति माह
  • एंटरप्राइज़ योजना: 50,000 अनुरोध प्रति माह
  • कस्टम योजना: कस्टम सीमाएँ

Tomba मूल्य निर्धारण योजनाओं के बारे में अधिक जानें।

दर सीमा हेडर

प्रत्येक API प्रतिक्रिया में दर सीमा जानकारी शामिल होती है:

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

Tomba API दर सीमाओं के बारे में अधिक जानें।

दर सीमाओं को संभालना

जब आप अपनी दर सीमा से अधिक हो जाते हैं, तो API 429 Too Many Requests स्थिति लौटाता है:

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

सर्वोत्तम अभ्यास

  1. उपयोग की निगरानी करें: tomba.io/dashboard पर अपना डैशबोर्ड जांचें
  2. बैकऑफ़ लागू करें: 429 प्रतिक्रियाओं को एक्सपोनेंशियल बैकऑफ़ के साथ संभालें
  3. बैच संचालन: एक ही डोमेन से कई ईमेल के लिए डोमेन खोज का उपयोग करें
  4. परिणाम कैश करें: डुप्लिकेट अनुरोधों से बचने के लिए परिणाम स्थानीय रूप से संग्रहीत करें
  5. तदनुसार योजना बनाएं: उपयोग पैटर्न के आधार पर अपनी योजना को अपग्रेड करें

उपयोग युक्तियाँ

  • डोमेन खोज प्रति अनुरोध कई ईमेल लौटाती है (व्यक्तिगत लुकअप से अधिक कुशल)
  • ईमेल सत्यापन केवल मान्य ईमेल प्रारूपों के लिए क्रेडिट उपभोग करता है
  • फ़ोन खोजकर्ता प्रति अनुरोध कई नंबर लौटा सकता है
  • एनरिचमेंट एक ही अनुरोध में व्यापक डेटा प्रदान करता है

समस्या निवारण

क्लॉड डेस्कटॉप में सर्वर प्रारंभ नहीं हो रहा

  1. Node.js संस्करण जांचें: सुनिश्चित करें कि आपके पास Node.js 18 या उच्चतर है

    node --version

  2. NPX का उपयोग करना:

    • पहली बार चलाने के लिए स्थिर इंटरनेट कनेक्शन सुनिश्चित करें
    • -y फ्लैग को इंस्टॉलेशन स्वचालित रूप से स्वीकार करना चाहिए
    • NPX पहले उपयोग के बाद पैकेज को कैश करेगा

  3. स्थानीय इंस्टॉलेशन का उपयोग करना:

    • अपने कॉन्फ़िग में पूर्ण पथ सही है सत्यापित करें
    • सुनिश्चित करें कि server/index.js मौजूद है: ls -la server/index.js
    • सुनिश्चित करें कि आपने yarn build सफलतापूर्वक चलाया

  4. API क्रेडेंशियल सत्यापित करें: सुनिश्चित करें कि आपकी Tomba API कुंजियाँ सही हैं

  5. क्लॉड लॉग जांचें:

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

NPX-विशिष्ट समस्याएँ

"npx कमांड नहीं मिला":

  • सुनिश्चित करें कि npm इंस्टॉल है: npm --version
  • NPX npm 5.2.0+ के साथ आता है, आवश्यकता होने पर अपडेट करें: npm install -g npm

पैकेज नहीं मिला:

  • सत्यापित करें कि पैकेज प्रकाशित है: npm view @tomba-io/tomba-mcp-server
  • npm कैश साफ़ करने का प्रयास करें: npm cache clean --force

हमेशा पैकेज डाउनलोड हो रहा है:

  • यह -y फ्लैग के साथ सामान्य व्यवहार है
  • NPX पहले डाउनलोड के बाद पैकेज को कैश करता है
  • स्थायी इंस्टॉलेशन के लिए, स्थानीय इंस्टॉलेशन विधि का उपयोग करें

प्रमाणीकरण त्रुटियाँ

  • https://app.tomba.io/dashboard पर अपनी API कुंजियाँ सत्यापित करें
  • सुनिश्चित करें कि पर्यावरण चर कॉन्फ़िग में ठीक से सेट हैं
  • जांचें कि आपकी API सदस्यता सक्रिय है

उपकरण प्रतिक्रिया नहीं दे रहे

  • अपनी Tomba API दर सीमाएँ जांचें
  • नेटवर्क कनेक्टिविटी सत्यापित करें
  • त्रुटि संदेशों के लिए सर्वर लॉग समीक्षा करें

Tomba के बारे में

2020 में स्थापित, Tomba को कहीं भी उपलब्ध ईमेल पता डेटा का सबसे विश्वसनीय, सटीक और गहन स्रोत होने पर गर्व है। हम अपने ईमेल खोजकर्ता API का उत्पादन करने के लिए टेराबाइट्स डेटा संसाधित करते हैं।

image

योगदान

  1. इसे फोर्क करें (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. अपनी फीचर शाखा बनाएं (git checkout -b my-new-feature)
  3. अपने परिवर्तन कमिट करें (git commit -am 'Add some feature')
  4. शाखा में पुश करें (git push origin my-new-feature)
  5. एक नया पुल अनुरोध बनाएं

लाइसेंस

अधिक जानकारी के लिए कृपया लाइसेंस फ़ाइल देखें।

सहायता