Tomba MCP

offiziell

Tomba, Ihr einzigartiger B2B-E-Mail-Finder und -Verifizierer, bietet eine unverwechselbare Lead-Datenbank für müheloses und effektives Outreach-Scaling.

GitHub
8

Was kann man mit Tomba MCP machen?

  • Kontakt-E-Mails finden — Fragen Sie nach allen E-Mail-Adressen, die mit einer Domain verknüpft sind, über domain_search, mit Filtern wie Abteilung oder Land.
  • Wahrscheinliche Adressen generieren — Verwenden Sie email_finder, um plausible E-Mails aus dem Namen einer Person und der Unternehmensdomain zu konstruieren.
  • Zustellbarkeit prüfen — Überprüfen Sie mit email_verifier, ob eine E-Mail gültig und zustellbar ist, einschließlich SMTP- und MX-Prüfungen.
  • Kontaktdaten anreichern — Rufen Sie detaillierte Profile (Name, Position, soziale Netzwerke) für eine bekannte E-Mail über email_enrichment ab.
  • Autoren-E-Mails entdecken — Extrahieren Sie die E-Mail des Autors eines Artikels aus einer URL mit author_finder.

Dokumentation

Tomba Tomba.io MCP Server

Ein Model Context Protocol (MCP)-Server für die Integration mit der Tomba.io-API. Dieser Server bietet umfassende E-Mail-Erkennungs-, Verifizierungs- und Anreicherungsfunktionen über eine standardisierte MCP-Schnittstelle.

Funktionen

Tools (28 verfügbar)

E-Mail-Erkennung

  • Domain-Suche: Finden Sie alle E-Mail-Adressen, die mit einer Domain verknüpft sind
  • E-Mail-Finder: Generieren Sie wahrscheinliche E-Mail-Adressen aus Namen und Domains
  • Autor-Finder: Entdecken Sie E-Mail-Adressen von Artikelautoren
  • LinkedIn-Finder: Finden Sie E-Mails aus LinkedIn-Profil-URLs
  • E-Mail-Anzahl: Ermitteln Sie die Gesamtzahl der E-Mails für Domains
  • E-Mail-Quellen: Finden Sie heraus, wo eine E-Mail-Adresse im Web gefunden wurde
  • E-Mail-Format: Ermitteln Sie die E-Mail-Formatmuster, die von einer Domain verwendet werden

Verifizierung

  • E-Mail-Verifizierer: Verifizieren Sie die Zustellbarkeit von E-Mails und prüfen Sie das Vorhandensein in der Datenbank

Anreicherung

Telefon

  • Telefon-Finder: Suchen Sie Telefonnummern per E-Mail, Domain oder LinkedIn
  • Telefon-Validierer: Validieren Sie Telefonnummern und prüfen Sie Anbieterinformationen

Domain-Intelligenz

  • Domain-Status: Prüfen Sie, ob eine Domain Webmail oder Wegwerf-Domain ist
  • Autovervollständigung: Unternehmensnamensvorschläge mit Logo- und Domain-Informationen
  • Ähnlichkeits-Finder: Finden Sie ähnliche Domains basierend auf einer Zieldomain
  • Technologie-Finder: Entdecken Sie Technologie-Stacks, die von Websites verwendet werden
  • Standort: Ermitteln Sie die Anzahl der Mitarbeiterstandorte nach Land

Unternehmenssuche

  • Unternehmenssuche: Suchen Sie nach Unternehmen mit natürlichen Sprachabfragen und erweiterten Filtern

Konto & Verwaltung

  • Kontoinformationen: Aktuelle Kontoinformationen, Plan und Guthaben abrufen
  • Nutzungsinformationen: API-Nutzungsstatistiken über alle Endpunkte abrufen
  • Flags auflisten: Eingereichte Daten-Flags mit Status und Guthaben-Erstattungen auflisten
  • Flag erstellen: Fehlerhafte Daten melden (harte Bounces, ungültige E-Mails) zur Guthaben-Wiederherstellung
  • Leads auflisten: Leads mit optionalem Domain-Filter auflisten
  • Lead erstellen: Einen neuen Lead zu einer Liste hinzufügen
  • Schlüssel auflisten: API-Schlüssel auflisten
  • Protokolle abrufen: Aktuelle API-Anfrageprotokolle abrufen

