Tomba MCP

officiel

Tomba, votre outil unique de recherche et de vérification d'e-mails B2B, fournit une base de données de prospects distinctive pour un développement de prospection sans effort et efficace.

GitHub

Que pouvez-vous faire avec Tomba MCP ?

Trouver les e-mails de contact — Demandez toutes les adresses e-mail associées à un domaine via domain_search, avec des filtres comme le département ou le pays.
Générer des adresses probables — Utilisez email_finder pour construire des e-mails plausibles à partir du nom d'une personne et du domaine de l'entreprise.
Vérifier la délivrabilité — Vérifiez si un e-mail est valide et délivrable avec email_verifier, y compris les contrôles SMTP et MX.
Enrichir les données de contact — Récupérez des profils détaillés (nom, poste, réseaux sociaux) pour un e-mail connu avec email_enrichment.
Découvrir les e-mails d'auteurs — Extrayez l'e-mail de l'auteur d'un article à partir d'une URL avec author_finder.

Documentation

Serveur MCP Tomba.io

Un serveur Model Context Protocol (MCP) pour l'intégration avec l'API Tomba.io. Ce serveur offre des capacités complètes de découverte, vérification et enrichissement d'e-mails via une interface MCP standardisée.

Fonctionnalités

Outils (28 disponibles)

Découverte d'e-mails

Domain Search : Trouver toutes les adresses e-mail associées à un domaine
Email Finder : Générer des adresses e-mail probables à partir de noms et de domaines
Author Finder : Découvrir les adresses e-mail des auteurs d'articles
LinkedIn Finder : Trouver des e-mails à partir d'URLs de profils LinkedIn
Email Count : Obtenir le nombre total d'e-mails pour des domaines
Email Sources : Trouver où une adresse e-mail a été trouvée sur le web
Email Format : Obtenir les modèles de format d'e-mail utilisés par un domaine

Vérification

Email Verifier : Vérifier la délivrabilité des e-mails et la présence en base de données

Enrichissement

Email Enrichment : Enrichir les e-mails avec des données de contact supplémentaires
Person Enrichment : Trouver des données sur une personne par e-mail (nom, poste, profils sociaux)
Company Enrichment : Trouver des données sur une entreprise par domaine (secteur, taille, localisation)
Combined Enrichment : Enrichissement combiné personne + entreprise par e-mail

Téléphone

Phone Finder : Rechercher des numéros de téléphone par e-mail, domaine ou LinkedIn
Phone Validator : Valider les numéros de téléphone et vérifier les informations de l'opérateur

Intelligence de domaine

Domain Status : Vérifier si un domaine est webmail ou jetable
Autocomplete : Suggestions de noms d'entreprises avec logo et informations de domaine
Similar Finder : Trouver des domaines similaires basés sur un domaine cible
Technology Finder : Découvrir les piles technologiques utilisées par les sites web
Location : Obtenir le nombre d'employés par pays

Recherche d'entreprises

Companies Search : Rechercher des entreprises à l'aide de requêtes en langage naturel avec des filtres avancés

Compte et gestion

Account Info : Obtenir les informations actuelles du compte, le plan et les crédits
Usage Info : Obtenir les statistiques d'utilisation de l'API sur tous les points de terminaison
List Flags : Lister les indicateurs de données soumis avec statut et remboursements de crédits
Create Flag : Signaler des données incorrectes (rebonds durs, e-mails invalides) pour récupération de crédits
List Leads : Lister les prospects avec filtre de domaine optionnel
Create Lead : Ajouter un nouveau prospect à une liste
List Keys : Lister les clés API
Get Logs : Obtenir les journaux récents de requêtes API

Ressources (7 disponibles)

tomba://api/status - Statut de l'API et informations du compte
tomba://domain/{domain} - Informations sur le domaine
tomba://email/{email} - Informations sur l'e-mail
tomba://similar/{domain} - Analyse des domaines similaires
tomba://technology/{domain} - Informations sur la pile technologique
tomba://docs/api - Documentation de l'API
tomba://docs/tools - Documentation des outils

Prompts (16 workflows pré-construits)

