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

¿Qué puedes hacer con Tomba MCP?

  • Buscar correos de contacto — Solicita todas las direcciones de correo asociadas a un dominio mediante domain_search, con filtros como departamento o país.
  • Generar direcciones probables — Usa email_finder para construir correos probables a partir del nombre de una persona y el dominio de la empresa.
  • Verificar entregabilidad — Comprueba si un correo es válido y entregable con email_verifier, incluyendo comprobaciones SMTP y MX.
  • Enriquecer datos de contacto — Obtén perfiles detallados (nombre, cargo, redes sociales) para un correo conocido usando email_enrichment.
  • Descubrir correos de autores — Extrae el correo del autor de un artículo desde una URL con author_finder.

Documentación

Tomba Servidor MCP de Tomba.io

Un servidor de Model Context Protocol (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

Verificación

Enriquecimiento

Teléfono

Inteligencia de dominios

Búsqueda de empresas

Cuenta y gestión

  • Información de la 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 banderas: Lista las banderas de datos enviadas con estado y reembolsos de créditos
  • Crear bandera: Reporta datos incorrectos (rebotes duros, correos electrónicos inválidos) para recuperación de créditos
  • Listar leads: Lista leads con filtro opcional por dominio
  • Crear lead: Agrega un nuevo lead a una lista
  • Listar claves: Lista 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 lead 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 utilizando 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 electrónicos y tecnología
  • bulk_domain_research - Investiga múltiples dominios para conteos de correos electrónicos 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 leads 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 catch-all.

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 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 incluye habilidades locales del espacio de trabajo en skills/. El plugin de Cursor (.cursor-plugin/plugin.json) también las carga.

skills/tomba-contact-intelligence/SKILL.md es la habilidad principal. Ayuda al agente 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.

Cada herramienta MCP también tiene su propia carpeta de habilidad, skills/tomba-<tool-name>/SKILL.md. Cada una cubre las entradas de la herramienta, el flujo de trabajo, la salida esperada y un ejemplo de llamada:

GrupoHabilidades
Emailtomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
Descubrimientotomba-domain-search, tomba-author-finder, tomba-linkedin-finder
Teléfonotomba-phone-finder, tomba-phone-validator
Empresatomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
Enriquecimientotomba-person-enrichment, tomba-combined-enrichment
Prospectostomba-list-leads, tomba-create-lead
Calidad de datostomba-list-flags, tomba-create-flag
Cuentatomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

Para usarlo:

  1. Abre este repositorio como tu espacio de trabajo de OpenClaw, o copia los directorios skills/tomba-* que necesites 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 antes de devolverlo."
  • "Investiga empresas fintech en Alemania y luego identifica posibles contactos de ventas para las mejores coincidencias."
  • "Enriquece este prospecto con correo, teléfono, tecnología de la empresa y competidores similares: jane@acme.com"

Plugin para Claude Code

Este repositorio también es un mercado de plugins para Claude Code (.claude-plugin/). El plugin agrupa todas las habilidades en skills/ y se conecta al servidor MCP alojado en https://mcp.tomba.io/mcp:

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

Luego ejecuta /mcp y autentica el servidor tomba con OAuth. No se necesitan claves API. Las habilidades del plugin tienen espacios de nombres, por ejemplo /tomba:tomba-domain-search zapier.com.

Plugin para Codex

.codex-plugin/plugin.json empaqueta las mismas habilidades para OpenAI Codex. Carga el servidor remoto desde .mcp.json. Después de instalar el plugin, inicia sesión con OAuth:

codex mcp login tomba

Para usar claves API en lugar de OAuth, envía los encabezados X-Tomba-Key y X-Tomba-Secret, o Authorization: Bearer <base64(ta_key:ts_secret)>, a https://mcp.tomba.io/mcp.

Configuración con Claude Desktop

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

Usando NPX (Recomendado)

Este método usa automáticamente la última versión publicada:

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

Obtener 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 API
  5. Copia tu Clave de API y tu 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 estado
  • 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 de forma interactiva
  • 📊 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 completas de depuración.

🧪 Pruebas de Herramientas Individuales

1. Búsqueda de Dominio

Busca direcciones de correo 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 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 una dirección de correo y comprueba su 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 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 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 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, 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 comprueba la 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 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

Revela al instante la pila tecnológica 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: Filtra por ciudad con matrices de incluir/excluir
  • location_state: Filtra por estado con matrices de incluir/excluir
  • location_country: Filtra por país con matrices de incluir/excluir
  • industry: Filtra por industria (basado en los Códigos de Industria de LinkedIn V2 - más de 140 industrias)
  • type: Filtra por tipo de empresa: education, government, nonprofit, private, public, personal
  • size: Filtra por tamaño de empresa: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Filtra por rango de ingresos: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Filtra por año de fundación con matrices de incluir/excluir
  • keywords: Filtra por palabras clave con matrices de incluir/excluir
  • sic: Filtra por códigos SIC con matrices de incluir/excluir
  • naics: Filtra por códigos NAICS con matrices de incluir/excluir
  • similar: Filtra por dominios similares con matrices de incluir/excluir

Límites de Velocidad y Uso

Límites de Velocidad de la API

Tomba.io implementa límites de velocidad 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 Velocidad

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

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

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

Manejo de Límites de Velocidad

Cuando superas tu límite de velocidad, 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 de control en tomba.io/dashboard
  2. Implementa Retroceso: Maneja las respuestas 429 con retroceso exponencial
  3. Operaciones por Lotes: Usa la búsqueda de dominio para múltiples correos del mismo dominio
  4. Almacena Resultados en Caché: Guarda los 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 electrónicos por solicitud (más eficiente que búsquedas individuales)
  • La verificación de correos electrónicos solo consume créditos 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á en caché el paquete 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

"npx command not found":

  • 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:

  • Este es un comportamiento normal con la bandera -y
  • NPX almacena en caché el paquete 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

  • Verifica los límites de velocidad 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 electrónicos.

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. Realiza tus cambios (git commit -am 'Add some feature')
  4. Envía a la rama (git push origin my-new-feature)
  5. Crea una nueva solicitud de extracción

Licencia

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

Soporte