Servidor MCP
Visão geral
Um servidor MCP com uma tool por endpoint, geradas do contrato OpenAPI da DataBolsa.
O servidor MCP da DataBolsa expõe uma tool por endpoint da API pública — cotações, indicadores fundamentalistas, FIIs, fundos, índices, opções, Tesouro, macro, notícias, busca semântica de documentos e a carteira do usuário. As tools são geradas do contrato OpenAPI, então acompanham a API automaticamente.
Dois jeitos de rodar
| Remoto (hospedado) | Local (npx) | |
|---|---|---|
| Endpoint | https://mcp.databolsa.com/mcp | processo stdio na sua máquina |
| Auth | OAuth ou chave db_live_* | chave db_live_* via env |
| Para quem | claude.ai, ChatGPT, Cursor, agentes na nuvem | Claude Desktop/Code local, self-host |
| Instalação | nenhuma | npx -y @databolsa/mcp |
Na dúvida, use o remoto — é o que os guias de conexão de agentes usam.
Auth e limites
- OAuth: o cliente registra-se sozinho (dynamic client registration) e o login é o mesmo do site (código por e-mail). A conexão vira uma chave gerenciada "Conector MCP" na sua conta — visível e revogável.
- Chave de API: header
Authorization: Bearer db_live_…, criada em databolsa.com/conta/config. - Limites: as tool calls contam no limite diário de API do seu plano — o Grátis tem um teto básico; Pro e Max usam sem teto diário.
Exemplos de perguntas
"Screening de ações: ROE > 15%, dívida líquida/EBITDA < 2, liquidez > R$ 5M."
"Qual foi o fluxo de investidor estrangeiro na B3 este mês?"
"Procure nos relatórios do FII HGLG11 menções a vacância."