Investidor10 - MCP Server

What is Investidor10?

Investidor10 is a Model Context Protocol (MCP) server that enables AI assistants to query Brazilian stock market data—such as stock prices and indicators—via the Investidor10 API. It follows a Domain-Driven Design architecture and uses Zod for input validation, making it suitable for developers who want to integrate financial data into MCP-compatible tools.

How to use Investidor10?

Clone the repository, run npm install && npm build, then configure the server in VS Code by pressing Ctrl+Shift+P, selecting “MCP: List Servers”, choosing “stocks”, and clicking “Start Server”. The server exposes a single tool, get-acoes, for fetching stock information.

Key features of Investidor10

• get-acoes tool for fetching basic stock information
• Input validation using Zod schemas
• Integration with the Investidor10 API via fetch
• Layered architecture based on Domain-Driven Design patterns
• Runs on stdio transport for VS Code integration

Use cases of Investidor10

• Query current stock prices for Brazilian companies
• Fetch financial indicators through an MCP-compatible client
• Build AI assistants that answer stock market questions
• Extend VS Code or other MCP hosts with real-time market data