NeuralVerge

Servidor MCP

Conecta cualquier cliente compatible con MCP (Claude, ChatGPT, Cursor) a la API completa de NeuralVerge a través del Model Context Protocol.

Servidor MCP

NeuralVerge expone su API completa como un servidor remoto de Model Context Protocol (MCP), de modo que cualquier cliente compatible con MCP — Claude, ChatGPT, Cursor o un agente personalizado — pueda llamar a AI Research, Search, AI Extract y cada Fuente de Datos directamente como herramientas, sin necesidad de escribir código de integración HTTP.

Cada herramienta es un envoltorio delgado 1:1 alrededor del endpoint REST correspondiente documentado en la pestaña Referencia de API, por lo que todo lo que puedes hacer con la API REST también puedes hacerlo desde un cliente MCP.

Endpoint

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

El servidor utiliza el transporte Streamable HTTP de MCP y no tiene estado: cada solicitud se maneja de forma independiente, sin sesión que mantener activa entre llamadas.

Las solicitudes deben incluir:

Accept: application/json, text/event-stream

Autenticación

Envía el mismo token de portador que usas para la API REST:

Authorization: Bearer YOUR_ACCESS_TOKEN

Consulta Autenticación para saber cómo obtener un token. Una solicitud con un token faltante o inválido se rechaza con 401 Unauthorized antes de que se ejecute cualquier herramienta.

Herramientas disponibles

AI Research

Herramienta	Descripción
run_research	Inicia el flujo completo de AI Research (búsqueda multi-paso, análisis, informes estructurados). Asíncrono: devuelve un session_id.
get_session_status	Consulta una sesión creada por run_research hasta que esté complete o failed.

AI Extract

Herramienta	Descripción
run_extract	Carga una página por URL y extrae datos estructurados según instrucciones en lenguaje natural y/o un esquema JSON. Síncrono.

Search

Herramienta	Descripción
run_search	Ejecuta una búsqueda web síncrona y devuelve resultados clasificados.

Fuentes de Datos — LinkedIn

Herramienta	Descripción
run_linkedin_email	Búsqueda de perfil de LinkedIn por URL, incluido el correo electrónico cuando esté disponible.
run_linkedin_domain	Encuentra un perfil de LinkedIn a partir de un nombre/dominio de empresa más un nombre completo.
run_linkedin_company_search	Busca empresas de LinkedIn por consulta con filtros opcionales.
run_linkedin_people_search	Busca personas en LinkedIn con consulta de texto libre y filtros avanzados.
run_linkedin_company_employee	Busca empleados de una o más empresas determinadas.

Fuentes de Datos — Correo Electrónico y Teléfono

Herramienta	Descripción
run_email_enrichment	Enriquece un correo electrónico conocido con datos de perfil.
run_email_validation	Valida la entregabilidad de una dirección de correo electrónico.
run_email_finder	Encuentra un correo electrónico profesional a partir de un dominio, nombre y apellido.
run_phone_enrichment	Enriquece un número de teléfono conocido, a nivel mundial.
run_phone_enrichment_us	Valida y enriquece un número de teléfono de EE. UU. específicamente.

Fuentes de Datos — Empresa

Herramienta	Descripción
run_crunchbase_company	Obtiene datos estructurados de empresa desde una URL de organización de Crunchbase.

run_research es la única herramienta asíncrona: llama a get_session_status cada 2–5 segundos hasta que status sea complete o failed. Todas las demás herramientas, incluida run_search, devuelven su resultado inmediatamente en la respuesta de la herramienta. Consulta Errores y Límites de Velocidad para obtener la guía general de sondeo que esto sigue.

Conexión de un 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.)

Agrega un conector MCP remoto que apunte al endpoint anterior, con un encabezado Authorization: Bearer YOUR_ACCESS_TOKEN. Cualquier cliente que hable el transporte Streamable HTTP de MCP funciona: el servidor no requiere configuración específica del cliente.

MCP Inspector

npx @modelcontextprotocol/inspector

Conéctate a https://api.neuralverge.ai/functions/v1/mcp-server en modo HTTP y configura el encabezado Authorization para explorar y probar herramientas de forma interactiva.

Ejemplo de solicitud

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" }
    }
  }'

Errores

Un encabezado Authorization faltante o inválido hace fallar toda la solicitud con 401 Unauthorized, igual que en la API REST.

Una vez que una solicitud está autenticada, los errores de una llamada de herramienta individual (parámetros inválidos, 402 Payment Required por límites de uso, fallos de proveedores, etc.) se devuelven dentro del resultado de la herramienta MCP con isError: true en lugar de como un fallo HTTP — esto permite que el modelo que llama vea y reaccione al error en lugar de que toda la solicitud falle. Los códigos de estado subyacentes son los mismos que se describen en Errores y Límites de Velocidad.

Próximos pasos

• Revisa Autenticación para obtener un token de acceso
• Explora AI Research, AI Extract, Search y Fuentes de Datos para ver qué hace cada herramienta internamente
• Explora la pestaña Referencia de API para ver el esquema REST completo que envuelve cada herramienta