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

FAQ from Investidor10

What tool does Investidor10 provide?

The server exposes a single tool called get-acoes that returns basic stock information from the Investidor10 API.

Which external API does Investidor10 use?

It uses the Investidor10 API, which supplies stock market data such as prices and indicators.

What are the runtime requirements?

Node.js is required. The server must be built with npm run build before use.

How is the server transported?

The server uses StdioServerTransport, meaning it communicates over standard input/output, typically managed by the MCP host (e.g., VS Code).

Does Investidor10 require authentication?

The README does not mention any API keys or authentication steps for the Investidor10 API.