Tomba MCP

oficial

Tomba, seu localizador e verificador de e-mails B2B exclusivo, fornece um banco de dados de leads distinto para escalar o alcance de forma fácil e eficaz.

GitHub
8

O que você pode fazer com Tomba MCP?

  • Encontrar e-mails de contato — Solicite todos os endereços de e-mail vinculados a um domínio via domain_search, com filtros como departamento ou país.
  • Gerar endereços prováveis — Use email_finder para construir e-mails prováveis a partir do nome de uma pessoa e do domínio da empresa.
  • Verificar entregabilidade — Verifique se um e-mail é válido e entregável com email_verifier, incluindo verificações SMTP e MX.
  • Enriquecer dados de contato — Obtenha perfis detalhados (nome, cargo, redes sociais) para um e-mail conhecido usando email_enrichment.
  • Descobrir e-mails de autores — Extraia o e-mail do autor de um artigo a partir de uma URL com author_finder.

Documentação

Tomba Tomba.io MCP Server

Um servidor Model Context Protocol (MCP) para integração com a API do Tomba.io. Este servidor oferece recursos abrangentes de descoberta, verificação e enriquecimento de e-mails por meio de uma interface MCP padronizada.

Recursos

Ferramentas (28 disponíveis)

Descoberta de E-mail

  • Domain Search: Encontre todos os endereços de e-mail associados a um domínio
  • Email Finder: Gere endereços de e-mail prováveis a partir de nomes e domínios
  • Author Finder: Descubra endereços de e-mail de autores de artigos
  • LinkedIn Finder: Encontre e-mails a partir de URLs de perfis do LinkedIn
  • Email Count: Obtenha o total de e-mails de domínios
  • Email Sources: Encontre onde um endereço de e-mail foi encontrado na web
  • Email Format: Obtenha os padrões de formato de e-mail usados por um domínio

Verificação

  • Email Verifier: Verifique a entregabilidade do e-mail e a presença no banco de dados

Enriquecimento

Telefone

  • Phone Finder: Pesquise números de telefone por e-mail, domínio ou LinkedIn
  • Phone Validator: Valide números de telefone e verifique informações da operadora

Inteligência de Domínio

  • Domain Status: Verifique se um domínio é webmail ou descartável
  • Autocomplete: Sugestões de nomes de empresas com logotipo e informações de domínio
  • Similar Finder: Encontre domínios semelhantes com base em um domínio alvo
  • Technology Finder: Descubra as pilhas de tecnologia usadas por sites
  • Location: Obtenha a contagem de funcionários por país

Pesquisa de Empresas

  • Companies Search: Pesquise empresas usando consultas em linguagem natural com filtros avançados

Conta e Gerenciamento

  • Account Info: Obtenha informações atuais da conta, plano e créditos
  • Usage Info: Obtenha estatísticas de uso da API em todos os endpoints
  • List Flags: Liste sinalizações de dados enviadas com status e reembolsos de créditos
  • Create Flag: Reporte dados incorretos (hard bounces, e-mails inválidos) para recuperação de créditos
  • List Leads: Liste leads com filtro opcional por domínio
  • Create Lead: Adicione um novo lead a uma lista
  • List Keys: Liste chaves de API
  • Get Logs: Obtenha registros recentes de solicitações à API

Recursos (7 disponíveis)

  • tomba://api/status - Status da API e informações da conta
  • tomba://domain/{domain} - Informações do domínio
  • tomba://email/{email} - Informações do e-mail
  • tomba://similar/{domain} - Análise de domínios semelhantes
  • tomba://technology/{domain} - Informações da pilha de tecnologia
  • tomba://docs/api - Documentação da API
  • tomba://docs/tools - Documentação das ferramentas

