Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OpLab MCP Server Mostre informações sobre PETR4"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP (Model Context Protocol) para integração com as APIs do OpLab, permitindo que agentes de IA acessem dados do mercado financeiro brasileiro.
Ferramenta | Descrição |
| Informações detalhadas de ações (preço, volume, fundamentalistas) |
| Dados históricos com múltiplas resoluções (1d, 1h, etc) |
| Cadeia de opções completa com strikes e vencimentos |
| Cotações em tempo real de múltiplos ativos |
| Busca de ações, opções, fundos e índices |
| Status do mercado (aberto/fechado) |
| Taxas SELIC e CDI atualizadas |
Related MCP server: twelvedata
Docker e Docker Compose OU
Python 3.11+
Token de acesso OpLab (obtenha aqui)
# 1. Clone o repositório
git clone https://github.com/seu-usuario/oplab-mcp.git
cd oplab-mcp
# 2. Build da imagem
docker build -t oplab-mcp:latest .
# 3. Execute o container
docker run -d \
--name oplab-mcp \
-p 8000:8000 \
-e OPLAB_ACCESS_TOKEN=seu_token_aqui \
-e SERVER_MODE=http \
--restart unless-stopped \
oplab-mcp:latest# 1. Clone e instale dependências
git clone https://github.com/seu-usuario/oplab-mcp.git
cd oplab-mcp
pip install -r requirements.txt
# 2. Configure o token
export OPLAB_ACCESS_TOKEN=seu_token_aqui
# 3. Execute em modo HTTP
export SERVER_MODE=http
python server.py
# OU em modo stdio (para uso local)
python server.pyVariável | Descrição | Padrão | Obrigatório |
| Token de API do OpLab | - | Sim |
| Modo de execução: |
| Não |
| Porta HTTP (apenas modo http) |
| Não |
| Host HTTP (apenas modo http) |
| Não |
Expõe o servidor via HTTP com Server-Sent Events (SSE):
docker run -d \
--name oplab-mcp \
-p 8000:8000 \
-e OPLAB_ACCESS_TOKEN=seu_token \
-e SERVER_MODE=http \
oplab-mcp:latestEndpoint MCP: http://localhost:8000/mcp
Executa via stdio para integração direta:
docker run -i --rm \
-e OPLAB_ACCESS_TOKEN=seu_token \
-e SERVER_MODE=stdio \
oplab-mcp:latestArquivo: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"oplab": {
"url": "http://localhost:8000/mcp"
}
}
}Ou com Docker (stdio):
{
"mcpServers": {
"oplab": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "OPLAB_ACCESS_TOKEN=seu_token",
"-e", "SERVER_MODE=stdio",
"oplab-mcp:latest"
]
}
}
}Depois de configurado, você pode interagir com seu agente de IA:
👤 "Me mostre informações sobre PETR4"
🤖 [usa get_stock_info] Retorna preço, volume, variação...
👤 "Busque o histórico de VALE3 nos últimos 30 dias"
🤖 [usa get_historical_data] Retorna série histórica...
👤 "Quais opções estão disponíveis para ITUB4?"
🤖 [usa get_options_chain] Lista calls e puts com strikes...
👤 "O mercado está aberto agora?"
🤖 [usa get_market_status] Informa status atual...
👤 "Busque empresas de tecnologia"
🤖 [usa search_instruments] Lista empresas do setor...oplab-mcp/
├── server.py # Servidor MCP principal
├── requirements.txt # Dependências Python
├── Dockerfile # Imagem Docker
└── README.md # Este arquivo# Ver logs do container
docker logs -f oplab-mcp
# Reiniciar servidor
docker restart oplab-mcp
# Parar e remover
docker stop oplab-mcp && docker rm oplab-mcp
# Rebuild após mudanças
docker build -t oplab-mcp:latest . && docker restart oplab-mcpErro: OPLAB_ACCESS_TOKEN não configurado
Solução: Certifique-se de passar o token via -e OPLAB_ACCESS_TOKEN=...
Verifique se o servidor está rodando: docker ps | grep oplab-mcp
Teste o endpoint: curl http://localhost:8000/mcp
Verifique a URL na configuração do agente
Reinicie o agente após configurar
/market/stocks/{symbol} - Informações de ações
/market/historical/{symbol}/{resolution} - Dados históricos
/market/options/{symbol} - Cadeia de opções
/market/quote - Cotações em tempo real
/market/instruments/search - Busca de instrumentos
/market/status - Status do mercado
/market/interest_rates - Taxas de juros
Contribuições são bem-vindas! Sinta-se à vontade para:
Fazer fork do projeto
Criar uma branch para sua feature (git checkout -b feature/MinhaFeature)
Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
Push para a branch (git push origin feature/MinhaFeature)
Abrir um Pull Request
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
Para dúvidas ou problemas:
Abra uma issue no GitHub
Consulte a documentação do OpLab
Feito com ❤️ para a comunidade de desenvolvedores brasileiros
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
Connect your XP account to AI via Brazil's Open Finance: balances, statements, cards, investments. R
Brazilian financial market data (B3): quotes, fundamentals, dividends, REITs (FIIs), BDRs, crypto, F
Live US options chains with Greeks and IV, a screener, SQL, and FMP fundamentals.
