Zephira Company Intelligence

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

Conecte-se com sua chave de API do dashboard

No seu cliente MCP, adicione um servidor remoto usando Streamable HTTP e a seguinte URL:

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

Adicione sua chave de API de produção ativa nas configurações de autenticação segura do cliente:

Authorization: Bearer YOUR_ZEPHIRA_API_KEY

Crie ou gerencie chaves no dashboard Zephira. Use uma chave zph_live_ com os escopos exigidos pelas suas ferramentas. Os clientes devem suportar um cabeçalho de autorização Bearer. Nenhuma solicitação separada de acesso MCP é necessária.

Seis ferramentas de dados de empresas

Ferramenta	Retorna	Escopo da chave
search_entities	Empresas que correspondem a um nome ou identificador em uma jurisdição.	company:read
get_entity	Identidade da empresa e campos de perfil disponíveis.	company:read
get_officers	Uma página de diretores disponíveis da empresa.	company:read
get_shareholders	Uma página de acionistas disponíveis da empresa.	ownership:read
get_corporate_hierarchy	A estrutura de grupo disponível da empresa.	ownership:read
get_financials	Demonstrações financeiras disponíveis.	financials:read

A cobertura varia por empresa e jurisdição. Preserve os rótulos de origem e de dados modelados ao exibir resultados. Dados ausentes não provam que um fato não existe.

Pesquise primeiro, depois recupere uma empresa

Chame search_entities com um location e pelo menos um dos seguintes: name, registration_number, vat_number ou ticker.

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

Use um ID numérico de empresa retornado pela pesquisa como uma string em entity_id. O ID abaixo é ilustrativo; substitua-o pelo resultado da sua pesquisa.

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

Todas as ferramentas de recuperação aceitam entity_id e include_provenance opcional (padrão true). Diretores e acionistas também aceitam page (padrão 1) e per_page (padrão 10, máximo 50). A pesquisa aceita um array city_or_state opcional.

Resultados bem-sucedidos das ferramentas fornecem o payload da API sob data, com meta.request_id, meta.status, meta.units e meta.remaining_units. Os resultados estão disponíveis tanto como conteúdo de texto quanto estruturado.

Compatibilidade de protocolo e cliente

O endpoint suporta MCP 2026-07-28 e o fluxo Streamable HTTP legado sem estado. Clientes atuais usam server/discover; clientes mais antigos usam initialize, seguido por notifications/initialized. Ambos podem então usar tools/list e tools/call.

Para uma solicitação direta usando o protocolo atual, inclua os metadados por solicitação e os cabeçalhos HTTP correspondentes. As bibliotecas de cliente MCP normalmente fornecem isso automaticamente.

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, defina Mcp-Method: tools/call, adicione Mcp-Name correspondente ao nome da ferramenta e inclua name e arguments ao lado de _meta em params. Descoberta e listagem de ferramentas não consomem créditos de dados.

Este endpoint fornece ferramentas. Ele não fornece prompts ou recursos e não exige um ID de sessão persistente. Respostas modernas usam JSON; clientes legados também devem aceitar text/event-stream.

Uso e solução de problemas

Chamadas de dados bem-sucedidas consomem uma unidade da mesma cota do workspace que a API do dashboard. Escopos de chave de API, revogação e limites de cota se aplicam a cada chamada de ferramenta. Solicitações de dados com falha não são cobradas.

Resposta	O que verificar
401 UNAUTHENTICATED	Forneça uma chave de API ativa do dashboard usando Authorization: Bearer.
403 INSUFFICIENT_SCOPE	Use ou crie uma chave com o escopo exigido pela ferramenta.
429 ALLOWANCE_EXHAUSTED	Revise a cota restante do workspace no dashboard.
Argumentos de ferramenta inválidos	Use o esquema retornado por tools/list; passe IDs numéricos de empresa como strings.
Erro de protocolo ou cabeçalho	Corresponda os metadados do protocolo e os cabeçalhos Mcp-Method / Mcp-Name ao corpo da solicitação.
Erro do serviço de dados	Verifique o erro e o ID da solicitação no resultado da ferramenta. Repita falhas temporárias com backoff.

Falhas na execução das ferramentas retornam isError: true, um objeto error e metadados da solicitação dentro do resultado MCP. Use o ID da solicitação ao entrar em contato com o suporte.

Referência da API REST · Contatar suporte