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?

  • Encontrar direcciones de correo por dominio — Solicita listar todos los correos de una empresa mediante domain_search, con paginación y filtros.
  • Generar el correo de una persona — Usa email_finder para construir una dirección probable a partir de un nombre y dominio, y luego verifícala.
  • Verificar la entregabilidad del correo — Comprueba una dirección con email_verifier para conocer estado, puntuación y comprobaciones MX/SMTP.
  • Enriquecer un perfil de contacto — Obtén detalles completos como cargo, LinkedIn y teléfono para un correo usando email_enrichment.
  • Descubrir correos de autores o de LinkedIn — Extrae contactos desde una URL de artículo mediante author_finder o desde un perfil con linkedin_finder.
  • Investigar empresas y stacks tecnológicos — Usa companies_search con filtros, similar_finder para competidores y technology_finder para información sobre el stack.

Documentación

Tomba Tomba.io MCP Server

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 (12 disponibles)

  • Domain Search: Encuentra todas las direcciones de correo electrónico asociadas a un dominio
  • Email Finder: Genera direcciones de correo electrónico probables a partir de nombres y dominios
  • Email Verifier: Verifica la capacidad de entrega del correo electrónico y comprueba la presencia en la base de datos
  • Email Enrichment: Enriquece correos electrónicos con datos de contacto adicionales
  • Author Finder: Descubre direcciones de correo electrónico de autores de artículos
  • LinkedIn Finder: Encuentra correos electrónicos a partir de URLs de perfiles de LinkedIn
  • Phone Finder: Busca números de teléfono por correo electrónico, dominio o LinkedIn
  • Phone Validator: Valida números de teléfono y comprueba la información del operador
  • Email Count: Obtén el número total de correos electrónicos para dominios
  • Similar Finder: Encuentra dominios similares basados en un dominio objetivo
  • Technology Finder: Descubre las pilas tecnológicas utilizadas por los sitios web
  • Companies Search: Busca empresas usando consultas en lenguaje natural con filtros avanzados

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 predefinidos)

  • 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
  • finder_phone - 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, incluyendo recuento de correos electrónicos y tecnología
  • bulk_domain_research - Investiga múltiples dominios para recuentos 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 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ño), 51-250 (Mediano), 251-1K (Mediano-grande), 1K-5K (Grande), 5K-10K (Muy grande), 10K-50K (Empresa), 50K-100K (Masivo), 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, Hospital y Atención Médica, etc.)

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 Tomba MCP es mediante npx, que no requiere clonar el repositorio:

macOS/Linux

Añade 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

Añade 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 última versión.

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 OpenClaw

Este repositorio ahora incluye una habilidad 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 Tomba MCP adecuadas para descubrimiento de contactos, investigación de empresas, verificación de correo electrónico, búsqueda de teléfonos y flujos 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 Tomba MCP 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 posibles contactos de ventas 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, 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 Tomba API
  • 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 Tomba API

  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 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 - Enviar solicitudes JSON-RPC
  • GET /mcp - Eventos enviados por el servidor para notificaciones (requiere el encabezado X-Session-Id)
  • DELETE /mcp - Terminar una sesión (requiere el encabezado X-Session-Id)
  • GET /health - Endpoint de verificación de salud
  • GET /sessions - Listar 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: Depurar el JavaScript compilado
  • Depurar TypeScript: Depurar el código fuente de TypeScript directamente
  • Depurar con Inspector: Depurar con MCP Inspector
  • Ejecutar pruebas: Depurar pruebas de Jest

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

🧪 Prueba de herramientas individuales

1. Domain Search

Busca direcciones de correo electrónico asociadas a 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. Email Finder

Genera direcciones de correo electrónico probables a partir de 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. Email Verifier

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. Email Enrichment

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

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

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. Phone Finder

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. Phone Validator

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. Email Count

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. Similar Finder

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. Technology Finder

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. Companies Search

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 incluir/excluir
  • location_state: Filtrar por estado con arreglos de incluir/excluir
  • location_country: Filtrar por país con arreglos de incluir/excluir
  • industry: Filtrar por industria (basado en los Códigos de Industria de LinkedIn 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 incluir/excluir
  • keywords: Filtrar por palabras clave con arreglos de incluir/excluir
  • sic: Filtrar por códigos SIC con arreglos de incluir/excluir
  • naics: Filtrar por códigos NAICS con arreglos de incluir/excluir
  • similar: Filtrar por dominios similares con arreglos 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 de crecimiento: 5,000 solicitudes por mes + 10,000 solicitudes de verificación
  • Plan Pro: 10,000 solicitudes por mes
  • Plan empresarial: 50,000 solicitudes por mes
  • Plan personalizado: Límites personalizados

Aprende más sobre Planes de precios de Tomba.

Encabezados de límite de velocidad

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

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

Aprende más sobre Límites de velocidad 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. Monitorear Uso: Revisa tu panel en tomba.io/dashboard
  2. Implementar Backoff: Maneja respuestas 429 con backoff exponencial
  3. Operaciones por Lote: Usa búsqueda de dominio para múltiples correos del mismo dominio
  4. Cachear Resultados: Almacena 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 dominio devuelve múltiples correos por solicitud (más eficiente que búsquedas individuales)
  • La verificación de correo 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 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 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 el caché de npm: npm cache clean --force

Siempre descargando el 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 de API esté activa

Herramientas 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 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. 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 un nuevo Pull Request

Licencia

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

Soporte