The Status Invest MCP Server enables querying and managing stock market data through external API integration.
- Fetch basic stock information: Use
get-acoes
command with an array of stock symbols (e.g.,["PETR4", "VALE3"]
). - Fetch detailed stock indicator information: Use
get-indicadores
command with an array of stock symbols (e.g.,["ITUB4", "BBDC4"]
). - Fetch stock payment dates: Use
get-acoes-datas-pagamento
command with stock symbols and date range (e.g.,{"stock": ["PETR4"], "initialDate": "2023-01-01", "finalDate": "2023-12-31"}
).
Input validation is enforced using Zod and JSON Schema to ensure data integrity.
Used for input validation in the MCP server, ensuring data sent to the Status Invest API is properly formatted
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:
Installation
MCP Server Configuration in VSCode
- Press
Ctrl+Shift+P
and select "MCP: List Servers" - Select "stocks" and then "Start Server"
MCP Server Output in VSCode
- Press
Ctrl+Shift+P
and 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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
MCP Status Invest: A Model Context Protocol (MCP) server for interacting with the Status Invest API. Provides tools for fetching stock data and indicators, with a layered architecture and data validation using Zod
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.Last updated -356730TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface. Updated to use Coin Cap API v3Last updated -3504TypeScriptMIT License
- AsecurityAlicenseAqualityMCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.Last updated -11433PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.Last updated -32,7214JavaScriptMIT License