Tomba MCP

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, vérification et enrichissement d'emails via une interface MCP standardisée.

Fonctionnalités

Outils (28 disponibles)

Découverte d'emails

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

Vérification

• Email Verifier : Vérifier la délivrabilité des emails et la présence en base de données

Enrichissement

• Email Enrichment : Enrichir les emails avec des données de contact supplémentaires
• Person Enrichment : Trouver des données sur une personne par email (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 email

Téléphone

• Phone Finder : Rechercher des numéros de téléphone par email, domaine ou LinkedIn
• Phone Validator : Valider les numéros de téléphone et vérifier les informations 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 avec des requêtes en langage naturel et 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 endpoints
• List Flags : Lister les signalements de données soumis avec statut et remboursements de crédits
• Create Flag : Signaler des données incorrectes (hard bounces, emails invalides) pour récupération de crédits
• List Leads : Lister les leads avec filtre de domaine optionnel
• Create Lead : Ajouter un nouveau lead à une liste
• List Keys : Lister les clés API
• Get Logs : Obtenir les journaux récents des 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'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 workflows pré-construits)

• find_contact - Trouver des informations de contact complètes pour une personne
• verify_email_list - Vérifier par lot des adresses email
• research_company - Rechercher les contacts et la structure d'une entreprise
• enrich_lead - Enrichir un lead 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 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 incluant le nombre d'emails et la technologie
• bulk_domain_research - Rechercher plusieurs domaines pour les nombres 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 filtrage complet
• lead_generation - Générer des leads en trouvant des entreprises et leurs contacts
• prospect_enrichment - Enrichir des prospects d'entreprise avec des données complètes
• industry_analysis - Analyser les entreprises d'un secteur avec 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	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 sectoriels LinkedIn V2 (140+ secteurs incluant 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 live — 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 catch-all.

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 serveur

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

Limites de débit

Les limites de débit sont appliquées par endpoint 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 requêtes 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 endpoints REST

Installation

Prérequis

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

Captures d'écran

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 : Le drapeau -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 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éphones et les workflows d'enrichissement de prospects.

Pour l'utiliser :

1. 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.
2. Assurez-vous que le serveur MCP Tomba est configuré et disponible pour OpenClaw.
3. Démarrez une nouvelle session OpenClaw pour que la compétence soit chargée.

Exemples de prompts :

• "Trouve le meilleur contact pour les partenariats chez stripe.com et vérifie l'email avant de le retourner."
• "Recherche des entreprises fintech en Allemagne, puis identifie les contacts de vente probables pour les meilleurs résultats."
• "Enrichis ce prospect avec email, téléphone, technologie d'entreprise et concurrents similaires : jane@acme.com"

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é depuis la source, 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

Obtention des identifiants API Tomba

1. Visitez https://tomba.io
2. Inscrivez-vous pour un compte ou connectez-vous
3. Accédez à votre tableau de bord
4. Allez dans les paramètres API
5. 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 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

Endpoints API HTTP

• POST /mcp - Envoyer des requêtes JSON-RPC
• GET /mcp - Server-Sent Events 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 - Endpoint de vérification de santé
• 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 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 MCP Inspector
• Run Tests : Déboguer les tests Jest

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

🧪 Test des outils individuels

1. Domain Search

Recherchez les 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. Email Finder

Générez 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. Email Verifier

Vérifiez la délivrabilité d'une adresse email 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. Email Enrichment

Enrichissez 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. Author Finder

Trouvez 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. LinkedIn Finder

Trouvez les adresses email à partir d'URLs 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. Phone Finder

Recherchez des numéros de téléphone basés sur l'email, le domaine ou le 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. Phone Validator

Validez les numéros de téléphone et vérifiez les informations 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. Email Count

Obtenez 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 de domaines similaires

Trouvez 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. Détection 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 d'activité, 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 d'activité (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 de l'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

1. Surveillez votre utilisation : Consultez votre tableau de bord sur tomba.io/dashboard
2. Implémentez un backoff : Gérez les réponses 429 avec un backoff exponentiel
3. Opérations par lots : Utilisez la recherche de domaine pour plusieurs e-mails du même domaine
4. Mettez en cache les résultats : Stockez les résultats localement pour éviter les requêtes en double
5. 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

1. Vérifiez la version de Node.js : Assurez-vous d'avoir Node.js 18 ou une version supérieure

   node --version
   

2. Utilisation de NPX :

   • Assurez-vous d'avoir une connexion Internet stable pour la première exécution
   • Le drapeau -y doit accepter automatiquement l'installation
   • NPX mettra le package en cache après la première utilisation

3. 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

4. Vérifiez les identifiants API : Assurez-vous que vos clés API Tomba sont correctes

5. Consultez les journaux Claude :

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

Problèmes spécifiques à NPX

« Commande npx introuvable » :

• 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

Package introuvable :

• Vérifiez que le package 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 package :

• C'est un comportement normal avec le drapeau -y
• NPX met le package 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

Outils qui 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 se targue d'être la source de données d'adresses e-mail la plus fiable, précise et approfondie disponible. Nous traitons des téraoctets de données pour produire notre API de recherche d'e-mails.

Contribution

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

Licence

Veuillez consulter le fichier Licence pour plus d'informations.

Support

• Problèmes GitHub
• Support par e-mail
• Site web