find_contact - Trouver des informations de contact complètes pour une personne
verify_email_list - Vérifier par lot des adresses e-mail
research_company - Rechercher les contacts et la structure d'une entreprise
enrich_lead - Enrichir un prospect avec toutes les données disponibles
find_journalists - Trouver les contacts de journalistes à partir d'articles
phone_finder - Trouver des numéros de téléphone pour des contacts
validate_phone - Valider un numéro de téléphone
competitor_analysis - Analyser les concurrents à l'aide de domaines similaires et de technologies
technology_audit - Audit technologique complet d'un site web
domain_insights - Obtenir des informations complètes sur un domaine, y compris le nombre d'e-mails et la technologie
bulk_domain_research - Rechercher plusieurs domaines pour les nombres d'e-mails et les informations de base
find_target_companies - Trouver des entreprises avec des filtres avancés (taille, type, revenus, secteur)
market_research - Rechercher des entreprises dans un segment de marché avec filtrage complet
lead_generation - Générer des prospects en trouvant des entreprises et leurs contacts
prospect_enrichment - Enrichir les prospects d'entreprise avec des données complètes
industry_analysis - Analyser les entreprises d'un secteur avec une segmentation détaillée

Options de filtre pour les prompts de recherche d'entreprises

Filtre	Valeurs disponibles
Taille	1-10 (Micro), 11-50 (Petite), 51-250 (Moyenne), 251-1K (Moyenne-grande), 1K-5K (Grande), 5K-10K (Très grande), 10K-50K (Entreprise), 50K-100K (Massive), 100K+ (Mondiale)
Type	éducation, gouvernement, à but non lucratif, privé, public, personnel
Revenus	0$–1M$, 1M$–10M$, 10M$–50M$, 50M$–100M$, 100M$–250M$, 250M$–500M$, 500M$–1B$, 1B$–10B$, 10B$+
Secteur	Basé sur les codes sectoriels LinkedIn V2 (140+ secteurs, y compris logiciels informatiques, services financiers, hôpitaux et soins de santé, etc.)

Performance et fiabilité

Délai d'attente

Tous les appels API ont un délai d'attente de 120 secondes. Les recherches Tomba s'exécutent en temps réel sur une infrastructure en direct — les temps de réponse varient selon la vitesse du serveur SMTP de l'entreprise cible, la réactivité du site web et la profondeur de la détection de boîtes génériques.

Nouvelle tentative avec backoff exponentiel

Tous les appels API réessaient automatiquement jusqu'à 3 fois avec backoff exponentiel sur :

429 Too Many Requests (limite de débit dépassée)
5xx erreurs de serveur

Délais de nouvelle tentative : 1s → 2s → 4s.

Limites de débit

Les limites de débit sont appliquées par point de terminaison et par plan :

Plan	Par seconde	Par minute	Par jour
Gratuit	1	2	5
Basic	3	50	500
Growth	5	80	1 000
Pro	8	150	4 000
Plans 50 000+	Illimité	Illimité	Illimité

Aucun crédit n'est débité lorsque Tomba ne peut pas fournir de résultat. Les demandes en double dans les 30 jours ne sont pas comptées à nouveau.

Options de transport

stdio - Entrée/sortie standard (par défaut, pour Claude Desktop)
http - Serveur HTTP avec points de terminaison REST

Installation

Prérequis

Node.js 18 ou supérieur
npm ou yarn
Compte API Tomba (Inscription ici)

Captures d'écran

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Remarque : Le paquet npm a été renommé de tomba-mcp-server à @tomba-io/tomba-mcp-server. Veuillez mettre à jour vos configurations en conséquence.

Option 1 : Installation via NPX (recommandé)

Le moyen le plus simple d'utiliser le serveur MCP Tomba est via npx, ce qui ne nécessite pas de cloner le dépôt :

macOS/Linux

Ajoutez à votre 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

Ajoutez à votre 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"
            }
        }
    }
}

Remarque : L'indicateur -y accepte automatiquement l'invite d'installation, et npx récupérera toujours la dernière version.

Option 2 : Installation depuis la source

Si vous souhaitez modifier le serveur ou contribuer au développement :

# 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

Configuration

Compétence OpenClaw

Ce dépôt inclut des compétences locales à l'espace de travail dans skills/. Le plugin Cursor (.cursor-plugin/plugin.json) les charge également.

