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 ?

Découvrir des adresses e-mail par domaine — Utilisez domain_search pour trouver toutes les adresses e-mail associées à un domaine d’entreprise, avec des filtres optionnels par département et pays.
Générer et vérifier des e-mails professionnels — Utilisez email_finder pour deviner l’e-mail d’une personne à partir de son nom et de son domaine, puis email_verifier pour vérifier la délivrabilité.
Enrichir un contact à partir d’un e-mail — Utilisez email_enrichment pour rechercher le nom, le poste, l’entreprise, le profil LinkedIn et le statut de vérification d’une personne à partir d’une adresse e-mail.
Trouver l’auteur d’un article — Utilisez author_finder pour découvrir l’e-mail et les coordonnées de l’auteur d’un article à partir de son URL.
Rechercher des entreprises avec des filtres avancés — Utilisez companies_search pour trouver des entreprises par localisation, secteur, taille, chiffre d’affaires ou mots-clés.
Révéler la pile technologique d’un site web — Utilisez technology_finder pour identifier les outils et plateformes avec lesquels un domaine est construit.

Documentation

Serveur MCP Tomba.io

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

Fonctionnalités

Outils (12 disponibles)

Recherche de domaine : Trouver toutes les adresses email associées à un domaine
Recherche d'email : Générer des adresses email probables à partir de noms et de domaines
Vérificateur d'email : Vérifier la délivrabilité des emails et la présence dans la base de données
Enrichissement d'email : Enrichir les emails avec des données de contact supplémentaires
Recherche d'auteur : Découvrir les adresses email des auteurs d'articles
Recherche LinkedIn : Trouver des emails à partir d'URL de profils LinkedIn
Recherche de téléphone : Rechercher des numéros de téléphone par email, domaine ou LinkedIn
Validateur de téléphone : Valider les numéros de téléphone et vérifier les informations de l'opérateur
Compteur d'emails : Obtenir le nombre total d'emails pour des domaines
Recherche similaire : Trouver des domaines similaires en fonction d'un domaine cible
Recherche de technologies : Découvrir les piles technologiques utilisées par les sites web
Recherche d'entreprises : Rechercher des entreprises à l'aide de requêtes en langage naturel avec des filtres avancés

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'email
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 flux de travail prédéfinis)

find_contact - Trouver les informations de contact complètes d'une personne
verify_email_list - Vérifier par lots des adresses email
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
finder_phone - 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 en utilisant les domaines similaires et la technologie
technology_audit - Audit technologique complet d'un site web
domain_insights - Obtenir des informations complètes sur un domaine, y compris le nombre d'emails et la technologie
bulk_domain_research - Rechercher plusieurs domaines pour le nombre d'emails 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 un 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 (Enterprise), 50K-100K (Massive), 100K+ (Globale)
Type	education, government, nonprofit, private, public, personal
Revenus	$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
Secteur	Basé sur les codes de secteur LinkedIn V2 (plus de 140 secteurs, y compris logiciels informatiques, services financiers, hôpitaux et soins de santé, etc.)

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 (S'inscrire ici)

Captures d'écran

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Option 1 : Installer via NPX (Recommandé)

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

macOS/Linux

Ajouter à votre claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json) :

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

Windows

Ajouter à votre claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json) :

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

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

Option 2 : Installer à partir des sources

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 désormais une compétence OpenClaw locale à l'espace de travail dans skills/tomba-contact-intelligence/SKILL.md.

La compétence est conçue pour aider OpenClaw à choisir les bons outils MCP Tomba pour la découverte de contacts, la recherche d'entreprises, la vérification d'emails, la recherche de téléphone et les flux de travail d'enrichissement de prospects.

Pour l'utiliser :

Ouvrez ce dépôt comme espace de travail OpenClaw, ou copiez le répertoire skills/tomba-contact-intelligence 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 prompts :

"Trouvez le meilleur contact pour les partenariats chez stripe.com et vérifiez l'email avant de le retourner."
"Recherchez des entreprises fintech en Allemagne, puis identifiez les contacts commerciaux probables pour les meilleures correspondances."
"Enrichissez ce prospect avec l'email, le téléphone, la technologie de l'entreprise et les concurrents similaires : jane@acme.com"

Configuration de 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-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-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Utilisation de l'installation locale

Si vous avez construit à 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 l'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

Obtention des 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-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 l'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 en tant que 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

Inspecteur MCP (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 :

Debug MCP Server : Déboguer le JavaScript compilé
Debug TypeScript : Déboguer directement la source TypeScript
Debug with Inspector : Déboguer avec l'inspecteur MCP
Run Tests : Déboguer les tests Jest

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

🧪 Test des outils individuels

1. Recherche de domaine

Rechercher des adresses email 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'email

Générer des adresses email 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'email

Vérifier la délivrabilité d'une adresse email et la présence dans la 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'email

Enrichir une adresse email 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

Trouver les adresses email 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

Trouver des adresses email à partir d'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

Rechercher des numéros de téléphone en fonction de l'email, du domaine ou du 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

Valider les numéros de téléphone et vérifier 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. Compteur d'emails

Obtenir le nombre total d'adresses email 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 similaire

Trouver des domaines similaires en fonction 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éler 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

Rechercher des entreprises à l'aide de requêtes en langage naturel avec des filtres avancés incluant la localisation, le secteur, la taille et les revenus.

{
    "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 de secteur 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 revenus : $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

Limitation de débit et utilisation

Limites de débit de l'API

Tomba.io met en œuvre une limitation de débit en fonction de votre plan d'abonnement :

Plan Gratuit : 50 requêtes par mois
Plan Growth : 5 000 requêtes par mois + 10 000 requêtes de vérification
Plan Pro : 10 000 requêtes par mois
Plan Enterprise : 50 000 requêtes par mois
Plan Personnalisé : Limites personnalisées

En savoir plus sur les Plans tarifaires Tomba.

En-têtes de limite de débit

Chaque réponse de l'API inclut des informations sur la limite 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
    }
}

Meilleures pratiques

Surveiller l'utilisation : Vérifiez votre tableau de bord sur tomba.io/dashboard
Implémenter le backoff : Gérez les réponses 429 avec un backoff exponentiel
Opérations par lots : Utilisez la recherche de domaine pour plusieurs emails du même domaine
Mettre en cache les résultats : Stockez les résultats localement pour éviter les requêtes en double
Planifier en conséquence : Mettez à niveau votre plan en fonction des modèles d'utilisation

Conseils d'utilisation

La recherche de domaine renvoie plusieurs emails par requête (plus efficace que les recherches individuelles)
La vérification d'email consomme des crédits uniquement pour les formats d'email valides
La recherche de téléphone 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 supérieur
```
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 en cache le paquet après la première utilisation
Utilisation de l'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 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-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 en cache le paquet 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 vos limites de débit de l'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 de données d'adresses email la plus fiable, la plus précise et la plus approfondie disponible. Nous traitons des téraoctets de données pour produire notre API de recherche d'email.

Contribuer

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

Licence

Veuillez consulter le fichier Licence pour plus d'informations.