Status Invest MCP Server

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.

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 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+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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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.

Tools

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

Crypto Price & Market Analysis MCP Server
truss44
A
security
A
license
A
quality
A 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 -
3
567
30
TypeScript
MIT License
mcp-coincap-jj
wazzan
A
security
A
license
A
quality
A 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 v3
Last updated -
3
504
TypeScript
MIT License
Financial Datasets MCP Serverofficial
financial-datasets
A
security
A
license
A
quality
MCP 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 -
11
433
Python
MIT License
FlightRadar MCP Server
Cyreslab-AI
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.
Last updated -
3
2,721
4
JavaScript
MIT License

View all related MCP servers

Status Invest MCP Server