Ressourcen (7 verfügbar)

  • tomba://api/status - API-Status und Kontoinformationen
  • tomba://domain/{domain} - Domain-Informationen
  • tomba://email/{email} - E-Mail-Informationen
  • tomba://similar/{domain} - Ähnlichkeits-Domain-Analyse
  • tomba://technology/{domain} - Technologie-Stack-Informationen
  • tomba://docs/api - API-Dokumentation
  • tomba://docs/tools - Tools-Dokumentation

Prompts (16 vorgefertigte Workflows)

  • find_contact - Vollständige Kontaktinformationen für eine Person finden
  • verify_email_list - E-Mail-Adressen in Stapelverarbeitung verifizieren
  • research_company - Unternehmenskontakte und -struktur recherchieren
  • enrich_lead - Einen Lead mit allen verfügbaren Daten anreichern
  • find_journalists - Journalistenkontakte aus Artikeln finden
  • phone_finder - Telefonnummern für Kontakte finden
  • validate_phone - Eine Telefonnummer validieren
  • competitor_analysis - Wettbewerber mithilfe ähnlicher Domains und Technologien analysieren
  • technology_audit - Umfassende Technologie-Prüfung einer Website
  • domain_insights - Umfassende Einblicke zu einer Domain erhalten, einschließlich E-Mail-Anzahl und Technologie
  • bulk_domain_research - Mehrere Domains auf E-Mail-Anzahlen und Basisinformationen untersuchen
  • find_target_companies - Unternehmen mit erweiterten Filtern finden (Größe, Typ, Umsatz, Branche)
  • market_research - Unternehmen in einem Marktsegment mit umfassender Filterung recherchieren
  • lead_generation - Leads generieren, indem Unternehmen und deren Kontakte gefunden werden
  • prospect_enrichment - Unternehmensprospekte mit umfassenden Daten anreichern
  • industry_analysis - Unternehmen innerhalb einer Branche mit detaillierter Segmentierung analysieren

Filteroptionen für Unternehmenssuch-Prompts

FilterVerfügbare Werte
Größe1-10 (Mikro), 11-50 (Klein), 51-250 (Mittelgroß), 251-1K (Mittelgroß bis groß), 1K-5K (Groß), 5K-10K (Sehr groß), 10K-50K (Enterprise), 50K-100K (Massiv), 100K+ (Global)
TypBildung, Regierung, gemeinnützig, privat, öffentlich, persönlich
Umsatz$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
BrancheBasierend auf LinkedIn Industry Codes V2 (140+ Branchen, einschließlich Computersoftware, Finanzdienstleistungen, Krankenhaus & Gesundheitswesen usw.)

Leistung & Zuverlässigkeit

Timeout

Alle API-Aufrufe haben ein 120-Sekunden-Timeout. Tomba-Suchen laufen in Echtzeit gegen die Live-Infrastruktur – die Antwortzeiten variieren je nach SMTP-Servergeschwindigkeit des Zielunternehmens, der Reaktionsfähigkeit der Website und der Tiefe der Catch-All-Erkennung.

Wiederholung mit exponentiellem Backoff

Alle API-Aufrufe werden automatisch bis zu 3 Mal mit exponentiellem Backoff wiederholt bei:

  • 429 Too Many Requests (Ratenlimit überschritten)
  • 5xx Serverfehler

Wiederholungsverzögerungen: 1s → 2s → 4s.

Ratenlimits

Ratenlimits werden pro Endpunkt und pro Plan durchgesetzt:

PlanPro SekundePro MinutePro Tag
Kostenlos125
Basic350500
Growth5801.000
Pro81504.000
50.000+ PläneUnbegrenztUnbegrenztUnbegrenzt

Es werden keine Credits berechnet, wenn Tomba kein Ergebnis liefern kann. Doppelte Anfragen innerhalb von 30 Tagen werden nicht erneut gezählt.

Transportoptionen

  • stdio - Standard-Eingabe/Ausgabe (Standard, für Claude Desktop)
  • http - HTTP-Server mit REST-Endpunkten

Installation

Voraussetzungen

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Hinweis: Das npm-Paket wurde von tomba-mcp-server in @tomba-io/tomba-mcp-server umbenannt. Bitte aktualisieren Sie Ihre Konfigurationen entsprechend.

Option 1: Installation über NPX (Empfohlen)

Der einfachste Weg, den Tomba-MCP-Server zu verwenden, ist über npx, ohne das Repository klonen zu müssen:

macOS/Linux

Fügen Sie zu Ihrer claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json) hinzu:

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

Fügen Sie zu Ihrer claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json) hinzu:

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

Hinweis: Das -y-Flag akzeptiert automatisch die Installationsaufforderung, und npx holt immer die neueste Version.

Option 2: Installation aus dem Quellcode

Wenn Sie den Server ändern oder zur Entwicklung beitragen möchten:

# 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

Konfiguration

OpenClaw-Skill

Dieses Repository enthält arbeitsbereichsbezogene Skills in skills/. Das Cursor-Plugin (.cursor-plugin/plugin.json) lädt diese ebenfalls.

skills/tomba-contact-intelligence/SKILL.md ist der Haupt-Skill. Er hilft dem Agenten, die richtigen Tomba-MCP-Tools für Kontakterkennung, Unternehmensrecherche, E-Mail-Verifizierung, Telefonsuche und Prospekt-Anreicherungs-Workflows auszuwählen.

Jedes MCP-Tool hat auch seinen eigenen Skill-Ordner, skills/tomba-<tool-name>/SKILL.md. Jeder deckt die Eingaben, den Workflow, die erwartete Ausgabe und einen Beispielaufruf des Tools ab:

GruppeFähigkeiten
E-Mailtomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
Discoverytomba-domain-search, tomba-author-finder, tomba-linkedin-finder
Telefontomba-phone-finder, tomba-phone-validator
Unternehmentomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
Anreicherungtomba-person-enrichment, tomba-combined-enrichment
Leadstomba-list-leads, tomba-create-lead
Datenqualitättomba-list-flags, tomba-create-flag
Kontotomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

So verwenden Sie es:

  1. Öffnen Sie dieses Repository als Ihren OpenClaw-Arbeitsbereich oder kopieren Sie die skills/tomba-*-Verzeichnisse, die Sie benötigen, in Ihr OpenClaw-Skills-Verzeichnis.
  2. Stellen Sie sicher, dass der Tomba MCP-Server konfiguriert und für OpenClaw verfügbar ist.
  3. Starten Sie eine neue OpenClaw-Sitzung, damit das Skill geladen wird.

Beispielaufforderungen:

  • "Finde den besten Kontakt für Partnerschaften bei stripe.com und überprüfe die E-Mail, bevor du sie zurückgibst."
  • "Recherchiere Fintech-Unternehmen in Deutschland und identifiziere dann wahrscheinliche Vertriebskontakte für die besten Treffer."
  • "Reichere diesen Interessenten mit E-Mail, Telefon, Unternehmens-Technologie und ähnlichen Wettbewerbern an: jane@acme.com"

Claude Code Plugin

Dieses Repository ist auch ein Claude-Code-Plugin-Marktplatz (.claude-plugin/). Das Plugin bündelt jedes Skill in skills/ und verbindet sich mit dem gehosteten MCP-Server unter https://mcp.tomba.io/mcp:

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

