Enrichments.io

Encontre pessoas, empresas e enriqueça dados em 10+ provedores.

Ver em enrichments.ioExperimente este MCPPatrocinado

Documentação

Enrichments executa um servidor Model Context Protocol, para que um agente no Claude, ChatGPT, Cursor ou Codex possa encontrar e enriquecer pessoas e empresas como chamadas de ferramenta comuns — sem código de integração, sem SDK. Ele autentica com a mesma chave de API que a API REST e cobra no mesmo saldo de créditos, cobrando apenas pelos dados efetivamente retornados.

Endpoint

O quê	Onde
Endpoint MCP	`https://www.enrichments.io/api/mcp`
Transporte	Streamable HTTP (POST, com respostas SSE)
Autenticação	`Authorization: Bearer` com uma chave de API da Enrichments
Documento de descoberta	`/.well-known/oauth-protected-resource`

O documento de descoberta é os metadados de recurso protegido RFC 9728 para o endpoint. Ele é servido para clientes que o procuram; nada sobre a conexão exige que você o busque manualmente.

Criar uma chave de API

Ferramentas

Ferramenta	O que faz	Custo	Escopo
`search_people`	Encontra pessoas que correspondem a uma descrição de perfil de cliente ideal — cargos, senioridade, departamento, localização, empregador. Retorna quem são, não seus endereços de e-mail.	Gasta créditos	`enrich:write`
`enrich_people`	Resolve identificadores que você já possui — uma URL do LinkedIn, um e-mail ou um nome mais empregador — em registros completos de pessoas, até 100 por chamada. É também daqui que vêm os endereços de e-mail de trabalho: peça-os com fields: ["email"].	Gasta créditos	`enrich:write`
`search_companies`	Encontra empresas que correspondem a uma descrição — setor, porte, localização, ano de fundação.	Gasta créditos	`enrich:write`
`enrich_companies`	Resolve domínios, nomes ou URLs do LinkedIn em registros de empresas — descrição, setor, número de funcionários, localização, ano de fundação — até 100 por chamada.	Gasta créditos	`enrich:write`
`get_job`	Consulta um job iniciado por qualquer ferramenta de busca ou enriquecimento e percorre seus resultados. Grátis — consultar não gasta créditos.	Grátis	`enrich:read`
`search`	Alias do ChatGPT Deep Research. Uma busca de dez resultados que retorna ids citáveis; Claude e outros clientes podem ignorá-la.	Gasta créditos	`enrich:write`
`fetch`	Alias do ChatGPT Deep Research. Lê o registro por trás de um id de busca. Grátis — retorna algo que já foi pago.	Grátis	`enrich:read`

Solicitações pequenas respondem inline. As maiores são enfileiradas: a ferramenta retorna um id de job com results: null, e o agente consulta get_job até que done seja verdadeiro. Consultar é grátis.

email nunca é retornado a menos que seja nomeado em fields. É o único campo caro e é cobrado por endereço efetivamente encontrado, então o formato pretendido de uma execução é: descobrir sem ele, decidir quais linhas você quer e então fazer uma chamada enrich_people pedindo-o exatamente nessas linhas.

O que retorna

Campos de pessoas: email, linkedin_url, title, seniority, department, location, country, company, company_domain, headline, phone, company_profile.

Campos de empresas: company, company_domain, linkedin_url, location, country, headline, além de firmographics que acompanham qualquer linha de empresa.

Cada campo é descrito na referência da API, que é gerada a partir dos mesmos esquemas com os quais essas ferramentas validam.

Conectando um cliente

Todos os clientes abaixo autenticam da mesma forma: uma chave de API, criada no aplicativo e mostrada uma vez, enviada como Authorization: Bearer. Uma chave pertence a uma organização, não a uma pessoa, e carrega escopos — uma nova chave contém ambos os escopos de enriquecimento, então todas as ferramentas acima podem ser chamadas com ela.

Claude, Cursor e qualquer coisa que aceite uma URL MCP remota

Aponte o cliente para o endpoint e forneça o cabeçalho. No Cursor, isso é ~/.cursor/mcp.json para cada projeto, ou .cursor/mcp.json dentro de um repositório. Em um cliente Claude que aceita uma URL de conector personalizada, adicione o endpoint e, onde a opção de cabeçalhos de solicitação for oferecida, o mesmo cabeçalho.

mcp.json