Prompts (16 fluxos de trabalho pré-construídos)

  • find_contact - Encontre informações completas de contato de uma pessoa
  • verify_email_list - Verifique endereços de e-mail em lote
  • research_company - Pesquise contatos e estrutura de uma empresa
  • enrich_lead - Enriqueça um lead com todos os dados disponíveis
  • find_journalists - Encontre contatos de jornalistas a partir de artigos
  • phone_finder - Encontre números de telefone para contatos
  • validate_phone - Valide um número de telefone
  • competitor_analysis - Analise concorrentes usando domínios e tecnologias semelhantes
  • technology_audit - Auditoria abrangente de tecnologia de um site
  • domain_insights - Obtenha insights abrangentes sobre um domínio, incluindo contagem de e-mails e tecnologia
  • bulk_domain_research - Pesquise vários domínios para contagens de e-mails e informações básicas
  • find_target_companies - Encontre empresas com filtros avançados (porte, tipo, receita, setor)
  • market_research - Pesquise empresas em um segmento de mercado com filtragem abrangente
  • lead_generation - Gere leads encontrando empresas e seus contatos
  • prospect_enrichment - Enriqueça prospects de empresas com dados abrangentes
  • industry_analysis - Analise empresas dentro de um setor com segmentação detalhada

Opções de Filtro para Prompts de Pesquisa de Empresas

FiltroValores Disponíveis
Porte1-10 (Micro), 11-50 (Pequena), 51-250 (Média), 251-1K (Média-grande), 1K-5K (Grande), 5K-10K (Muito grande), 10K-50K (Enterprise), 50K-100K (Massiva), 100K+ (Global)
Tipoeducation, government, nonprofit, private, public, personal
Receita$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
SetorBaseado nos Códigos de Setor do LinkedIn V2 (mais de 140 setores, incluindo Software de Computador, Serviços Financeiros, Hospital e Saúde, etc.)

Desempenho e Confiabilidade

Tempo Limite

Todas as chamadas de API têm um tempo limite de 120 segundos. As buscas do Tomba são executadas em tempo real contra a infraestrutura ativa — os tempos de resposta variam com a velocidade do servidor SMTP da empresa alvo, a capacidade de resposta do site e a profundidade da detecção de catch-all.

Nova Tentativa com Backoff Exponencial

Todas as chamadas de API tentam automaticamente novamente até 3 vezes com backoff exponencial em:

  • 429 Too Many Requests (limite de taxa excedido)
  • 5xx erros de servidor

Atrasos de nova tentativa: 1s → 2s → 4s.

Limites de Taxa

Os limites de taxa são aplicados por endpoint e por plano:

PlanoPor SegundoPor MinutoPor Dia
Free125
Basic350500
Growth5801,000
Pro81504,000
Planos 50.000+IlimitadoIlimitadoIlimitado

Nenhum crédito é cobrado quando o Tomba não consegue fornecer um resultado. Solicitações duplicadas dentro de 30 dias não são contadas novamente.

Opções de Transporte

  • stdio - Entrada/saída padrão (padrão, para Claude Desktop)
  • http - Servidor HTTP com endpoints REST

Instalação

Pré-requisitos

Capturas de Tela

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Nota: O pacote npm foi renomeado de tomba-mcp-server para @tomba-io/tomba-mcp-server. Atualize suas configurações de acordo.

Opção 1: Instalar via NPX (Recomendado)

A maneira mais fácil de usar o servidor Tomba MCP é via npx, que não exige clonar o repositório:

macOS/Linux

Adicione ao seu 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

Adicione ao seu 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: O sinalizador -y aceita automaticamente o prompt de instalação, e o npx sempre buscará a versão mais recente.

Opção 2: Instalar a partir do Código-Fonte

Se você quiser modificar o servidor ou contribuir para o desenvolvimento:

# 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

Configuração

Habilidade OpenClaw

Este repositório inclui habilidades locais do workspace em skills/. O plugin do Cursor (.cursor-plugin/plugin.json) também as carrega.

