Tomba MCP

oficial

Tomba, tu buscador y verificador único de correos electrónicos B2B, proporciona una base de datos de prospectos distintiva para escalar el alcance de manera sencilla y efectiva.

GitHub
8
Prueba este MCPPatrocinado

¿Qué puedes hacer con Tomba MCP?

  • Buscar direcciones de correo electrónico para un dominio — Solicita todos los contactos de una empresa mediante domain_search, con filtros como departamento o país.
  • Generar el correo electrónico de una persona — Usa email_finder para construir una dirección probable a partir de un nombre y un dominio, y luego verifícala.
  • Verificar la entregabilidad del correo electrónico — Comprueba si una dirección es válida y segura para enviar mensajes usando email_verifier.
  • Enriquecer un perfil de contacto — Obtén el cargo, la empresa y los enlaces a redes sociales de un correo electrónico con email_enrichment.
  • Descubrir la pila tecnológica de una empresa — Identifica las herramientas y plataformas que usa un sitio web mediante technology_finder.
  • Encontrar empresas similares — Usa similar_finder para localizar dominios comparables con fines de prospección o análisis.

Documentación

Tomba Servidor MCP de Tomba.io

Un servidor de Protocolo de Contexto de Modelo (MCP) para integrarse con la API de Tomba.io. Este servidor proporciona capacidades integrales de descubrimiento, verificación y enriquecimiento de correos electrónicos a través de una interfaz MCP estandarizada.

Características

Herramientas (28 disponibles)

Descubrimiento de Correos Electrónicos

  • Búsqueda de Dominio: Encuentra todas las direcciones de correo electrónico asociadas con un dominio
  • Buscador de Correos: Genera direcciones de correo electrónico probables a partir de nombres y dominios
  • Buscador de Autores: Descubre direcciones de correo electrónico de autores de artículos
  • Buscador de LinkedIn: Encuentra correos electrónicos a partir de URLs de perfiles de LinkedIn
  • Conteo de Correos: Obtén el total de correos electrónicos para dominios
  • Fuentes de Correos: Encuentra dónde se encontró una dirección de correo electrónico en la web
  • Formato de Correo: Obtén los patrones de formato de correo electrónico utilizados por un dominio

Verificación

  • Verificador de Correos: Verifica la capacidad de entrega del correo electrónico y comprueba la presencia en la base de datos

Enriquecimiento

Teléfono

Inteligencia de Dominios

Búsqueda de Empresas

Cuenta y Gestión

  • Información de Cuenta: Obtén información actual de la cuenta, plan y créditos
  • Información de Uso: Obtén estadísticas de uso de la API en todos los endpoints
  • Listar Marcas: Lista las marcas de datos enviadas con estado y reembolsos de créditos
  • Crear Marca: Reporta datos incorrectos (rebotes duros, correos inválidos) para recuperación de créditos
  • Listar Prospectos: Lista prospectos con filtro opcional de dominio
  • Crear Prospecto: Agrega un nuevo prospecto a una lista
  • Listar Claves: Lista las claves de API
  • Obtener Registros: Obtén registros recientes de solicitudes de API

Recursos (7 disponibles)

  • tomba://api/status - Estado de la API e información de la cuenta
  • tomba://domain/{domain} - Información del dominio
  • tomba://email/{email} - Información del correo electrónico
  • tomba://similar/{domain} - Análisis de dominios similares
  • tomba://technology/{domain} - Información de la pila tecnológica
  • tomba://docs/api - Documentación de la API
  • tomba://docs/tools - Documentación de herramientas

Prompts (16 flujos de trabajo preconstruidos)

  • find_contact - Encuentra información de contacto completa para una persona
  • verify_email_list - Verifica direcciones de correo electrónico en lote
  • research_company - Investiga contactos y estructura de una empresa
  • enrich_lead - Enriquece un prospecto con todos los datos disponibles
  • find_journalists - Encuentra contactos de periodistas a partir de artículos
  • phone_finder - Encuentra números de teléfono para contactos
  • validate_phone - Valida un número de teléfono
  • competitor_analysis - Analiza competidores usando dominios similares y tecnología
  • technology_audit - Auditoría tecnológica integral de un sitio web
  • domain_insights - Obtén información integral sobre un dominio, incluido el conteo de correos y tecnología
  • bulk_domain_research - Investiga múltiples dominios para conteos de correos e información básica
  • find_target_companies - Encuentra empresas con filtros avanzados (tamaño, tipo, ingresos, industria)
  • market_research - Investiga empresas en un segmento de mercado con filtrado integral
  • lead_generation - Genera prospectos encontrando empresas y sus contactos
  • prospect_enrichment - Enriquece prospectos de empresas con datos integrales
  • industry_analysis - Analiza empresas dentro de una industria con segmentación detallada