{
  "mcpServers": {
    "enrichments": {
      "url": "https://www.enrichments.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ek_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop e outros clientes somente stdio

Um cliente que não consegue alcançar um servidor remoto diretamente faz a ponte via stdio. A ponte é uma conveniência de desenvolvimento, não parte deste produto. Adicione o bloco abaixo ao arquivo de configuração do Claude Desktop para sua plataforma, saia completamente do Claude Desktop e reabra-o.

claude_desktop_config.json

{
  "mcpServers": {
    "enrichments": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://www.enrichments.io/api/mcp",
        "--header", "Authorization: Bearer ek_live_xxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}

ChatGPT e a API Responses

Declare o servidor inline em uma solicitação da API Responses e passe a chave em authorization. Deep Research chama apenas search e fetch, que este servidor registra com as formas que a OpenAI documenta.

Solicitação da API Responses

{
  "model": "gpt-5",
  "tools": [
    {
      "type": "mcp",
      "server_label": "enrichments",
      "server_url": "https://www.enrichments.io/api/mcp",
      "authorization": "Bearer ek_live_xxxxxxxxxxxxxxxxxxxx",
      "require_approval": "never"
    }
  ],
  "input": "Find heads of platform engineering at German fintech companies."
}

Adicionar o servidor pelo diálogo de conector do aplicativo ChatGPT ainda não é suportado: esse fluxo espera que o servidor autentique via OAuth, e o fluxo de código de autorização não está disponível aqui. Use um cliente que possa enviar um cabeçalho Authorization fixo.

Codex

O Codex lê seus servidores de ~/.codex/config.toml. A forma stdio funciona em todas as versões; uma build com suporte direto a Streamable HTTP remoto pode usar o endpoint e o cabeçalho em vez disso.

~/.codex/config.toml

[mcp_servers.enrichments]
command = "npx"
args = [
  "-y", "mcp-remote", "https://www.enrichments.io/api/mcp",
  "--header", "Authorization: Bearer ek_live_xxxxxxxxxxxxxxxxxxxx",
]

O que o servidor recusará

Números de celular estão disponíveis como o campo phone\ e são cobrados por número encontrado. 15 aliases comuns — mobile, cell, direct dial, telephone e os demais — resolvem para ele em vez de falhar. Diferente de um endereço de e-mail, um número não carrega veredito de entregabilidade, porque nada verifica um telefone da forma como uma caixa de correio pode ser verificada.
Um número de telefone estar disponível não é aconselhamento de que é legal ligar. Obrigações sob TCPA, registros DNC e regras locais de consentimento são do chamador.
O catálogo de campos é fechado. Uma solicitação de qualquer coisa fora dos 12 campos de pessoas é um erro de validação, não uma coluna vazia.
Endereços de e-mail são endereços de trabalho encontrados em fontes públicas. Dados de contato pessoal não fazem parte do catálogo.
O enriquecimento é ao vivo, não um banco de dados estático licenciado, então a mesma consulta pode legitimamente retornar dados diferentes amanhã.

As recusas são erros de validação na borda com uma frase explicando-as, não colunas vazias — um agente que pede um número de telefone é informado claramente de que não há campo de telefone, o que impede que ele tente novamente em loop.

Perguntas

Qual é a URL do servidor MCP da Enrichments?

https://www.enrichments.io/api/mcp. Ele fala o Model Context Protocol sobre Streamable HTTP e autentica com uma chave de API da Enrichments enviada como cabeçalho Authorization: Bearer.

Quais ferramentas o servidor MCP expõe?

7 ferramentas: search_people, enrich_people, search_companies, enrich_companies, get_job, search, fetch. As duas últimas são aliases exigidos pelo ChatGPT Deep Research; outros clientes podem ignorá-las.

Posso conectá-lo ao Claude?

Sim. Um cliente Claude que aceita uma URL de conector remota pode apontar diretamente para o endpoint e fornecer a chave de API como cabeçalho Authorization. O Claude Desktop, que lê um arquivo de configuração local, conecta-se através da ponte stdio mcp-remote.

Posso conectá-lo ao ChatGPT?

Sim, declarando o servidor inline em uma solicitação da API Responses com a chave de API no campo authorization. O próprio diálogo de conector do aplicativo ChatGPT ainda não é suportado, porque esse fluxo espera que o servidor autentique via OAuth e o fluxo de código de autorização não está disponível aqui.

Chamar as ferramentas MCP gasta créditos?

As ferramentas de busca e enriquecimento gastam créditos, cobrando apenas pelos dados efetivamente retornados; consultar um job e buscar um registro que você já pagou são grátis. Cada ferramenta anuncia isso ao cliente através da dica somente leitura do MCP, então um cliente que aprova automaticamente ferramentas somente leitura não pode gastar seu saldo sem supervisão.

O servidor MCP retorna números de telefone?

Números de celular são retornados como o campo phone\, cobrados por número encontrado, e nunca carregam um veredito de entregabilidade.

Preços por unidade entregue estão em preços; o contrato REST está na referência da API.