skills/tomba-contact-intelligence/SKILL.md é a habilidade principal. Ela ajuda o agente a escolher as ferramentas Tomba MCP corretas para descoberta de contatos, pesquisa de empresas, verificação de e-mails, consulta de telefones e fluxos de trabalho de enriquecimento de prospects.

Cada ferramenta MCP também tem sua própria pasta de habilidade, skills/tomba-<tool-name>/SKILL.md. Cada uma cobre as entradas da ferramenta, o fluxo de trabalho, a saída esperada e um exemplo de chamada:

GrupoHabilidades
Emailtomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
Descobertatomba-domain-search, tomba-author-finder, tomba-linkedin-finder
Telefonetomba-phone-finder, tomba-phone-validator
Empresatomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
Enriquecimentotomba-person-enrichment, tomba-combined-enrichment
Leadstomba-list-leads, tomba-create-lead
Qualidade de dadostomba-list-flags, tomba-create-flag
Contatomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

Para usar:

  1. Abra este repositório como seu espaço de trabalho do OpenClaw, ou copie os diretórios skills/tomba-* que você precisa para o diretório de habilidades do OpenClaw.
  2. Certifique-se de que o servidor MCP do Tomba MCP esteja configurado e disponível para o OpenClaw.
  3. Inicie uma nova sessão do OpenClaw para que a habilidade seja carregada.

Exemplos de prompts:

  • "Encontre o melhor contato para parcerias em stripe.com e verifique o e-mail antes de retorná-lo."
  • "Pesquise empresas de fintech na Alemanha e identifique possíveis contatos de vendas para as principais correspondências."
  • "Enriqueça este prospect com e-mail, telefone, tecnologia da empresa e concorrentes semelhantes: jane@acme.com"

Plugin do Claude Code

Este repositório também é um marketplace de plugins do Claude Code (.claude-plugin/). O plugin agrupa todas as habilidades em skills/ e se conecta ao servidor MCP hospedado em https://mcp.tomba.io/mcp:

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

Em seguida, execute /mcp e autentique o servidor tomba com OAuth. Nenhuma chave de API é necessária. As habilidades do plugin têm namespace, por exemplo, /tomba:tomba-domain-search zapier.com.

Plugin do Codex

.codex-plugin/plugin.json empacota as mesmas habilidades para o OpenAI Codex. Ele carrega o servidor remoto de .mcp.json. Após instalar o plugin, faça login com OAuth:

codex mcp login tomba

Para usar chaves de API em vez de OAuth, envie os cabeçalhos X-Tomba-Key e X-Tomba-Secret, ou Authorization: Bearer <base64(ta_key:ts_secret)>, para https://mcp.tomba.io/mcp.

Configuração do Claude Desktop

Para usar este servidor com o Claude Desktop, adicione a configuração ao seu arquivo claude_desktop_config.json.

Usando NPX (Recomendado)

Este método usa automaticamente a versão publicada mais recente:

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 Instalação Local

Se você compilou a partir do código-fonte, use o caminho absoluto para sua instalação:

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:

  • Substitua your-api-key-here e your-secret-key-here pelas suas credenciais reais da API do Tomba
  • Para instalação local, substitua /ABSOLUTE/PATH/TO/tomba-mcp-server pelo caminho completo para o diretório de sua instalação
  • Reinicie o Claude Desktop após atualizar a configuração

Obtendo Credenciais da API do Tomba

  1. Visite https://tomba.io
  2. Crie uma conta ou faça login
  3. Navegue até seu painel de controle
  4. Vá para as configurações da API
  5. Copie sua chave de API e chave secreta

Alternativa: Usando Transporte HTTP

Para transporte HTTP com 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 com instalação 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

Opções de Linha de Comando

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 Autônomo

Você também pode executar o servidor como um serviço HTTP autônomo:

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

