Servidor MCP para IAs
O servidor MCP da brapi conecta seu assistente de IA aos dados do mercado financeiro brasileiro. Com uma única URL, sua IA passa a buscar cotações de ações, FIIs, câmbio, criptomoedas e indicadores econômicos enquanto você conversa com ela.
URL do servidor
https://brapi.dev/api/mcp/mcpEssa é a única URL que você precisa. Copie e cole no seu cliente de IA. Na primeira vez, ele abre o navegador para você fazer login na brapi.
Configure seu cliente
Rode no terminal:
claude mcp add --transport http brapi https://brapi.dev/api/mcp/mcpO Claude vai abrir o navegador para você fazer login. Pronto.
Para verificar a instalação:
claude mcp listAbra o arquivo de configuração do Claude:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
E adicione:
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": ["mcp-remote", "https://brapi.dev/api/mcp/mcp"]
}
}
}Reinicie o Claude. Na primeira pergunta, ele abre o navegador para você fazer login na brapi.
Rode no terminal para adicionar o servidor:
codex mcp add brapi --url https://brapi.dev/api/mcp/mcpEm seguida, faça o login com OAuth:
codex mcp login brapiO Codex abre o navegador para você fazer login na brapi.
Se o Codex disser que não suporta servidores HTTP, abra ~/.codex/config.toml
e adicione:
[features]
experimental_use_rmcp_client = trueIsso ativa o cliente de MCP HTTP do Codex.
- Abra Configurações → Conectores no ChatGPT
- Clique em Adicionar conector personalizado
- Cole a URL:
https://brapi.dev/api/mcp/mcp - Faça login na brapi quando o ChatGPT pedir
Conectores personalizados estão disponíveis nos planos pagos do ChatGPT (Plus, Pro, Business e Enterprise).
Abra ~/.cursor/mcp.json (global) ou .cursor/mcp.json (do projeto) e
adicione:
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": ["mcp-remote", "https://brapi.dev/api/mcp/mcp"]
}
}
}Reinicie o Cursor. Na primeira pergunta, ele abre o navegador para login.
Abra .vscode/mcp.json no seu projeto (ou nas configurações do usuário) e
adicione:
{
"mcp": {
"servers": {
"brapi": {
"url": "https://brapi.dev/api/mcp/mcp"
}
}
}
}Você precisa do VS Code 1.99 ou maior com a extensão GitHub Copilot.
Habilite chat.mcp.enabled nas configurações.
- Adicione um node AI Agent no seu workflow
- Conecte um node MCP Client Tool
- Em Server URL, cole:
https://brapi.dev/api/mcp/mcp - Em Authentication, escolha OAuth2
Pronto para criar automações como alertas de preço, relatórios diários e notificações no Slack/Discord.
O servidor da brapi funciona com qualquer cliente que suporte MCP, incluindo Windsurf, Cline, Zed, Continue, Amazon Q, Gemini CLI, goose e mais de 100 outros.
Em qualquer um deles, use a URL:
https://brapi.dev/api/mcp/mcpSe o seu cliente não fizer login automático no navegador, gere um token no dashboard da brapi e use o cabeçalho:
Authorization: Bearer SEU_TOKENExemplos de perguntas
Qual é a cotação atual da PETR4?Compare PETR4 e VALE3 no último mêsListe as 5 ações com maior volume de negociação hojeQuais FIIs do segmento de logística têm o maior dividend yield?Mostre os rendimentos pagos pelo MXRF11 nos últimos 12 mesesQual a taxa SELIC hoje e como ela mudou nos últimos 12 meses?Compare a evolução do IPCA e IGP-M nos últimos 5 anosQual o preço do Bitcoin em reais agora?Quais são os vencimentos de opções disponíveis para PETR4?Ferramentas disponíveis
A IA tem acesso a 22 ferramentas. As 5 primeiras funcionam sem login; as demais precisam de uma conta brapi.
Descoberta (sem login)
| Ferramenta | O que faz |
|---|---|
get_available_stocks | Lista ações, FIIs, BDRs e índices brasileiros |
get_available_currencies | Lista moedas (USD-BRL, EUR-BRL, etc.) |
get_available_cryptocurrencies | Lista criptomoedas (BTC, ETH, etc.) |
get_available_inflation_countries | Lista países com dados de inflação |
get_macro_series_available | Lista séries macroeconômicas (Selic, IPCA, CDI, etc.) |
Ações, câmbio e criptomoedas
| Ferramenta | O que faz |
|---|---|
get_stock_quotes | Cotações e histórico de ações, ETFs e BDRs |
get_currency_rates | Taxas de câmbio em tempo real |
get_crypto_prices | Preços de criptomoedas |
Indicadores macroeconômicos
| Ferramenta | O que faz |
|---|---|
get_macro_series | Histórico de séries macro (Selic, IPCA, IGP-M, CDI...) |
get_macro_series_latest | Valor mais recente de cada série macro |
get_inflation_data | Dados de inflação (IPCA, IGPM) |
get_prime_rate_data | Taxa SELIC e histórico |
Fundos imobiliários (FIIs)
| Ferramenta | O que faz |
|---|---|
get_fii_list | Lista FIIs com filtros por segmento, setor e mandato |
get_fii_indicators | Indicadores atuais (P/VP, dividend yield, patrimônio...) |
get_fii_indicators_history | Evolução mensal dos indicadores |
get_fii_historical | Histórico diário de preços (OHLCV) |
get_fii_reports | Relatórios mensais da CVM com composição da carteira |
get_fii_dividends | Histórico de rendimentos pagos |
Opções
| Ferramenta | O que faz |
|---|---|
get_option_expirations | Vencimentos disponíveis de um ativo |
get_option_strikes | Strikes disponíveis em um vencimento |
get_option_chain | Cadeia de opções de um vencimento |
get_option_historical | Histórico diário de uma série específica |
Limites por plano
As consultas via MCP usam o mesmo limite da API REST.
| Plano | Requisições/mês | Ideal para |
|---|---|---|
| Gratuito | 15.000 | Testes e projetos pessoais |
| Startup | 150.000 | Startups e pequenas empresas |
| Pro | 500.000 | Aplicações de alto volume |
Próximos passos
Os dados são fornecidos apenas para fins informativos e não constituem aconselhamento financeiro. Consulte sempre um profissional qualificado antes de tomar decisões de investimento.