Führen Sie dann /mcp aus und authentifizieren Sie den tomba-Server mit OAuth. Es sind keine API-Schlüssel erforderlich. Plugin-Skills sind namensbasiert, zum Beispiel /tomba:tomba-domain-search zapier.com.

Codex Plugin

.codex-plugin/plugin.json verpackt dieselben Skills für OpenAI Codex. Es lädt den entfernten Server von .mcp.json. Nach der Installation des Plugins melden Sie sich mit OAuth an:

codex mcp login tomba

Um API-Schlüssel anstelle von OAuth zu verwenden, senden Sie die X-Tomba-Key- und X-Tomba-Secret-Header oder Authorization: Bearer <base64(ta_key:ts_secret)> an https://mcp.tomba.io/mcp.

Claude Desktop Einrichtung

Um diesen Server mit Claude Desktop zu verwenden, fügen Sie die Konfiguration zu Ihrer claude_desktop_config.json-Datei hinzu.

Verwendung von NPX (Empfohlen)

Diese Methode verwendet automatisch die neueste veröffentlichte Version:

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

Verwendung der lokalen Installation

Wenn Sie aus dem Quellcode erstellt haben, verwenden Sie den absoluten Pfad zu Ihrer Installation:

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

Wichtige Hinweise:

  • Ersetzen Sie your-api-key-here und your-secret-key-here durch Ihre tatsächlichen Tomba-API-Anmeldeinformationen
  • Ersetzen Sie bei lokaler Installation /ABSOLUTE/PATH/TO/tomba-mcp-server durch den vollständigen Pfad zu Ihrem Installationsverzeichnis
  • Starten Sie Claude Desktop nach der Aktualisierung der Konfiguration neu

Tomba-API-Anmeldeinformationen erhalten

  1. Besuchen Sie https://tomba.io
  2. Registrieren Sie sich für ein Konto oder melden Sie sich an
  3. Navigieren Sie zu Ihrem Dashboard
  4. Gehen Sie zu den API-Einstellungen
  5. Kopieren Sie Ihren API-Schlüssel und Ihren geheimen Schlüssel

Alternative: Verwendung des HTTP-Transports

Für HTTP-Transport mit 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"
            }
        }
    }
}

Für HTTP-Transport mit lokaler Installation:

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

Verwendung

Befehlszeilenoptionen

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

Eigenständiger HTTP-Server

Sie können den Server auch als eigenständigen HTTP-Dienst ausführen:

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

HTTP-API-Endpunkte

  • POST /mcp - JSON-RPC-Anfragen senden
  • GET /mcp - Server-Sent Events für Benachrichtigungen (erfordert X-Session-Id-Header)
  • DELETE /mcp - Eine Sitzung beenden (erfordert X-Session-Id-Header)
  • GET /health - Health-Check-Endpunkt
  • GET /sessions - Aktive Sitzungen auflisten (erfordert Authentifizierung)

Beispiel einer HTTP-Anfrage

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

🔧 Entwicklung

Entwicklungsbefehle

# 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 & Testen

MCP Inspector (Empfohlen)

Der einfachste Weg, Ihren MCP-Server zu testen und zu debuggen:

# Build and launch MCP Inspector
yarn debug

Dies öffnet eine Weboberfläche, in der Sie:

  • 📋 Alle verfügbaren Tools anzeigen
  • 🧪 Tools interaktiv testen
  • 📊 Anfragen/Antworten untersuchen
  • 🐛 In Echtzeit debuggen

Alternative Debug-Methoden

# 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 Debugging

Wenn Sie VS Code verwenden, nutzen Sie die enthaltenen Debug-Konfigurationen:

  • Debug MCP Server: Debuggen Sie das kompilierte JavaScript
  • Debug TypeScript: Debuggen Sie den TypeScript-Quellcode direkt
  • Debug with Inspector: Debuggen Sie mit MCP Inspector
  • Run Tests: Debuggen Sie Jest-Tests

Siehe DEBUG_GUIDE.md für umfassende Debugging-Anweisungen.

🧪 Testen einzelner Tools