skills/tomba-contact-intelligence/SKILL.md est la compétence principale. Elle aide l'agent à choisir les bons outils MCP Tomba pour la découverte de contacts, la recherche d'entreprises, la vérification d'e-mails, la recherche de téléphones et les workflows d'enrichissement de prospects.

Chaque outil MCP possède également son propre dossier de compétence, skills/tomba-<tool-name>/SKILL.md. Chacun couvre les entrées de l'outil, le workflow, la sortie attendue et un exemple d'appel :

Groupe	Compétences
Email	`tomba-email-finder`, `tomba-email-verifier`, `tomba-email-enrichment`, `tomba-email-count`, `tomba-email-sources`, `tomba-email-format`
Découverte	`tomba-domain-search`, `tomba-author-finder`, `tomba-linkedin-finder`
Téléphone	`tomba-phone-finder`, `tomba-phone-validator`
Entreprise	`tomba-companies-search`, `tomba-company-enrichment`, `tomba-similar-finder`, `tomba-technology-finder`, `tomba-autocomplete`, `tomba-location`, `tomba-domain-status`
Enrichissement	`tomba-person-enrichment`, `tomba-combined-enrichment`
Prospects	`tomba-list-leads`, `tomba-create-lead`
Qualité des données	`tomba-list-flags`, `tomba-create-flag`
Compte	`tomba-account-info`, `tomba-usage-info`, `tomba-list-keys`, `tomba-get-logs`

Pour l'utiliser :

Ouvrez ce dépôt comme espace de travail OpenClaw, ou copiez les répertoires skills/tomba-* dont vous avez besoin dans votre répertoire de compétences OpenClaw.
Assurez-vous que le serveur MCP Tomba est configuré et disponible pour OpenClaw.
Démarrez une nouvelle session OpenClaw pour que la compétence soit chargée.

Exemples de requêtes :

« Trouvez le meilleur contact pour des partenariats chez stripe.com et vérifiez l'e-mail avant de le renvoyer. »
« Recherchez des entreprises fintech en Allemagne, puis identifiez les contacts commerciaux probables pour les meilleurs résultats. »
« Enrichissez ce prospect avec l'e-mail, le téléphone, la technologie de l'entreprise et les concurrents similaires : jane@acme.com »

Plugin Claude Code

Ce dépôt est également une place de marché de plugins Claude Code (.claude-plugin/). Le plugin regroupe toutes les compétences dans skills/ et se connecte au serveur MCP hébergé à https://mcp.tomba.io/mcp :

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

Exécutez ensuite /mcp et authentifiez le serveur tomba avec OAuth. Aucune clé API n'est nécessaire. Les compétences du plugin sont espacées de noms, par exemple /tomba:tomba-domain-search zapier.com.

Plugin Codex

.codex-plugin/plugin.json regroupe les mêmes compétences pour OpenAI Codex. Il charge le serveur distant depuis .mcp.json. Après l'installation du plugin, connectez-vous avec OAuth :

codex mcp login tomba

Pour utiliser des clés API au lieu d'OAuth, envoyez les en-têtes X-Tomba-Key et X-Tomba-Secret, ou Authorization: Bearer <base64(ta_key:ts_secret)>, à https://mcp.tomba.io/mcp.

Configuration Claude Desktop

Pour utiliser ce serveur avec Claude Desktop, ajoutez la configuration à votre fichier claude_desktop_config.json.

Utilisation de NPX (recommandé)

Cette méthode utilise automatiquement la dernière version publiée :

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

Utilisation d'une installation locale

Si vous avez compilé à partir des sources, utilisez le chemin absolu vers votre 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"
            }
        }
    }
}

Remarques importantes :

Remplacez your-api-key-here et your-secret-key-here par vos véritables identifiants API Tomba
Pour une installation locale, remplacez /ABSOLUTE/PATH/TO/tomba-mcp-server par le chemin complet vers votre répertoire d'installation
Redémarrez Claude Desktop après avoir mis à jour la configuration

Obtenir les identifiants API Tomba

Visitez https://tomba.io
Créez un compte ou connectez-vous
Accédez à votre tableau de bord
Allez dans les paramètres API
Copiez votre clé API et votre clé secrète

Alternative : utilisation du transport HTTP

Pour le transport HTTP avec 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"
            }
        }
    }
}

