🇧🇷 big-mcp-b3

MCP Server completo para dados da B3 — cotações, FIIs, proventos, fundamentos, opções e índices.

✨ Features

• 10 tools para dados do mercado financeiro brasileiro

• Sem chave de API obrigatória — funciona imediatamente com brapi.dev (gratuita)

• TypeScript moderno — tipagem forte, async/await

• Zero dependências pesadas — apenas MCP SDK + Zod

• Compatível com Claude Desktop, Cursor, VS Code, Hermes

Related MCP server: mcp-financex

🛠️ Tools Disponíveis

🚀 Quick Start

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "big-mcp-b3": {
      "command": "npx",
      "args": ["-y", "big-mcp-b3"],
      "env": {
        "BRAPI_TOKEN": "seu-token-aqui"
      }
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json:

{
  "servers": {
    "big-mcp-b3": {
      "command": "npx",
      "args": ["-y", "big-mcp-b3"],
      "env": {
        "BRAPI_TOKEN": "seu-token-aqui"
      }
    }
  }
}

VS Code

Crie .vscode/mcp.json:

{
  "servers": {
    "big-mcp-b3": {
      "command": "npx",
      "args": ["-y", "big-mcp-b3"],
      "env": {
        "BRAPI_TOKEN": "seu-token-aqui"
      }
    }
  }
}

Hermes

hermes mcp add big-mcp-b3 -- npx -y big-mcp-b3

Desenvolvimento Local

# Clone o repositório
git clone https://github.com/danielvm-git/big-mcp-b3.git
cd big-mcp-b3

# Instale dependências
npm install

# Execute em modo desenvolvimento
npm run dev

# Build para produção
npm run build

📖 Exemplos de Uso

Após configurar o MCP server, faça perguntas em linguagem natural:

Cotação: "Qual a cotação atual de PETR4?"

Histórico: "Mostre o histórico de VALE3 nos últimos 3 meses"

Proventos: "Quais foram os dividendos pagos por TAEE11?"

FIIs: "Liste os FIIs de shoppings"

Índices: "Como está o Ibovespa hoje?"

Opções: "Quais são as opções de PETR4 com vencimento em 2026?"

Comparação: "Compare PETR4 com VALE3 e ITUB4"

⚙️ Configuração

Variáveis de Ambiente

Obtendo Token da brapi.dev

1. Acesse brapi.dev

2. Crie uma conta gratuita

3. Copie seu token do dashboard

4. Adicione ao .env ou na configuração do MCP

Nota: O server funciona sem token (com limite de requisições).

📊 Dados Disponíveis

Ações

• Cotação em tempo real

• Histórico de preços (1d a 10y)

• Dividendos e JCP

• Opções (calls e puts)

Fundos Imobiliários

• Lista completa via CVM

• Cotação e variação

• Proventos pagos

Índices

• Ibovespa (^BVSP)

• IFIX (^IFIX)

• IDIV (^IDIV)

• SMLL (^SMLL)

• E mais...

🔧 Desenvolvimento

Estrutura do Projeto

big-mcp-b3/
├── src/
│   ├── index.ts          # Entry point
│   ├── types/            # Definições de tipos
│   ├── services/         # Serviços de API
│   │   ├── brapi.ts      # brapi.dev
│   │   └── cvm.ts        # CVM dados abertos
│   └── tools/            # Tools MCP
│       ├── cotacao.ts    # Cotação
│       ├── historico.ts  # Histórico
│       ├── proventos.ts  # Proventos
│       ├── fiis.ts       # FIIs
│       ├── fundamentus.ts# Fundamentos
│       ├── indices.ts    # Índices
│       ├── opcoes.ts     # Opções
│       └── comparar.ts   # Comparação
├── tests/
├── docs/
├── package.json
├── tsconfig.json
└── README.md

Comandos

npm run dev      # Executa em modo desenvolvimento
npm run build    # Compila TypeScript
npm run start    # Executa versão compilada
npm test         # Executa testes

📝 Licença

MIT — veja LICENSE para detalhes.

🤝 Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md para diretrizes.

📧 Contato

• GitHub: @danielvm-git

• Issues: GitHub Issues

Feito com ❤️ para investidores brasileiros