Tomba MCP

आधिकारिक

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

GitHub
8
इस MCP को आज़माएँप्रायोजित

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

  • किसी डोमेन के लिए ईमेल पते खोजें — domain_search के माध्यम से किसी कंपनी के सभी संपर्कों के लिए पूछें, जिसमें विभाग या देश जैसे फ़िल्टर शामिल हों।
  • किसी व्यक्ति का ईमेल जनरेट करें — नाम और डोमेन से संभावित पता बनाने के लिए email_finder का उपयोग करें, फिर उसे सत्यापित करें।
  • ईमेल डिलिवरेबिलिटी सत्यापित करें — जाँचें कि पता मान्य है और email_verifier का उपयोग करके भेजने के लिए सुरक्षित है।
  • संपर्क प्रोफ़ाइल समृद्ध करें — email_enrichment के साथ ईमेल के लिए नौकरी का शीर्षक, कंपनी और सोशल लिंक प्राप्त करें।
  • कंपनी की तकनीकी स्टैक खोजें — technology_finder के माध्यम से उन टूल्स और प्लेटफ़ॉर्म की पहचान करें जो एक वेबसाइट उपयोग करती है।
  • समान कंपनियाँ खोजें — प्रॉस्पेक्टिंग या विश्लेषण के लिए तुलनीय डोमेन ढूँढने हेतु similar_finder का उपयोग करें।

दस्तावेज़

Tomba Tomba.io MCP सर्वर

Tomba.io API के साथ एकीकरण के लिए एक Model Context Protocol (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+
उद्योगLinkedIn Industry Codes V2 पर आधारित (140+ उद्योग जिनमें Computer Software, Financial Services, Hospital & Health Care, आदि शामिल हैं)

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

टाइमआउट

सभी 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 - मानक इनपुट/आउटपुट (डिफ़ॉल्ट, Claude Desktop के लिए)
  • 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/tomba-contact-intelligence/SKILL.md पर एक वर्कस्पेस-स्थानीय OpenClaw स्किल शामिल है।

यह स्किल OpenClaw को संपर्क खोज, कंपनी शोध, ईमेल सत्यापन, फ़ोन लुकअप और संभावित ग्राहक संवर्धन वर्कफ़्लो के लिए सही Tomba MCP उपकरण चुनने में मदद करने के लिए डिज़ाइन किया गया है।

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

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

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

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

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. समान खोजक (Similar Finder)

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

{
    "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. प्रौद्योगिकी खोजक (Technology Finder)

किसी भी वेबसाइट की प्रौद्योगिकी स्टैक को तुरंत उजागर करें।

{
    "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. कंपनियों की खोज (Companies Search)

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

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

दर सीमा और उपयोग (Rate Limiting & Usage)

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. तदनुसार योजना बनाएं: उपयोग पैटर्न के आधार पर अपनी योजना को अपग्रेड करें

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

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

समस्या निवारण (Troubleshooting)

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

  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

योगदान (Contributing)

  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. एक नया पुल अनुरोध बनाएं

लाइसेंस

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

सहायता