1. Domain-Suche

Suchen Sie nach E-Mail-Adressen, die mit einem Domainnamen verbunden sind.

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

Antwort:

{
  "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. E-Mail-Finder

Generieren Sie wahrscheinliche E-Mail-Adressen aus Domain, Vorname und Nachname.

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

Antwort:

{
    "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. E-Mail-Verifizierer

Überprüfen Sie die Zustellbarkeit von E-Mail-Adressen und prüfen Sie das Vorhandensein in der Datenbank.

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

Antwort:

{
    "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. E-Mail-Anreicherung

Reichern Sie eine E-Mail-Adresse mit zusätzlichen Kontaktinformationen an.

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

Antwort:

{
    "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. Autoren-Finder

Finden Sie E-Mail-Adressen von Artikelautoren aus einer URL.

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

Antwort:

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

Finden Sie E-Mail-Adressen aus LinkedIn-Profil-URLs.

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

Antwort:

{
    "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. Telefon-Finder

Suchen Sie nach Telefonnummern basierend auf E-Mail, Domain oder LinkedIn-Profil.

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

Antwort:

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

Validieren Sie Telefonnummern und prüfen Sie die Anbieterinformationen.

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

Antwort:

{
    "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. E-Mail-Anzahl

Erhalten Sie die Gesamtzahl der E-Mail-Adressen für eine Domain.

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

Antwort:

{
    "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. Ähnlichkeits-Finder

Finden Sie ähnliche Domains basierend auf einer bestimmten Domain.

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

Antwort:

{
    "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. Technologie-Finder

Zeigen Sie sofort den Technologie-Stack einer beliebigen Website an.

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

Antwort:

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

12. Unternehmenssuche

Suchen Sie nach Unternehmen mit natürlichen Sprachabfragen und erweiterten Filtern wie Standort, Branche, Größe und Umsatz.

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

Antwort:

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

Verfügbare Filter:

  • location_city: Nach Stadt filtern mit Include/Exclude-Arrays
  • location_state: Nach Bundesland filtern mit Include/Exclude-Arrays
  • location_country: Nach Land filtern mit Include/Exclude-Arrays
  • industry: Nach Branche filtern (basierend auf LinkedIn Industry Codes V2 - 140+ Branchen)
  • type: Nach Unternehmenstyp filtern: education, government, nonprofit, private, public, personal
  • size: Nach Unternehmensgröße filtern: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Nach Umsatzbereich filtern: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Nach Gründungsjahr filtern mit Include/Exclude-Arrays
  • keywords: Nach Schlüsselwörtern filtern mit Include/Exclude-Arrays
  • sic: Nach SIC-Codes filtern mit Include/Exclude-Arrays
  • naics: Nach NAICS-Codes filtern mit Include/Exclude-Arrays
  • similar: Nach ähnlichen Domains filtern mit Include/Exclude-Arrays

Ratenbegrenzung & Nutzung

API-Ratenbegrenzungen

Tomba.io implementiert Ratenbegrenzungen basierend auf Ihrem Abonnementplan:

  • Kostenloser Plan: 50 Anfragen pro Monat
  • Growth-Plan: 5.000 Anfragen pro Monat + 10.000 Verifizierungsanfragen
  • Pro-Plan: 10.000 Anfragen pro Monat
  • Enterprise-Plan: 50.000 Anfragen pro Monat
  • Individueller Plan: Individuelle Grenzen

Erfahren Sie mehr über Tomba-Preispläne.

Ratenbegrenzungs-Header

Jede API-Antwort enthält Informationen zur Ratenbegrenzung:

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

Erfahren Sie mehr über Tomba-API-Ratenbegrenzungen.

Umgang mit Ratenbegrenzungen

Wenn Sie Ihre Ratenbegrenzung überschreiten, gibt die API einen 429 Too Many Requests-Status zurück mit:

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

Best Practices

  1. Nutzung überwachen: Überprüfen Sie Ihr Dashboard unter tomba.io/dashboard
  2. Backoff implementieren: Behandeln Sie 429-Antworten mit exponentiellem Backoff
  3. Batch-Operationen: Verwenden Sie die Domain-Suche für mehrere E-Mails von derselben Domain
  4. Ergebnisse zwischenspeichern: Speichern Sie Ergebnisse lokal, um doppelte Anfragen zu vermeiden
  5. Entsprechend planen: Aktualisieren Sie Ihren Plan basierend auf den Nutzungsmustern

Nutzungstipps

  • Die Domänensuche gibt mehrere E-Mails pro Anfrage zurück (effizienter als einzelne Abfragen)
  • Die E-Mail-Verifizierung verbraucht nur Guthaben für gültige E-Mail-Formate
  • Der Telefonfinder kann mehrere Nummern pro Anfrage zurückgeben
  • Die Anreicherung liefert umfassende Daten in einer einzigen Anfrage

Fehlerbehebung

Server startet nicht in Claude Desktop

  1. Node.js-Version prüfen: Stellen Sie sicher, dass Sie Node.js 18 oder höher haben

    node --version

  2. NPX verwenden:

    • Stellen Sie eine stabile Internetverbindung für den ersten Start sicher
    • Das -y-Flag sollte die Installation automatisch akzeptieren
    • NPX speichert das Paket nach der ersten Verwendung im Cache

  3. Lokale Installation verwenden:

    • Überprüfen Sie, ob der absolute Pfad in Ihrer Konfiguration korrekt ist
    • Stellen Sie sicher, dass server/index.js existiert: ls -la server/index.js
    • Stellen Sie sicher, dass Sie yarn build erfolgreich ausgeführt haben

  4. API-Anmeldedaten überprüfen: Stellen Sie sicher, dass Ihre Tomba-API-Schlüssel korrekt sind

  5. Claude-Protokolle prüfen:

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

NPX-spezifische Probleme

„npx-Befehl nicht gefunden":

  • Stellen Sie sicher, dass npm installiert ist: npm --version
  • NPX wird mit npm 5.2.0+ geliefert, aktualisieren Sie bei Bedarf: npm install -g npm

Paket nicht gefunden:

  • Überprüfen Sie, ob das Paket veröffentlicht ist: npm view @tomba-io/tomba-mcp-server
  • Versuchen Sie, den npm-Cache zu leeren: npm cache clean --force

Paket wird immer heruntergeladen:

  • Dies ist normales Verhalten mit dem -y-Flag
  • NPX speichert das Paket nach dem ersten Download im Cache
  • Für eine dauerhafte Installation verwenden Sie die lokale Installationsmethode

Authentifizierungsfehler

  • Überprüfen Sie Ihre API-Schlüssel unter https://app.tomba.io/dashboard
  • Stellen Sie sicher, dass Umgebungsvariablen in der Konfiguration korrekt gesetzt sind
  • Prüfen Sie, ob Ihr API-Abonnement aktiv ist

Tools reagieren nicht

  • Überprüfen Sie Ihre Tomba-API-Ratenlimits
  • Stellen Sie die Netzwerkverbindung sicher
  • Überprüfen Sie die Serverprotokolle auf Fehlermeldungen

Über Tomba

Tomba wurde 2020 gegründet und ist stolz darauf, die zuverlässigste, genaueste und umfassendste Quelle für E-Mail-Adressdaten zu sein, die es überall gibt. Wir verarbeiten Terabytes an Daten, um unsere E-Mail-Finder-API zu erstellen.

image

Mitwirken

  1. Forken Sie das Repository (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Erstellen Sie Ihren Feature-Branch (git checkout -b my-new-feature)
  3. Committen Sie Ihre Änderungen (git commit -am 'Add some feature')
  4. Pushen Sie zum Branch (git push origin my-new-feature)
  5. Erstellen Sie einen neuen Pull Request

Lizenz

Weitere Informationen finden Sie in der Lizenz-Datei.

Support