O servidor MCP da brapi permite que um assistente consulte ações, FIIs, câmbio, criptomoedas e indicadores brasileiros enquanto responde à conversa. A URL é:
https://brapi.dev/api/mcp/mcpO login usa OAuth. Na primeira conexão, o cliente abre o navegador para você entrar na conta brapi e autorizar o acesso.
Configurar no Claude Code
claude mcp add --transport http brapi https://brapi.dev/api/mcp/mcpDepois confira a conexão:
claude mcp listFaça uma pergunta como:
Compare a cotação e a variação de PETR4 e VALE3.Configurar no ChatGPT
No ChatGPT:
- abra Configurações > Conectores;
- escolha Adicionar conector personalizado;
- cole
https://brapi.dev/api/mcp/mcp; - conclua o login na brapi.
Conectores personalizados dependem do plano e da disponibilidade do recurso na sua conta do ChatGPT.
Configurar no Cursor
Crie ~/.cursor/mcp.json para uma configuração global ou .cursor/mcp.json
para apenas um projeto:
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": [
"mcp-remote",
"https://brapi.dev/api/mcp/mcp"
]
}
}
}Reinicie o Cursor. A primeira chamada abre o fluxo de autenticação.
Configurar no Codex
codex mcp add brapi --url https://brapi.dev/api/mcp/mcp
codex mcp login brapiO primeiro comando registra o servidor. O segundo inicia o login OAuth.
Configurar no VS Code
Em .vscode/mcp.json:
{
"mcp": {
"servers": {
"brapi": {
"url": "https://brapi.dev/api/mcp/mcp"
}
}
}
}O suporte depende da versão do VS Code e da extensão de IA usada. A documentação do MCP da brapi mantém instruções para Claude Desktop, n8n e outros clientes.
Uma URL para vários clientes
Você não precisa criar um servidor local diferente para cada aplicativo. O mesmo endpoint remoto funciona em clientes compatíveis com MCP e OAuth.
Perguntas que funcionam bem
Comece com pedidos objetivos, que indiquem o ativo, período e dado desejado:
Qual é a última cotação disponível de PETR4?Compare o histórico diário de VALE3 e PETR4 nos últimos seis meses.Liste FIIs de logística e compare P/VP e dividend yield.Mostre a Selic, o CDI e o IPCA mais recentes com a data de referência.Quais dados estão disponíveis para o ticker VVAR3 e qual é o código atual?Pedidos vagos como "qual ação vai subir?" não viram bons dados só porque usam MCP. O servidor consulta fatos e séries; ele não elimina incerteza nem prevê o mercado.
MCP ou API REST
Use MCP quando a pessoa quer conversar com os dados, investigar uma hipótese ou deixar o agente escolher a ferramenta adequada.
Use REST quando seu sistema precisa de um contrato fixo, baixa latência previsível, cache próprio ou uma tela com comportamento totalmente controlado.
| Caso | Melhor opção inicial |
|---|---|
| Perguntas em linguagem natural | MCP |
| Assistente interno de análise | MCP |
| Dashboard com campos fixos | REST |
| Pipeline de dados em lote | REST |
| Protótipo de agente financeiro | MCP |
| Backend transacional | REST |
Os dois podem coexistir. Um produto pode usar REST nas telas e MCP no assistente de pesquisa.
Segurança e revisão
O servidor consulta dados, mas o agente ainda pode interpretar uma pergunta de forma incorreta. Mostre datas de referência e revise cálculos antes de usar a resposta em uma decisão financeira.
Não cole tokens em prompts ou arquivos versionados. Prefira OAuth e revogue o acesso no painel quando uma integração deixar de ser usada.
Para ver todas as ferramentas, clientes e exemplos, abra a documentação do servidor MCP.
