NeuralVerge

Servidor MCP

Conecte qualquer cliente compatível com MCP (Claude, ChatGPT, Cursor) à API completa do NeuralVerge por meio do Model Context Protocol.

Servidor MCP

O NeuralVerge expõe sua API completa como um servidor remoto Model Context Protocol (MCP), permitindo que qualquer cliente compatível com MCP — Claude, ChatGPT, Cursor ou um agente personalizado — chame AI Research, Search, AI Extract e todas as Fontes de Dados diretamente como ferramentas, sem precisar escrever nenhum código de integração HTTP.

Cada ferramenta é um wrapper fino 1:1 em torno do endpoint REST correspondente documentado na aba API Reference, então tudo o que você pode fazer com a API REST também pode ser feito a partir de um cliente MCP.

Endpoint

https://api.neuralverge.ai/functions/v1/mcp-server

O servidor utiliza o transporte Streamable HTTP do MCP e é stateless — cada requisição é tratada de forma independente, sem sessão para manter ativa entre chamadas.

As requisições devem incluir:

Accept: application/json, text/event-stream

Autenticação

Envie o mesmo token bearer que você usa para a API REST:

Authorization: Bearer YOUR_ACCESS_TOKEN

Consulte Autenticação para saber como obter um token. Uma requisição com token ausente ou inválido é rejeitada com 401 Unauthorized antes que qualquer ferramenta seja executada.

Ferramentas disponíveis

AI Research

Ferramenta	Descrição
run_research	Inicia o fluxo completo de AI Research (busca em múltiplas etapas, análise, relatório estruturado). Assíncrono — retorna um session_id.
get_session_status	Consulta uma sessão criada por run_research até que ela esteja complete ou failed.

AI Extract

Ferramenta	Descrição
run_extract	Carrega uma página por URL e extrai dados estruturados conforme instruções em linguagem natural e/ou um esquema JSON. Síncrono.

Search

Ferramenta	Descrição
run_search	Executa uma busca web síncrona e retorna resultados ranqueados.

Fontes de Dados — LinkedIn

Ferramenta	Descrição
run_linkedin_email	Consulta de perfil do LinkedIn por URL, incluindo e-mail quando disponível.
run_linkedin_domain	Encontra um perfil do LinkedIn a partir de nome/domínio da empresa e nome completo.
run_linkedin_company_search	Pesquisa empresas no LinkedIn por consulta com filtros opcionais.
run_linkedin_people_search	Pesquisa pessoas no LinkedIn com consulta em texto livre e filtros avançados.
run_linkedin_company_employee	Pesquisa funcionários de uma ou mais empresas fornecidas.

Fontes de Dados — E-mail e Telefone

Ferramenta	Descrição
run_email_enrichment	Enriquece um e-mail conhecido com dados de perfil.
run_email_validation	Valida a entregabilidade de um endereço de e-mail.
run_email_finder	Encontra um e-mail profissional a partir de domínio, nome e sobrenome.
run_phone_enrichment	Enriquece um número de telefone conhecido, em todo o mundo.
run_phone_enrichment_us	Valida e enriquece um número de telefone dos EUA especificamente.

Fontes de Dados — Empresa

Ferramenta	Descrição
run_crunchbase_company	Busca dados estruturados de empresa a partir de uma URL de organização no Crunchbase.

run_research é a única ferramenta assíncrona — chame get_session_status a cada 2–5 segundos até que status esteja complete ou failed. Todas as outras ferramentas, incluindo run_search, retornam seu resultado imediatamente na resposta da ferramenta. Consulte Erros e Limites de Taxa para obter as diretrizes gerais de consulta que isso segue.

Conectando um cliente MCP

Claude Code / Claude Desktop

claude mcp add --transport http neuralverge \
  https://api.neuralverge.ai/functions/v1/mcp-server \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Cliente HTTP remoto genérico (ChatGPT, Cursor, etc.)

Adicione um conector MCP remoto apontando para o endpoint acima, com um cabeçalho Authorization: Bearer YOUR_ACCESS_TOKEN. Qualquer cliente que fale o transporte Streamable HTTP do MCP funciona — o servidor não exige configuração específica por cliente.

MCP Inspector

npx @modelcontextprotocol/inspector

Conecte-se a https://api.neuralverge.ai/functions/v1/mcp-server no modo HTTP e defina o cabeçalho Authorization para explorar e testar ferramentas interativamente.

Exemplo de requisição

curl -X POST "https://api.neuralverge.ai/functions/v1/mcp-server" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "run_email_validation",
      "arguments": { "email": "john@example.com" }
    }
  }'

Erros

Um cabeçalho Authorization ausente ou inválido faz a requisição inteira falhar com 401 Unauthorized, da mesma forma que na API REST.

Uma vez que a requisição é autenticada, erros de uma chamada de ferramenta individual (parâmetros inválidos, 402 Payment Required para limites de uso, falhas upstream e assim por diante) são retornados dentro do resultado da ferramenta MCP com isError: true em vez de uma falha HTTP — isso permite que o modelo chamador veja e reaja ao erro em vez de a requisição inteira falhar. Os códigos de status subjacentes são os mesmos descritos em Erros e Limites de Taxa.

Próximos passos

• Revise Autenticação para obter um token de acesso
• Explore AI Research, AI Extract, Search e Fontes de Dados para entender o que cada ferramenta faz internamente
• Navegue pela aba API Reference para ver o esquema REST completo que cada ferramenta encapsula