Pour le transport HTTP avec une installation locale :

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

Utilisation

Options de ligne de commande

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

Serveur HTTP autonome

Vous pouvez également exécuter le serveur comme service HTTP autonome :

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

Points de terminaison de l'API HTTP

POST /mcp - Envoyer des requêtes JSON-RPC
GET /mcp - Événements envoyés par le serveur pour les notifications (nécessite l'en-tête X-Session-Id)
DELETE /mcp - Terminer une session (nécessite l'en-tête X-Session-Id)
GET /health - Point de terminaison de vérification de l'état
GET /sessions - Lister les sessions actives (nécessite une authentification)

Exemple de requête 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
  }'

🔧 Développement

Commandes de développement

# 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

🔍 Débogage et tests

MCP Inspector (recommandé)

Le moyen le plus simple de tester et de déboguer votre serveur MCP :

# Build and launch MCP Inspector
yarn debug

Cela ouvre une interface web où vous pouvez :

📋 Voir tous les outils disponibles
🧪 Tester les outils de manière interactive
📊 Inspecter les requêtes/réponses
🐛 Déboguer en temps réel

Méthodes de débogage alternatives

# 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

Débogage VS Code

Si vous utilisez VS Code, utilisez les configurations de débogage incluses :

Déboguer le serveur MCP : Déboguez le JavaScript compilé
Déboguer TypeScript : Déboguez directement la source TypeScript
Déboguer avec Inspector : Déboguez avec MCP Inspector
Exécuter les tests : Déboguez les tests Jest

Consultez DEBUG_GUIDE.md pour des instructions complètes de débogage.

🧪 Test des outils individuels

1. Recherche de domaine

Recherchez les adresses e-mail associées à un nom de domaine.

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

Réponse :

{
  "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. Recherche d'e-mail

Générez des adresses e-mail probables à partir du domaine, du prénom et du nom.

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

Réponse :

{
    "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. Vérificateur d'e-mail

Vérifiez la délivrabilité des adresses e-mail et la présence en base de données.

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

Réponse :

{
    "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. Enrichissement d'e-mail

Enrichissez une adresse e-mail avec des informations de contact supplémentaires.

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

Réponse :

{
    "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. Recherche d'auteur

Trouvez les adresses e-mail des auteurs d'articles à partir d'une URL.

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

Réponse :

{
    "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. Recherche LinkedIn

Trouvez les adresses e-mail à partir des URL de profils LinkedIn.

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

Réponse :

{
    "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. Recherche de téléphone

Recherchez des numéros de téléphone à partir d'un e-mail, d'un domaine ou d'un profil LinkedIn.

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

Réponse :

{
    "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. Validateur de téléphone

Validez les numéros de téléphone et vérifiez les informations de l'opérateur.

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

Réponse :

{
    "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. Nombre d'e-mails

Obtenez le nombre total d'adresses e-mail pour un domaine.

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

Réponse :

{
    "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. Recherche de similaires

Trouvez des domaines similaires à partir d'un domaine spécifique.

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

Réponse :

{
    "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. Recherche de technologies

Révélez instantanément la pile technologique de n'importe quel site web.

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

Réponse :

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

12. Recherche d'entreprises

Recherchez des entreprises à l'aide de requêtes en langage naturel avec des filtres avancés incluant la localisation, le secteur, la taille et le chiffre d'affaires.

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

Réponse :

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

Filtres disponibles :

location_city : Filtrer par ville avec des tableaux d'inclusion/exclusion
location_state : Filtrer par état avec des tableaux d'inclusion/exclusion
location_country : Filtrer par pays avec des tableaux d'inclusion/exclusion
industry : Filtrer par secteur (basé sur les codes sectoriels LinkedIn V2 - plus de 140 secteurs)
type : Filtrer par type d'entreprise : education, government, nonprofit, private, public, personal
size : Filtrer par taille d'entreprise : 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
revenue : Filtrer par tranche de chiffre d'affaires : $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
founded : Filtrer par année de création avec des tableaux d'inclusion/exclusion
keywords : Filtrer par mots-clés avec des tableaux d'inclusion/exclusion
sic : Filtrer par codes SIC avec des tableaux d'inclusion/exclusion
naics : Filtrer par codes NAICS avec des tableaux d'inclusion/exclusion
similar : Filtrer par domaines similaires avec des tableaux d'inclusion/exclusion

Limites de débit et utilisation

Limites de débit de l'API

Tomba.io applique des limites de débit en fonction de votre formule d'abonnement :

Formule gratuite : 50 requêtes par mois
Formule Growth : 5 000 requêtes par mois + 10 000 requêtes de vérification
Formule Pro : 10 000 requêtes par mois
Formule Entreprise : 50 000 requêtes par mois
Formule personnalisée : Limites personnalisées

En savoir plus sur les formules tarifaires Tomba.

En-têtes de limites de débit

Chaque réponse API inclut des informations sur les limites de débit :

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

En savoir plus sur les limites de débit de l'API Tomba.

Gestion des limites de débit

Lorsque vous dépassez votre limite de débit, l'API renvoie un statut 429 Too Many Requests avec :

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

Bonnes pratiques

Surveillez l'utilisation : Consultez votre tableau de bord sur tomba.io/dashboard
Implémentez un backoff : Gérez les réponses 429 avec un backoff exponentiel
Opérations par lots : Utilisez la recherche de domaine pour plusieurs e-mails du même domaine
Mettez en cache les résultats : Stockez les résultats localement pour éviter les requêtes en double
Planifiez en conséquence : Améliorez votre formule en fonction de vos habitudes d'utilisation

Conseils d'utilisation

La recherche de domaine renvoie plusieurs e-mails par requête (plus efficace que les recherches individuelles)
La vérification d'e-mails ne consomme des crédits que pour les formats d'e-mails valides
Le chercheur de téléphones peut renvoyer plusieurs numéros par requête
L'enrichissement fournit des données complètes en une seule requête

Dépannage

Le serveur ne démarre pas dans Claude Desktop

Vérifiez la version de Node.js : Assurez-vous d'avoir Node.js 18 ou une version supérieure
```
node --version
```
Utilisation de NPX :
- Assurez-vous d'avoir une connexion Internet stable pour la première exécution
- Le drapeau -y devrait accepter automatiquement l'installation
- NPX mettra le paquet en cache après la première utilisation
Utilisation d'une installation locale :
- Vérifiez que le chemin absolu est correct dans votre configuration
- Assurez-vous que server/index.js existe : ls -la server/index.js
- Assurez-vous d'avoir exécuté yarn build avec succès
Vérifiez les identifiants API : Assurez-vous que vos clés API Tomba sont correctes
Vérifiez les journaux de Claude :
- macOS : ~/Library/Logs/Claude/mcp*.log
- Windows : %APPDATA%\Claude\logs\mcp*.log

Problèmes spécifiques à NPX

« npx command not found » :

Assurez-vous que npm est installé : npm --version
NPX est fourni avec npm 5.2.0+, mettez à jour si nécessaire : npm install -g npm

Paquet introuvable :

Vérifiez que le paquet est publié : npm view @tomba-io/tomba-mcp-server
Essayez de vider le cache npm : npm cache clean --force

Téléchargement systématique du paquet :

C'est un comportement normal avec le drapeau -y
NPX met le paquet en cache après le premier téléchargement
Pour une installation permanente, utilisez la méthode d'installation locale

Erreurs d'authentification

Vérifiez vos clés API sur https://app.tomba.io/dashboard
Assurez-vous que les variables d'environnement sont correctement définies dans la configuration
Vérifiez que votre abonnement API est actif

Les outils ne répondent pas

Vérifiez les limites de débit de votre API Tomba
Vérifiez la connectivité réseau
Consultez les journaux du serveur pour les messages d'erreur

À propos de Tomba

Fondée en 2020, Tomba est fière d'être la source la plus fiable, précise et approfondie de données d'adresses e-mail disponible partout. Nous traitons des téraoctets de données pour produire notre API de recherche d'e-mails.

Contribution

Forkez le projet (https://github.com/tomba-io/tomba-mcp-server/fork)
Créez votre branche de fonctionnalité (git checkout -b my-new-feature)
Commitez vos modifications (git commit -am 'Add some feature')
Poussez vers la branche (git push origin my-new-feature)
Créez une nouvelle demande de tirage (Pull Request)

Licence

Veuillez consulter le fichier Licence pour plus d'informations.