Tomba MCP Server

oficial

Tomba, your unique B2B email finder and verifier, provides a distinctive lead database for effortless and effective outreach scaling.

GitHub
7

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 completas de descubrimiento, verificación y enriquecimiento de correos electrónicos a través de una interfaz MCP estandarizada.

Características

Herramientas (12 disponibles)

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 por lotes direcciones de correo electrónico
  • research_company - Investiga contactos y estructura de la empresa
  • enrich_lead - Enriquece un lead 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 completa de un sitio web
  • domain_insights - Obtén información completa sobre un dominio incluyendo 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 completo
  • lead_generation - Genera leads encontrando empresas y sus contactos
  • prospect_enrichment - Enriquece prospectos de empresa con datos completos
  • 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 (Empresarial), 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 Códigos de Industria de LinkedIn V2 (más de 140 industrias incluyendo Software, Servicios Financieros, Hospital y Salud, 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

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

La forma más fácil de usar el servidor MCP de Tomba 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-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-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 aviso 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 MCP de Tomba adecuadas para flujos de trabajo de descubrimiento de contactos, investigación de empresas, verificación de correos, búsqueda de teléfonos y enriquecimiento de prospectos.

Para usarla:

  1. Abre este repositorio como tu espacio de trabajo 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 antes de devolverlo."
  • "Investiga empresas fintech en Alemania, luego identifica contactos de ventas probables para las mejores coincidencias."
  • "Enriquece este prospecto con correo, teléfono, tecnología de la empresa y competidores similares: [email protected]"

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

Windows (%APPDATA%\Claude\claude_desktop_config.json):

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

Usando Instalación Local

Si has construido 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 API y Clave Secreta

Alternativa: Usando Transporte HTTP

Para transporte HTTP con npx:

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

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 cabecera X-Session-Id)
  • DELETE /mcp - Terminar una sesión (requiere cabecera X-Session-Id)
  • GET /health - Endpoint de verificación de estado
  • 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 de forma interactiva
  • 📊 Inspeccionar solicitudes/respuestas
  • 🐛 Depurar en tiempo real

Métodos de Depuración Alternativos

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

  • Debug MCP Server: Depura el JavaScript compilado
  • Debug TypeScript: Depura el código fuente TypeScript directamente
  • Debug with Inspector: Depura con el Inspector MCP
  • Run Tests: Depura las pruebas de Jest

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

🧪 Probando Herramientas Individuales

1. Búsqueda de Dominio

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": "[email protected]",
        "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 de dominio, nombre y apellido.

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

Respuesta:

{
    "data": {
        "email": "[email protected]",
        "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 entregabilidad de la dirección de correo y comprueba la presencia en la base de datos.

{
    "name": "email_verifier",
    "arguments": {
        "email": "[email protected]"
    }
}

Respuesta:

{
    "data": {
        "email": {
            "email": "[email protected]",
            "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": "[email protected]"
    }
}

Respuesta:

{
    "data": {
        "email": "[email protected]",
        "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 desde una URL.

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

Respuesta:

{
    "data": {
        "email": "[email protected]",
        "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 desde URLs de perfiles de LinkedIn.

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

Respuesta:

{
    "data": {
        "email": "[email protected]",
        "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 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

Obtiene 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ía

Revela instantáneamente 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 incluyendo 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 arrays de inclusión/exclusión
  • location_state: Filtrar por estado con arrays de inclusión/exclusión
  • location_country: Filtrar por país con arrays de inclusión/exclusión
  • industry: Filtrar por industria (basado en 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 arrays de inclusión/exclusión
  • keywords: Filtrar por palabras clave con arrays de inclusión/exclusión
  • sic: Filtrar por códigos SIC con arrays de inclusión/exclusión
  • naics: Filtrar por códigos NAICS con arrays de inclusión/exclusión
  • similar: Filtrar por dominios similares con arrays de inclusión/exclusión

Límites de Uso y Consumo

Límites de la API

Tomba.io implementa límites de uso basados en 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

Más información sobre Planes de Precios de Tomba.

Cabeceras de Límite de Uso

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

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

Más información sobre Límites de la API de Tomba.

Manejo de Límites de Uso

Cuando excedes tu límite de uso, 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 Reintentos: Maneja respuestas 429 con retroceso exponencial
  3. Operaciones por Lotes: Usa la búsqueda de dominio para múltiples correos del mismo dominio
  4. Almacena en Caché: Guarda resultados localmente para evitar solicitudes duplicadas
  5. Planifica Adecuadamente: Actualiza 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 exitosamente

  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-mcp-server
  • Intenta limpiar la caché de npm: npm cache clean --force

Siempre descargando el paquete:

  • Este es el 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 correctamente configuradas
  • Verifica que tu suscripción a la API esté activa

Las Herramientas No Responden

  • Verifica tus límites de uso de la API de Tomba
  • Verifica la conectividad de red
  • Revisa los registros del servidor en busca de 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 disponibles en cualquier lugar. Procesamos terabytes de datos para producir nuestra API de búsqueda de correos electrónicos.

image

Contribuir

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

Licencia

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

Soporte