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/mcpSobe o servidor em stdio (padrão dos clientes desktop). Variáveis:
| Variável | Default | Para quê |
|---|---|---|
DATABOLSA_API_KEY | — | chave db_live_* (obrigatória na API hospedada) |
DATABOLSA_API_URL | https://api.databolsa.com | apontar para um self-host |
MCP_TRANSPORT | stdio | http sobe o transporte Streamable HTTP local |
MCP_HTTP_PORT | 3333 | porta do modo HTTP |
DATABOLSA_MCP_PROFILE | — | perfil da sessão: context, market, credit, account ou full. Vazio = superfície completa |
Perfis
O contrato declara perfis nomeados (x-profiles), e cada operação carrega uma capacidade
(x-capability). Com DATABOLSA_MCP_PROFILE=context a sessão expõe só o grafo de objetos,
documentos, eventos e saúde do serviço (~30 tools em vez de 172) — menos contexto gasto com
definição de tool, ideal para agentes. market é o mercado público por rotas de domínio,
credit é crédito privado + grafo, account é carteira/teses/suitability (onde vive toda
escrita). Perfil desconhecido falha no startup listando os válidos. O perfil reduz exposição
e contexto; a autorização real continua na chave e nos escopos da API.
Modo HTTP (self-host)
MCP_TRANSPORT=http MCP_HTTP_PORT=3333 npx -y @databolsa/mcp
# → http://localhost:3333/mcpNo 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.