A brapi tem três formas de acesso: REST, MCP e Agent Skills. Esta página mostra qual delas usar em cada ferramenta de IA.
Lovable, v0, Bolt.new e Replit geram código, mas não hospedam as ferramentas MCP da brapi. Use um backend ou uma função server-side para chamar a API REST.
Prompt e configuração para um app full-stack.
Prompt para uma aplicação Next.js.
Prompt para um app executado no navegador.
Prompt para o Replit Agent e Replit Secrets.
Codex, Cursor e Claude Code podem consultar o servidor MCP da brapi durante a conversa. Instale também a Agent Skill da brapi. Ela ensina as regras de endpoint, a autenticação e a leitura dos campos.
Configure MCP e Agent Skills no Codex.
Configure MCP e Agent Skills no Cursor.
Configure MCP e Agent Skills no Claude Code.
OpenClaw e Hermes Agent podem usar o MCP Streamable HTTP da brapi em tarefas longas. Dê ao agente apenas o acesso necessário e exija confirmação antes de qualquer ação externa baseada nos dados.
Configure o registro MCP remoto do OpenClaw.
Configure o MCP remoto no Hermes Agent.
Use REST para dashboards, pipelines, integrações determinísticas e clientes tipados. O contrato canônico está em OpenAPI.
O primeiro teste não exige token:
curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4"Use Authorization: Bearer SEU_TOKEN para dados protegidos. Guarde o token no
backend ou em um secret do ambiente. Não o coloque no código do navegador.
Use MCP quando você quiser perguntar em linguagem natural, sem escrever código. Configure esta URL no cliente:
https://brapi.dev/api/mcp/mcpO guia do MCP mostra comandos para Claude Code, Codex, Cursor, ChatGPT, VS Code, n8n e outros clientes. O server card descreve o servidor para clientes que fazem descoberta automática.
O MCP tem ferramentas de consulta para cotações, históricos, dividendos,
fundamentos, FIIs, fundos, opções, futuros, Tesouro Direto, câmbio, cripto e
indicadores macroeconômicos. Use a ferramenta get_dictionary quando um campo,
unidade, fórmula ou valor null não estiver claro.
Uma Skill dá contexto ao agente. Ela não retorna dados. O agente continua chamando o REST ou o MCP.
Instale a Skill pública da brapi:
npx skills add brapi-dev/brapi-skillsLeia também o arquivo publicado da Skill e o índice para agentes.
Use este prompt em um assistente ou em um construtor de apps:
Você está integrando dados do mercado financeiro brasileiro com a brapi.
Antes de gerar uma chamada:
- Leia https://brapi.dev/llms.txt para escolher o endpoint mais específico.
- Leia https://brapi.dev/openapi.json para confirmar operação, parâmetros e resposta.
- Use endpoints /api/v2 em uma integração nova.
- Use o parâmetro symbols quando o endpoint aceitar vários ativos.
- Use PETR4, VALE3, MGLU3 ou ITUB4 para o primeiro teste sem token.
- Consulte https://brapi.dev/api/v2/dictionary quando um campo ou unidade não estiver claro.
Mostre o endpoint usado, o timestamp da resposta e o timestamp do dado quando existirem.
Preserve valores null. Não transforme null em zero. Não invente campos.
Não dê recomendação de investimento.| Necessidade | Endpoints e guias |
|---|---|
| Cotações de ações | /api/v2/stocks/quote |
| Histórico de preços | /api/v2/stocks/historical |
| Dividendos e JCP | /api/v2/stocks/dividends |
| Perfil e fundamentos | /api/v2/stocks/profile, statistics, financial-data |
| Demonstrações financeiras | balance-sheet, income-statement, cash-flow, value-added |
| FIIs | /api/v2/fii/* |
| Fundos estruturados | /api/v2/funds/* |
| Opções | /api/v2/options/* |
| Futuros | /api/v2/futures/* |
| Tesouro Direto | /api/v2/treasury/* |
| Câmbio | /api/v2/currency |
| Cripto | /api/v2/crypto |
| Indicadores macroeconômicos | /api/v2/macro |
| Descoberta e validação de tickers | /api/v2/tickers/* |
| Nomes, unidades e fórmulas de campos | /api/v2/dictionary |
RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset.Retry-After depois de uma resposta HTTP 429.Deprecation, Sunset e o link de migração antes de alterar uma rota antiga.Comece com uma consulta de PETR4 no sandbox. Depois conecte sua conta e habilite os endpoints necessários para o seu plano.