OpLab MCP Server
Click on "Install 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 ServerMostre 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.
OpLab MCP Server
Servidor MCP (Model Context Protocol) para integração com as APIs do OpLab, permitindo que agentes de IA acessem dados do mercado financeiro brasileiro.
📦 Ferramentas Disponíveis
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
🔧 Instalação
Requisitos
Docker e Docker Compose OU
Python 3.11+
Token de acesso OpLab (obtenha aqui)
Opção 1: Docker (Recomendado)
# 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:latestOpção 2: Python local
# 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.py⚙️ Configuração
Variáveis de Ambiente
Variá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 |
Modos de Operação
🌐 Modo HTTP (para agentes remotos)
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
💻 Modo stdio (para agentes locais)
Executa via stdio para integração direta:
docker run -i --rm \
-e OPLAB_ACCESS_TOKEN=seu_token \
-e SERVER_MODE=stdio \
oplab-mcp:latest🤖 Integração com Agentes
Claude Desktop
Arquivo: ~/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"
]
}
}
}📖 Exemplos de Uso
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...🛠️ Desenvolvimento
Estrutura do Projeto
oplab-mcp/
├── server.py # Servidor MCP principal
├── requirements.txt # Dependências Python
├── Dockerfile # Imagem Docker
└── README.md # Este arquivoComandos Úteis
# 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-mcpToken inválido
Erro: OPLAB_ACCESS_TOKEN não configurado
Solução: Certifique-se de passar o token via -e OPLAB_ACCESS_TOKEN=...
Agente não conecta
Verifique se o servidor está rodando:
docker ps | grep oplab-mcpTeste o endpoint:
curl http://localhost:8000/mcpVerifique a URL na configuração do agente
Reinicie o agente após configurar
Endpoints Utilizados
/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
🤝 Contribuindo
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
📝 License
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
🔗 Links Úteis
💬 Suporte
Para dúvidas ou problemas:
Abra uma issue no GitHub
Consulte a documentação do OpLab
Feito com ❤️ para a comunidade de desenvolvedores brasileiros
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceProvides real-time access to financial market data including stock quotes, company information, cryptocurrency exchange rates, historical options chains, and time series data through the Alpha Vantage API.
- Alicense-qualityCmaintenanceEnables access to real-time and historical market data including stocks, ETFs, forex, and cryptocurrencies, with support for time series, quotes, dividends, splits, and earnings.MIT
- AlicenseAqualityCmaintenanceProvides Brazilian financial market data including stock prices, fundamentals, dividends, FIIs, and macro indicators to AI assistants.11MIT
- AlicenseBqualityCmaintenanceMCP server for B3 (Brazilian stock exchange) data, offering tools for real-time quotes, historical prices, dividends, FIIs, fundamental analysis, options, and indices via natural language.9MIT
Related MCP Connectors
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
brapi.dev MCP — Brazilian stock + crypto + ETF quotes.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Perdiga/OpLab-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server