Opciones de Filtro para Prompts de Búsqueda de Empresas

FiltroValores Disponibles
Tamaño1-10 (Micro), 11-50 (Pequeña), 51-250 (Mediana), 251-1K (Mediana-grande), 1K-5K (Grande), 5K-10K (Muy grande), 10K-50K (Empresa), 50K-100K (Masiva), 100K+ (Global)
Tipoeducación, gobierno, sin fines de lucro, privada, pública, personal
Ingresos$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
IndustriaBasado en los Códigos de Industria de LinkedIn V2 (más de 140 industrias, incluyendo Software de Computación, Servicios Financieros, Hospitales y Atención Médica, etc.)

Rendimiento y Confiabilidad

Tiempo de Espera

Todas las llamadas a la API tienen un tiempo de espera de 120 segundos. Las búsquedas de Tomba se ejecutan en tiempo real contra infraestructura en vivo: los tiempos de respuesta varían según la velocidad del servidor SMTP de la empresa objetivo, la capacidad de respuesta del sitio web y la profundidad de la detección de captura general.

Reintento con Retroceso Exponencial

Todas las llamadas a la API se reintentan automáticamente hasta 3 veces con retroceso exponencial en:

  • 429 Too Many Requests (límite de velocidad excedido)
  • 5xx errores del servidor

Retrasos de reintento: 1s → 2s → 4s.

Límites de Velocidad

Los límites de velocidad se aplican por endpoint y por plan:

PlanPor SegundoPor MinutoPor Día
Gratis125
Básico350500
Crecimiento5801,000
Pro81504,000
Planes de 50,000+IlimitadoIlimitadoIlimitado

No se cobran créditos cuando Tomba no puede proporcionar un resultado. Las solicitudes duplicadas dentro de 30 días no se cuentan nuevamente.

Opciones de Transporte

  • stdio - Entrada/salida estándar (predeterminado, para Claude Desktop)
  • http - Servidor HTTP con endpoints REST

Instalación

Requisitos Previos

Capturas de Pantalla

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Nota: El paquete npm ha sido renombrado de tomba-mcp-server a @tomba-io/tomba-mcp-server. Actualiza tus configuraciones en consecuencia.

Opción 1: Instalar vía NPX (Recomendado)

La forma más fácil de usar el servidor MCP de Tomba es a través de npx, que no requiere clonar el repositorio:

macOS/Linux

Agrega a tu 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

Agrega a tu 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"
            }
        }
    }
}

Nota: La bandera -y acepta automáticamente el mensaje de instalación, y npx siempre obtendrá la versión más reciente.

Opción 2: Instalar desde el Código Fuente

Si deseas modificar el servidor o contribuir al desarrollo:

# 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

Configuración

Habilidad de OpenClaw

Este repositorio ahora incluye una habilidad de OpenClaw local al espacio de trabajo en skills/tomba-contact-intelligence/SKILL.md.

La habilidad está diseñada para ayudar a OpenClaw a elegir las herramientas MCP de Tomba adecuadas para el descubrimiento de contactos, investigación de empresas, verificación de correos electrónicos, búsqueda de teléfonos y flujos de trabajo de enriquecimiento de prospectos.

Para usarla:

  1. Abre este repositorio como tu espacio de trabajo de OpenClaw, o copia el directorio skills/tomba-contact-intelligence en tu directorio de habilidades de OpenClaw.
  2. Asegúrate de que el servidor MCP de Tomba esté configurado y disponible para OpenClaw.
  3. Inicia una nueva sesión de OpenClaw para que la habilidad se cargue.

Ejemplos de prompts:

  • "Encuentra el mejor contacto para alianzas en stripe.com y verifica el correo electrónico antes de devolverlo."
  • "Investiga empresas fintech en Alemania, luego identifica contactos de ventas probables para las mejores coincidencias."
  • "Enriquece este prospecto con correo electrónico, teléfono, tecnología de la empresa y competidores similares: jane@acme.com"

Configuración de Claude Desktop

Para usar este servidor con Claude Desktop, agrega la configuración a tu archivo claude_desktop_config.json.

Usando NPX (Recomendado)

Este método usa automáticamente la versión publicada más reciente:

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

Usando Instalación Local

Si has compilado desde el código fuente, usa la ruta absoluta a tu instalación:

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