Endpoints da API HTTP

  • POST /mcp - Enviar solicitações JSON-RPC
  • GET /mcp - Eventos enviados pelo servidor para notificações (requer cabeçalho X-Session-Id)
  • DELETE /mcp - Encerrar uma sessão (requer cabeçalho X-Session-Id)
  • GET /health - Endpoint de verificação de saúde
  • GET /sessions - Listar sessões ativas (requer autenticação)

Exemplo de Solicitação 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
  }'

🔧 Desenvolvimento

Comandos de Desenvolvimento

# 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

🔍 Depuração e Testes

MCP Inspector (Recomendado)

A maneira mais fácil de testar e depurar seu servidor MCP:

# Build and launch MCP Inspector
yarn debug

Isso abre uma interface web onde você pode:

  • 📋 Visualizar todas as ferramentas disponíveis
  • 🧪 Testar ferramentas interativamente
  • 📊 Inspecionar solicitações/respostas
  • 🐛 Depurar em tempo real

Métodos Alternativos de Depuração

# 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

Depuração no VS Code

Se você usa o VS Code, use as configurações de depuração incluídas:

  • Depurar Servidor MCP: Depura o JavaScript compilado
  • Depurar TypeScript: Depura o código-fonte TypeScript diretamente
  • Depurar com Inspector: Depura com o MCP Inspector
  • Executar Testes: Depura testes Jest

Consulte DEBUG_GUIDE.md para instruções abrangentes de depuração.

🧪 Testando Ferramentas Individuais

1. Busca de Domínio

Busca endereços de e-mail associados a um nome de domínio.

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

Resposta:

