Coresignal

oficial

Acesse dados B2B ab

GitHub

O que você pode fazer com Coresignal MCP?

Natural-language company search — Ask for B2B SaaS companies in the Nordics with 50–200 employees and recent funding via entity_search.
Field name discovery — Use entity_fields to find exact field names for custom fetches, like locating compensation fields by searching "salary".
Bulk record retrieval — Fetch up to 1,000 full employee or company profiles per call using a cache_id from a prior search with entity_fetch.
Email enrichment — Get verified business emails for up to 1,000 employee IDs at 10 credits per found email using email_enrich.
File-based data delivery — Request large result sets as downloadable files, then page through them in-chat with the free artifact_read tool.

Documentação

Coresignal MCP v2

O servidor oficial Model Context Protocol para Coresignal — traga dados B2B atualizados sobre 895M+ funcionários, 70M+ empresas e 468M+ vagas de emprego diretamente para o seu assistente de IA.

https://mcp.coresignal.com/mcp/v2

Pesquise em linguagem natural, obtenha registros completos, enriqueça contatos com e-mails verificados e exporte grandes conjuntos de resultados como arquivos para download — tudo a partir do Claude, Cursor, Codex, VS Code ou qualquer outro cliente compatível com MCP.

Recursos

Autenticação OAuth 2.1 — faça login com sua conta do painel Coresignal; sem chaves de API em arquivos de configuração.
Pesquisa em linguagem natural com evidências de correspondência em cada linha de resultado, para que você veja por que cada registro foi correspondido.
Transparência de custos — cada resposta informa credits_consumed, e chamadas caras pedem confirmação antes de gastar.
Descoberta de campos — entity_fields encontra os nomes de campos corretos por palavra-chave, gratuitamente, sem carregar o vocabulário completo de mais de 300 campos no contexto.
Downloads de arquivos — grandes conjuntos de resultados são armazenados no servidor e retornados como um link de download em vez de inundar o chat.
artifact_read entrega arquivos de volta à conversa gratuitamente — funciona até em clientes sem acesso ao sistema de arquivos.

Pré-requisitos

Uma conta Coresignal com assinatura ativa (créditos) e uma chave de API de equipe provisionada no painel. O servidor MCP resolve a chave da sua equipe automaticamente após o login — você nunca a cola em um arquivo de configuração. Ainda não tem assinatura? Comece com o teste gratuito de 7 dias — ele inclui 2.000 créditos. Veja a comparação de planos.

Na primeira conexão, seu cliente abre uma janela do navegador para você fazer login no painel Coresignal. Essa é toda a configuração — sem variáveis de ambiente, sem segredos.

Configuração do cliente

Claude Desktop

O Claude Desktop suporta servidores MCP remotos nativamente via Connectors:

Abra Configurações → Connectors → Adicionar conector personalizado.
Nome: Coresignal, URL: https://mcp.coresignal.com/mcp/v2.
Clique em Adicionar e depois em Conectar — uma janela do navegador abre para você fazer login na sua conta do painel Coresignal.

Importante — ative downloads de arquivos: o Claude Desktop bloqueia downloads de domínios que não conhece. Para baixar arquivos de resultados (buscas grandes são entregues como links), adicione mcp.coresignal.com à lista de permissões de domínios nas configurações do Claude Desktop (em planos Team/Enterprise, seu administrador gerencia isso). Sem isso, os links de download do servidor serão bloqueados — embora você sempre possa ler os dados de volta no chat com a ferramenta gratuita artifact_read. Veja Downloads de arquivos.

Claude Code

claude mcp add --transport http coresignal https://mcp.coresignal.com/mcp/v2

Depois, dentro de uma sessão, execute /mcp, selecione coresignal e complete o login no navegador. Execute /mcp novamente sempre que precisar reautenticar.

Codex (OpenAI Codex CLI)

codex mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

Uma janela do navegador abre para você fazer login na sua conta do painel Coresignal.

Cursor