Notas Importantes:

  • Reemplaza your-api-key-here y your-secret-key-here con tus credenciales reales de la API de Tomba
  • Para instalación local, reemplaza /ABSOLUTE/PATH/TO/tomba-mcp-server con la ruta completa a tu directorio de instalación
  • Reinicia Claude Desktop después de actualizar la configuración

Obtención de Credenciales de la API de Tomba

  1. Visita https://tomba.io
  2. Regístrate para obtener una cuenta o inicia sesión
  3. Navega a tu panel de control
  4. Ve a la configuración de la API
  5. Copia tu Clave de API y Clave Secreta

Alternativa: Usando Transporte HTTP

Para transporte HTTP con 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"
            }
        }
    }
}

Para transporte HTTP con instalación local:

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

Uso

Opciones de Línea de Comandos

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

Servidor HTTP Independiente

También puedes ejecutar el servidor como un servicio HTTP independiente:

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

Endpoints de la API HTTP

  • POST /mcp - Envía solicitudes JSON-RPC
  • GET /mcp - Eventos enviados por el servidor para notificaciones (requiere el encabezado X-Session-Id)
  • DELETE /mcp - Termina una sesión (requiere el encabezado X-Session-Id)
  • GET /health - Endpoint de verificación de salud
  • GET /sessions - Lista sesiones activas (requiere autenticación)

Ejemplo de Solicitud 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
  }'

🔧 Desarrollo

Comandos de Desarrollo

# 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

🔍 Depuración y Pruebas

Inspector MCP (Recomendado)

La forma más fácil de probar y depurar tu servidor MCP:

# Build and launch MCP Inspector
yarn debug

Esto abre una interfaz web donde puedes:

  • 📋 Ver todas las herramientas disponibles
  • 🧪 Probar herramientas interactivamente
  • 📊 Inspeccionar solicitudes/respuestas
  • 🐛 Depurar en tiempo real

Métodos Alternativos de Depuración

# 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

Depuración en VS Code

Si usas VS Code, usa las configuraciones de depuración incluidas:

  • Depurar Servidor MCP: Depura el JavaScript compilado
  • Depurar TypeScript: Depura el código fuente de TypeScript directamente
  • Depurar con Inspector: Depura con el Inspector MCP
  • Ejecutar Pruebas: Depura pruebas de Jest

Consulta DEBUG_GUIDE.md para obtener instrucciones integrales de depuración.

🧪 Pruebas de Herramientas Individuales

1. Búsqueda de Dominio

Busca direcciones de correo electrónico asociadas con un nombre de dominio.

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

Respuesta:

{
  "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. Buscador de Correos

Genera direcciones de correo electrónico probables a partir del dominio, nombre y apellido.

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

Respuesta:

{
    "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. Verificador de Correos

Verifica la capacidad de entrega de la dirección de correo electrónico y comprueba la presencia en la base de datos.

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

Respuesta:

{
    "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. Enriquecimiento de Correos

Enriquece una dirección de correo electrónico con información de contacto adicional.

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

Respuesta:

{
    "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. Buscador de Autores

Encuentra direcciones de correo electrónico de autores de artículos a partir de una URL.

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

Respuesta:

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

Encuentra direcciones de correo electrónico a partir de URLs de perfiles de LinkedIn.

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

Respuesta:

{
    "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. Buscador de Teléfonos

Busca números de teléfono basados en correo electrónico, dominio o perfil de LinkedIn.

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

Respuesta:

{
    "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. Validador de Teléfonos

Valida números de teléfono y verifica información del operador.

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

Respuesta:

{
    "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. Conteo de Correos

Obtén el número total de direcciones de correo electrónico para un dominio.

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

Respuesta:

{
    "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. Buscador de Similares

Encuentra dominios similares basados en un dominio específico.

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

Respuesta:

{
    "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. Buscador de Tecnologías

Descubre al instante el stack tecnológico de cualquier sitio web.

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

Respuesta:

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

12. Búsqueda de Empresas

Busca empresas usando consultas en lenguaje natural con filtros avanzados que incluyen ubicación, industria, tamaño e ingresos.

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

Respuesta:

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

Filtros Disponibles:

  • location_city: Filtrar por ciudad con arreglos de inclusión/exclusión
  • location_state: Filtrar por estado con arreglos de inclusión/exclusión
  • location_country: Filtrar por país con arreglos de inclusión/exclusión
  • industry: Filtrar por industria (basado en LinkedIn Industry Codes V2 - más de 140 industrias)
  • type: Filtrar por tipo de empresa: education, government, nonprofit, private, public, personal
  • size: Filtrar por tamaño de empresa: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Filtrar por rango de ingresos: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Filtrar por año de fundación con arreglos de inclusión/exclusión
  • keywords: Filtrar por palabras clave con arreglos de inclusión/exclusión
  • sic: Filtrar por códigos SIC con arreglos de inclusión/exclusión
  • naics: Filtrar por códigos NAICS con arreglos de inclusión/exclusión
  • similar: Filtrar por dominios similares con arreglos de inclusión/exclusión

Límites de Tasa y Uso

Límites de Tasa de la API

Tomba.io implementa límites de tasa según tu plan de suscripción:

  • Plan Gratuito: 50 solicitudes por mes
  • Plan Growth: 5,000 solicitudes por mes + 10,000 solicitudes de verificación
  • Plan Pro: 10,000 solicitudes por mes
  • Plan Enterprise: 50,000 solicitudes por mes
  • Plan Personalizado: Límites personalizados

Obtén más información sobre Planes de Precios de Tomba.

Encabezados de Límite de Tasa

Cada respuesta de la API incluye información sobre el límite de tasa:

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

Obtén más información sobre Límites de Tasa de la API de Tomba.

Manejo de Límites de Tasa

Cuando superas tu límite de tasa, la API devuelve un estado 429 Too Many Requests con:

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

Mejores Prácticas

  1. Monitorea el Uso: Revisa tu panel en tomba.io/dashboard
  2. Implementa Backoff: Maneja respuestas 429 con backoff exponencial
  3. Operaciones por Lote: Usa la búsqueda de dominios para múltiples correos del mismo dominio
  4. Almacena Resultados en Caché: Guarda resultados localmente para evitar solicitudes duplicadas
  5. Planifica en Consecuencia: Mejora tu plan según los patrones de uso

Consejos de Uso

  • La búsqueda de dominios devuelve múltiples correos por solicitud (más eficiente que búsquedas individuales)
  • La verificación de correos consume créditos solo para formatos de correo válidos
  • El buscador de teléfonos puede devolver múltiples números por solicitud
  • El enriquecimiento proporciona datos completos en una sola solicitud

Solución de Problemas

El Servidor No Se Inicia en Claude Desktop

  1. Verifica la versión de Node.js: Asegúrate de tener Node.js 18 o superior

    node --version

  2. Usando NPX:

    • Asegúrate de tener una conexión a internet estable para la primera ejecución
    • La bandera -y debería aceptar automáticamente la instalación
    • NPX almacenará el paquete en caché después del primer uso

  3. Usando Instalación Local:

    • Verifica que la ruta absoluta sea correcta en tu configuración
    • Asegúrate de que server/index.js exista: ls -la server/index.js
    • Asegúrate de haber ejecutado yarn build correctamente

  4. Verifica las credenciales de la API: Asegúrate de que tus claves de API de Tomba sean correctas

  5. Revisa los registros de Claude:

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

Problemas Específicos de NPX

"comando npx no encontrado":

  • Asegúrate de que npm esté instalado: npm --version
  • NPX viene con npm 5.2.0+, actualiza si es necesario: npm install -g npm

Paquete no encontrado:

  • Verifica que el paquete esté publicado: npm view @tomba-io/tomba-mcp-server
  • Intenta limpiar la caché de npm: npm cache clean --force

Descarga constante del paquete:

  • Esto es un comportamiento normal con la bandera -y
  • NPX almacena el paquete en caché después de la primera descarga
  • Para una instalación permanente, usa el método de instalación local

Errores de Autenticación

  • Verifica tus claves de API en https://app.tomba.io/dashboard
  • Asegúrate de que las variables de entorno estén configuradas correctamente en la configuración
  • Verifica que tu suscripción a la API esté activa

Herramientas Que No Responden

  • Revisa los límites de tasa de tu API de Tomba
  • Verifica la conectividad de red
  • Revisa los registros del servidor para ver mensajes de error

Acerca de Tomba

Fundada en 2020, Tomba se enorgullece de ser la fuente más confiable, precisa y profunda de datos de direcciones de correo electrónico disponible en cualquier lugar. Procesamos terabytes de datos para producir nuestra API de búsqueda de correos.

image

Contribuciones

  1. Haz un fork (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Crea tu rama de características (git checkout -b my-new-feature)
  3. Haz commit de tus cambios (git commit -am 'Add some feature')
  4. Haz push a la rama (git push origin my-new-feature)
  5. Crea una nueva Pull Request

Licencia

Consulta el archivo de Licencia para obtener más información.

Soporte