{
  "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. Localizador de E-mail

Gera endereços de e-mail prováveis a partir de domínio, nome e sobrenome.

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

Resposta:

{
    "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 E-mail

Verifica a entregabilidade do endereço de e-mail e verifica a presença no banco de dados.

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

Resposta:

{
    "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. Enriquecimento de E-mail

Enriquece um endereço de e-mail com informações de contato adicionais.

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

Resposta:

{
    "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. Localizador de Autor

Encontra endereços de e-mail de autores de artigos a partir de uma URL.

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

Resposta:

{
    "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. Localizador do LinkedIn

Encontra endereços de e-mail a partir de URLs de perfis do LinkedIn.

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

Resposta:

{
    "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. Localizador de Telefone

Busca números de telefone com base em e-mail, domínio ou perfil do LinkedIn.

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

Resposta:

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

Valida números de telefone e verifica informações da operadora.

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

Resposta:

{
    "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. Contagem de E-mails

Obtém o número total de endereços de e-mail para um domínio.

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

Resposta:

{
    "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. Localizador de Semelhantes

Encontra domínios semelhantes com base em um domínio específico.

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

Resposta:

{
    "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. Localizador de Tecnologia

Revela instantaneamente a pilha de tecnologia de qualquer site.

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

Resposta:

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

12. Busca de Empresas

Busca empresas usando consultas em linguagem natural com filtros avançados, incluindo localização, setor, tamanho e receita.

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

Resposta:

{
    "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 Disponíveis:

  • location_city: Filtrar por cidade com arrays de incluir/excluir
  • location_state: Filtrar por estado com arrays de incluir/excluir
  • location_country: Filtrar por país com arrays de incluir/excluir
  • industry: Filtrar por setor (com base nos Códigos de Setor do LinkedIn V2 - mais de 140 setores)
  • type: Filtrar por tipo de empresa: education, government, nonprofit, private, public, personal
  • size: Filtrar por tamanho da empresa: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Filtrar por faixa de receita: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Filtrar por ano de fundação com arrays de incluir/excluir
  • keywords: Filtrar por palavras-chave com arrays de incluir/excluir
  • sic: Filtrar por códigos SIC com arrays de incluir/excluir
  • naics: Filtrar por códigos NAICS com arrays de incluir/excluir
  • similar: Filtrar por domínios semelhantes com arrays de incluir/excluir

Limitação de Taxa e Uso

Limites de Taxa da API

O Tomba.io implementa limitação de taxa com base no seu plano de assinatura:

  • Plano Gratuito: 50 solicitações por mês
  • Plano Growth: 5.000 solicitações por mês + 10.000 solicitações de verificação
  • Plano Pro: 10.000 solicitações por mês
  • Plano Enterprise: 50.000 solicitações por mês
  • Plano Personalizado: Limites personalizados

Saiba mais sobre Planos de Preços do Tomba.

Cabeçalhos de Limite de Taxa

Cada resposta da API inclui informações de limite de taxa:

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

Saiba mais sobre Limites de Taxa da API do Tomba.

Lidando com Limites de Taxa

Quando você excede seu limite de taxa, a API retorna um status 429 Too Many Requests com:

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

Melhores Práticas

  1. Monitore o Uso: Verifique seu painel em tomba.io/dashboard
  2. Implemente Backoff: Lide com respostas 429 com backoff exponencial
  3. Operações em Lote: Use a busca de domínio para vários e-mails do mesmo domínio
  4. Cache de Resultados: Armazene resultados localmente para evitar solicitações duplicadas
  5. Planeje Adequadamente: Atualize seu plano com base nos padrões de uso

Dicas de Uso

  • A busca por domínio retorna vários e-mails por solicitação (mais eficiente do que consultas individuais)
  • A verificação de e-mail consome créditos apenas para formatos de e-mail válidos
  • O localizador de telefones pode retornar vários números por solicitação
  • O enriquecimento fornece dados abrangentes em uma única solicitação

Solução de Problemas

Servidor Não Inicia no Claude Desktop

  1. Verifique a versão do Node.js: Certifique-se de ter Node.js 18 ou superior

    node --version

  2. Usando NPX:

    • Certifique-se de ter uma conexão estável com a internet na primeira execução
    • A flag -y deve aceitar automaticamente a instalação
    • O NPX armazenará o pacote em cache após o primeiro uso

  3. Usando Instalação Local:

    • Verifique se o caminho absoluto está correto na sua configuração
    • Certifique-se de que server/index.js existe: ls -la server/index.js
    • Certifique-se de que você executou yarn build com sucesso

  4. Verifique as credenciais da API: Certifique-se de que suas chaves de API do Tomba estão corretas

  5. Verifique os logs do Claude:

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

Problemas Específicos do NPX

"comando npx não encontrado":

  • Certifique-se de que o npm está instalado: npm --version
  • O NPX vem com npm 5.2.0+, atualize se necessário: npm install -g npm

Pacote não encontrado:

  • Verifique se o pacote está publicado: npm view @tomba-io/tomba-mcp-server
  • Tente limpar o cache do npm: npm cache clean --force

Sempre baixando o pacote:

  • Este é um comportamento normal com a flag -y
  • O NPX armazena o pacote em cache após o primeiro download
  • Para uma instalação permanente, use o método de instalação local

Erros de Autenticação

  • Verifique suas chaves de API em https://app.tomba.io/dashboard
  • Certifique-se de que as variáveis de ambiente estão configuradas corretamente na configuração
  • Verifique se sua assinatura da API está ativa

Ferramentas Não Respondendo

  • Verifique os limites de taxa da API do Tomba
  • Verifique a conectividade de rede
  • Revise os logs do servidor para mensagens de erro

Sobre a Tomba

Fundada em 2020, a Tomba se orgulha de ser a fonte mais confiável, precisa e aprofundada de dados de endereços de e-mail disponível em qualquer lugar. Processamos terabytes de dados para produzir nossa API de localização de e-mails.

image

Contribuindo

  1. Faça um fork (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Crie sua branch de funcionalidade (git checkout -b my-new-feature)
  3. Faça commit das suas alterações (git commit -am 'Add some feature')
  4. Envie para a branch (git push origin my-new-feature)
  5. Crie um novo Pull Request

Licença

Consulte o arquivo Licença para mais informações.

Suporte