Status Invest MCP Server
newerton/mcp-status-invest
Acesso a dados de ações e indicadores via MCP
Ver no GitHubServidor MCP que integra a API Status Invest para consultar dados de mercado de ações, indicadores técnicos e datas de pagamento de dividendos. Implementa arquitetura em camadas com validação de dados usando Zod e é pronto para integração com Claude via MCP.
Instalação
npx convez-ai newerton/mcp-status-invest1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise de indicadores técnicos de ações em tempo real
- Consulta de preços e dados fundamentais de ativos
- Automação de decisões de investimento com IA
- Integração de dados de mercado em agentes Claude
Veredito

MCP server bem arquitetado para integração de dados financeiros. Implementação sólida com DDD, validação Zod e suporte nativo a Claude, ideal para quem precisa enriquecer agentes de IA com dados de mercado brasileiro.
README
A tradução para o português deste README ainda está na fila.
Status Invest - MCP Server
This project is part of the Model Context Protocol (MCP) ecosystem and provides tools to interact with external APIs and manage specific domain models. It is designed to demonstrate how to build an MCP server with external API integration and data validation.
Table of Contents
- Features
- Architecture
- Installation
- MCP Server Configuration in VSCode
- MCP Server Output in VSCode
- Contribution
- License
Features
- get-acoes: Fetch basic stock information.
- get-indicadores: Fetch detailed stock indicator information.
- get-acoes-datas-pagamento: Fetch stock payment dates.
- Input validation using Zod.
- Integration with the Status Invest API using
fetch(infrastructure layer).
Architecture
The project follows a layered architecture inspired by Domain-Driven Design (DDD) patterns:
-
Domain (
src/domain): Defines interfaces and types that represent data structures (e.g.,StatusInvest). -
Infrastructure (
src/infrastructure): Implements external services, such asStatusInvestApiService, responsible for making HTTP calls to the Status Invest API. -
Application (
src/application): Contains business logic inStatusInvestService, which processes and formats data from the infrastructure. -
Interface (
src/interface): Includes controllers (StatusInvestToolsController) that register tools in the MCP server, define validation schemas, and return results. -
Entry Point (
src/main.ts): Initializes theMcpServer, configures the transport (StdioServerTransport), instantiates services and controllers, and starts listening on stdio.
The folder structure is as follows:
src/
├── domain/
│ └── models/ # Domain interfaces
├── infrastructure/
│ └── services/ # External API implementations (Status Invest)
├── application/
│ └── services/ # Business logic and data formatting
├── interface/
│ └── controllers/ # MCP tool registration and validation
└── main.ts # Server entry point
build/ # Compiled JavaScript code
.vscode/ # Contains the mcp.json file, MCP Server config
Installation
git clone git@github.com:newerton/mcp-status-invest.git
cd mcp-status-invest
npm install
npm run build
MCP Server Configuration in VSCode
- Press
Ctrl+Shift+Pand select "MCP: List Servers" - Select "stocks" and then "Start Server"
MCP Server Output in VSCode
- Press
Ctrl+Shift+Pand select "MCP: List Servers" - Select "stocks" and then "Show Output"
Contribution
Pull requests are welcome! Feel free to open issues and discuss improvements.
License
This project is licensed under the MIT license - see the LICENSE file for details.