Coresignal

Coresignal MCP v2

O servidor oficial do Model Context Protocol para Coresignal — traga dados B2B atualizados de 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, puxe registros completos, enriqueça contatos com e-mails verificados e exporte grandes conjuntos de resultados como arquivos baixáveis — 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 correspondeu.
• 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 certos por palavra-chave, gratuitamente, sem carregar o vocabulário completo 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 sobrecarregar o chat.
• artifact_read páginas entregam os arquivos de volta para a 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 automaticamente a chave da sua equipe 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ê entrar no painel Coresignal. Isso é toda a configuração — sem variáveis de ambiente, sem segredos.

Configuração do cliente

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

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

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

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

opencode mcp auth coresignal

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

{
  "mcpServers": {
    "coresignal": {
      "type": "streamableHttp",
      "url": "https://mcp.coresignal.com/mcp/v2",
      "disabled": false
    }
  }
}

cline mcp

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

Grandes resultados (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 em 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:

1. O agente baixa o arquivo ele mesmo — em clientes com acesso ao shell, o agente normalmente curl o link para o disco e analisa o arquivo localmente com grep/jq/pandas.
2. 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 sobrecarrega o chat.
3. 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 informe 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 que ele retorna faz parte da conversa e é re-cobrada como tokens 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 cerca de 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 leva centenas de chamadas e pode esgotar a janela de contexto antes de 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 antecipadamente (lista de permissões de domínios, acesso à rede na sandbox) e manter artifact_read para clientes que não podem baixar ou para dar uma olhada em algumas linhas.

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

Ferramentas

entity_search

Busca employee, company ou job registros 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 identificador de busca com validade de 1 hora que economiza créditos e tempo: passe-o para entity_fetch e os registros correspondentes são coletados imediatamente — sem precisar re-executar (e re-pagar) a busca, 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 fields para uma busca com escopo personalizado sem carregar todo o vocabulário de campos no contexto.

entity_fetch

Coleta registros — ou até 20 ids escolhidos manualmente dos resultados de busca, 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, pois os registros foram cobrados quando foram buscados. É isso que faz a entrega de arquivos funcionar em qualquer lugar, inclusive em clientes de chat que não podem abrir um link ou tocar em um sistema de arquivos.

Exemplos de prompts

Varredura de mercado

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

Monte uma lista de leads com e-mails verificados

"Busque por diretores de dados em empresas dos EUA com mais de 500 funcionários. Busque 20 perfis completos para um arquivo com e-mails verificados."

Análise aprofundada de uma única empresa**

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

...

Créditos e cobrança

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

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 buscas, ou 100 registros de funcionários/empresas, ou uma combinação — veja a comparação de planos.

Links

• Coresignal — cobertura de dados, planos e preços
• Painel Coresignal — conta, equipe, chaves de API, créditos
• Documentação da API — as APIs de dados subjacentes