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: default ou full. Vazio = default |
Perfis
O contrato declara perfis nomeados (x-profiles), e cada operação carrega um domínio
(x-domain) e, nos contratos de extensão, um lifecycle (x-lifecycle). Sem perfil a sessão
recebe default. No core, default é o contrato inteiro: o grafo de objetos, o discovery e a
execução de Functions, os módulos e o sistema. No contrato de uma extensão, default são as sete
operações do protocolo (catálogo, spec e execução de Functions e de Actions), e full acrescenta
as rotas especializadas. 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.
Carteira e perfil de investidor não são um perfil deste contrato: são da extensão Wallet,
instalada por workspace, com contrato e servidor próprios (@databolsa/wallet-mcp).
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/core/mcp no GitHub.