DataBolsa docs
Servidor MCP

Servidor local (npx)

Rode o servidor MCP na sua máquina com o pacote @databolsa/mcp.

DATABOLSA_API_KEY=db_live_SUACHAVE npx -y @databolsa/mcp

Sobe o servidor em stdio (padrão dos clientes desktop). Variáveis:

VariávelDefaultPara quê
DATABOLSA_API_KEYchave db_live_* (obrigatória na API hospedada)
DATABOLSA_API_URLhttps://api.databolsa.comapontar para um self-host
MCP_TRANSPORTstdiohttp sobe o transporte Streamable HTTP local
MCP_HTTP_PORT3333porta do modo HTTP

Modo HTTP (self-host)

MCP_TRANSPORT=http MCP_HTTP_PORT=3333 npx -y @databolsa/mcp
# → http://localhost:3333/mcp

No modo HTTP o servidor aceita a chave por request (header Authorization: Bearer …), com fallback na env — o mesmo comportamento do endpoint hospedado. Auth/rate-limit adicionais ficam por conta do seu proxy.

Quando usar o local

  • Cliente sem suporte a servidores remotos.
  • API self-hosted (aponte DATABOLSA_API_URL).
  • Ambientes sem saída pra mcp.databolsa.com.

O código é aberto: packages/mcp no GitHub.