Adicione em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "coresignal": {
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

O Cursor detecta que o servidor exige autenticação e mostra um aviso Needs login — clique nele para completar o login no navegador.

OpenCode

Adicione Coresignal MCP:

opencode mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

Autentique:

opencode mcp auth coresignal

Uma janela do navegador abre para você fazer login na sua conta do painel Coresignal.

Visual Studio Code

Execute MCP: Add Server na Paleta de Comandos, escolha HTTP e insira a URL — ou adicione em .vscode/mcp.json:

{
  "servers": {
    "coresignal": {
      "type": "http",
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

O VS Code pede que você autorize o servidor no primeiro uso e cuida do fluxo OAuth no seu navegador.

Downloads de arquivos e a lista de permissões de domínios

Resultados grandes (e qualquer chamada com delivery="url") não são despejados no chat para economizar tokens de entrada do LLM. Em vez disso, o servidor armazena as linhas como um arquivo e retorna um link de download HTTPS assinado que expira após 1 hora:

{
  "delivery": "url",
  "url": "https://mcp.coresignal.com/mcp/v2/artifacts/…?exp=…&sig=…",
  "artifact_name": "employee_fetch-baf941dd4f8c4dfe.jsonl",
  "count": 500,
  "credits_consumed": 10000
}

A partir daqui, o agente acessa os dados de uma de três maneiras:

O agente baixa o arquivo sozinho — em clientes com acesso ao shell, o agente normalmente curl o link para o disco e analisa o arquivo localmente com grep/jq/pandas.
O agente lê de volta no chat — em clientes sem shell e sem sistema de arquivos, o agente chama artifact_read(artifact_name, offset, limit) em vez disso, paginando o arquivo em fatias pela sessão MCP. Isso é gratuito e funciona em qualquer lugar, então nada inunda o chat.
Você baixa manualmente — se o próprio agente não puder buscar o link (domínio não permitido, sandbox sem acesso à rede), clique no link, salve o arquivo e diga ao agente onde ele está: "Baixei o arquivo para ~/Downloads/employee_fetch-….jsonl — analise a partir daí." Funciona em qualquer cliente que possa ler arquivos locais.

Prefira o download quando seu cliente suportar. artifact_read é gratuito em créditos Coresignal, mas não em tokens de LLM: cada página retornada se torna parte da conversa e é recobrada como token de entrada a cada turno subsequente. Cada página também é limitada a um orçamento fixo de tokens — um registro completo de funcionário tem ~8 mil tokens, então uma única página carrega apenas alguns registros completos, independentemente do limit que você pedir. Ler um arquivo grande dessa forma exige centenas de chamadas e pode esgotar a janela de contexto antes de você chegar ao fim. Um arquivo baixado custa praticamente zero tokens — o assistente pode filtrar milhares de linhas localmente com grep/jq e mostrar apenas a resposta. É por isso que vale a pena configurar downloads logo de início (lista de permissões de domínios, acesso à rede da sandbox) e reservar artifact_read para clientes que não podem baixar ou para dar uma olhada em algumas linhas.

Se os downloads estiverem bloqueados, nada se perde: os registros já estão armazenados e pagos — leia-os com artifact_read. Nunca reexecute uma busca para "recuperar" um arquivo; isso cobra cada registro uma segunda vez.

Ferramentas

Ferramenta	O que faz	Custo
`entity_search`	Pesquisa em linguagem natural sobre funcionários, empresas ou vagas	20 créditos por pesquisa (fixo)
`entity_fields`	Pesquisa por palavra-chave nos ~300 nomes de campos de uma entidade	Gratuito
`entity_fetch`	Obtém registros completos (JSONL) ou projetados, por handle de pesquisa ou por id	20 créditos por registro de funcionário/empresa, 1 por registro de vaga
`email_enrich`	E-mails empresariais verificados para ids de funcionários (CSV)	10 créditos por e-mail encontrado (não encontrados são gratuitos)
`artifact_read`	Pagina linhas de volta de um arquivo entregue	Gratuito

`entity_search`

Pesquisa registros de employee, company ou job com uma consulta em linguagem simples:

"Desenvolvedores Python seniores em empresas de fintech na França"

Cada chamada custa um valor fixo de 20 créditos e retorna:

total_count — o número exato de registros que a consulta correspondeu,
até 20 linhas de pré-visualização (limit=0 retorna apenas a contagem), cada uma mostrando os campos em que a consulta correspondeu — a evidência de por que cada resultado está ali,
um cache_id — um handle de 1 hora para a pesquisa que economiza créditos e tempo: passe-o para entity_fetch e os registros correspondidos são coletados imediatamente — sem necessidade de reexecutar (e repagar) a pesquisa, e resolver o cache_id em si é gratuito. Os ids dos registros ficam no servidor, então nada volumoso passa pela conversa.

`entity_fields`

Consulta gratuita e instantânea de nomes de campos por significado — "salary" encontra os campos de remuneração, "current job title and seniority" encontra active_experience_title, experience.position_title, etc. Use-a para montar a lista de fields para uma busca com escopo personalizado sem carregar o vocabulário completo de campos no contexto.

`entity_fetch`

Coleta registros — até 20 ids escolhidos manualmente nos resultados da pesquisa, ou até 1.000 registros por chamada via um cache_id. A cobrança é por registro encontrado: 20 créditos para funcionários/empresas, 1 para vagas.

`email_enrich`

E-mails empresariais verificados e entregáveis para até 1.000 ids de funcionários — 10 créditos por e-mail encontrado; ids não encontrados são gratuitos. Contatos do EEE/Reino Unido não são acessíveis (GDPR).

`artifact_read`

Lê um arquivo entregue de volta pela sessão MCP autenticada, uma página por vez — gratuito, já que os registros foram cobrados quando foram buscados. É isso que faz a entrega de arquivos funcionar em qualquer lugar, incluindo clientes de chat que não podem abrir um link ou tocar no sistema de arquivos.

Exemplos de prompts

Varredura de mercado

"Encontre empresas B2B SaaS nos países nórdicos com 50–200 funcionários que captaram investimento nos últimos dois anos."

Monte uma lista de leads com e-mails verificados

"Busque heads of data em empresas dos EUA com mais de 500 funcionários. Obtenha 20 perfis completos em um arquivo com e-mails verificados."

Análise aprofundada de uma única empresa**

"Obtenha o registro completo de flo.health — rodadas de financiamento, crescimento de headcount e vagas abertas atuais."

...

Créditos e cobrança

Ação	Créditos
`entity_search` (qualquer `limit`, incluindo 0)	20 por pesquisa
`entity_fetch` — funcionário ou empresa	20 por registro encontrado
`entity_fetch` — vaga	1 por registro encontrado
`email_enrich`	10 por e-mail encontrado; não encontrados gratuitos
`entity_fields`, `artifact_read`	Gratuitos

Cada resposta inclui credits_consumed — o valor real cobrado, então uma discrepância (enviou 1.000 ids, cobrados 950 registros) informa exatamente quantos ids não foram encontrados. O servidor nunca gasta silenciosamente: as buscas confirmam o escopo de campos com você primeiro, e uma busca que não pode ser entregue falha antes de qualquer crédito ser gasto.

Os créditos são retirados da assinatura Coresignal da sua equipe — gerencie chaves e cobrança no painel. Novo no Coresignal? O teste gratuito de 7 dias vem com 2.000 créditos — isso dá 100 pesquisas, ou 100 registros de funcionários/empresas, ou uma combinação — veja a comparação de planos.