What is Mcp Status Invest

mcp-status-invest is an MCP server designed to interact with the Status Invest API, providing tools for fetching stock data and indicators with a focus on data validation and a layered architecture.

Use cases

Use cases include building applications that require real-time stock data, creating dashboards for stock analysis, and developing financial reporting tools.

How to use

To use mcp-status-invest, integrate it within your application to query stock market data by utilizing the provided functions such as get-acoes, get-indicadores, and get-acoes-datas-pagamento.

Key features

Key features include fetching basic stock information, detailed stock indicators, and payment dates, along with input validation using Zod and integration with the Status Invest API.

Where to use

mcp-status-invest can be used in financial applications, stock market analysis tools, and any domain requiring stock data integration and management.

An integration that enables MCP tools to query stock market data, such as stock prices, indicators, and payment dates, using the Status Invest API.

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 as StatusInvestApiService, responsible for making HTTP calls to the Status Invest API.

• Application (src/application):
  Contains business logic in StatusInvestService, 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 the McpServer, 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 [email protected]:newerton/mcp-status-invest.git
cd mcp-status-invest
npm install
npm run build

MCP Server Configuration in VSCode

1. Press Ctrl+Shift+P and select “MCP: List Servers”
2. Select “stocks” and then “Start Server”

MCP Server Output in VSCode

1. Press Ctrl+Shift+P and select “MCP: List Servers”
2. 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.