Zephira Company Intelligence

npx add-mcp 'https://dashboard.zephira.ai/api/mcp'

Conéctate con tu clave de API del panel

En tu cliente MCP, añade un servidor remoto usando Streamable HTTP y la siguiente URL:

https://dashboard.zephira.ai/api/mcp

Añade tu clave de API de producción activa en la configuración de autenticación segura del cliente:

Authorization: Bearer YOUR_ZEPHIRA_API_KEY

Crea o gestiona claves en el panel de Zephira. Usa una clave zph_live_ con los alcances requeridos por tus herramientas. Los clientes deben admitir un encabezado de autorización Bearer. No se requiere una solicitud de acceso MCP separada.

Seis herramientas de datos de empresas

Herramienta	Devuelve	Alcance de clave
search_entities	Empresas que coinciden con un nombre o identificador en una jurisdicción.	company:read
get_entity	Identidad de la empresa y campos de perfil disponibles.	company:read
get_officers	Una página de directivos disponibles de la empresa.	company:read
get_shareholders	Una página de accionistas disponibles de la empresa.	ownership:read
get_corporate_hierarchy	La estructura de grupo de la empresa disponible.	ownership:read
get_financials	Estados financieros disponibles.	financials:read

La cobertura varía según la empresa y la jurisdicción. Conserva las etiquetas de datos de origen y modelados al mostrar los resultados. La falta de datos no demuestra que un hecho no exista.

Busca primero, luego recupera una empresa

Llama a search_entities con un location y al menos uno de name, registration_number, vat_number o ticker.

{
  "name": "search_entities",
  "arguments": {
    "location": "GB",
    "name": "Tesco",
    "include_provenance": true
  }
}

Usa un ID de empresa numérico devuelto por la búsqueda como una cadena en entity_id. El ID a continuación es ilustrativo; reemplázalo con el resultado de tu búsqueda.

{
  "name": "get_entity",
  "arguments": {
    "entity_id": "123",
    "include_provenance": true
  }
}

Todas las herramientas de recuperación aceptan entity_id y include_provenance opcional (por defecto true). Los directivos y accionistas también aceptan page (por defecto 1) y per_page (por defecto 10, máximo 50). La búsqueda acepta un array city_or_state opcional.

Los resultados exitosos de las herramientas proporcionan la carga útil de la API bajo data, con meta.request_id, meta.status, meta.units y meta.remaining_units. Los resultados están disponibles tanto como contenido de texto como estructurado.

Compatibilidad de protocolo y cliente

El endpoint admite MCP 2026-07-28 y el flujo Streamable HTTP heredado sin estado. Los clientes actuales usan server/discover; los clientes más antiguos usan initialize, seguido de notifications/initialized. Ambos pueden usar luego tools/list y tools/call.

Para una solicitud directa usando el protocolo actual, incluye los metadatos por solicitud y los encabezados HTTP correspondientes. Las bibliotecas de cliente MCP normalmente los proporcionan automáticamente.

curl https://dashboard.zephira.ai/api/mcp \
  -H "Authorization: Bearer $ZEPHIRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/list' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientInfo": {
          "name": "my-client", "version": "1.0.0"
        },
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

Para tools/call, establece Mcp-Method: tools/call, añade Mcp-Name que coincida con el nombre de la herramienta, e incluye name y arguments junto a _meta en params. El descubrimiento y el listado de herramientas no consumen créditos de datos.

Este endpoint proporciona herramientas. No proporciona prompts ni recursos, y no requiere un ID de sesión persistente. Las respuestas modernas usan JSON; los clientes heredados también deben aceptar text/event-stream.

Uso y solución de problemas

Las llamadas de datos exitosas consumen una unidad del mismo límite del espacio de trabajo que la API del panel. Los alcances de las claves de API, la revocación y los límites de asignación se aplican a cada llamada de herramienta. Las solicitudes de datos fallidas no se cobran.

Respuesta	Qué verificar
401 UNAUTHENTICATED	Proporciona una clave de API del panel activa usando Authorization: Bearer.
403 INSUFFICIENT_SCOPE	Usa o crea una clave con el alcance requerido por la herramienta.
429 ALLOWANCE_EXHAUSTED	Revisa el límite restante del espacio de trabajo en el panel.
Argumentos de herramienta no válidos	Usa el esquema devuelto por tools/list; pasa los ID de empresa numéricos como cadenas.
Error de protocolo o encabezado	Haz coincidir los metadatos del protocolo y los encabezados Mcp-Method / Mcp-Name con el cuerpo de la solicitud.
Error del servicio de datos	Verifica el error y el ID de solicitud del resultado de la herramienta. Reintenta fallos temporales con retroceso.

Las fallas de ejecución de herramientas devuelven isError: true, un objeto error y metadatos de solicitud dentro del resultado MCP. Usa el ID de solicitud al contactar al soporte.

Referencia de la API REST · Contactar soporte