MCP Server Financeiro

What is MCP Server Financeiro?

MCP Server Financeiro is a practical example of an MCP (Model Context Protocol) server built in Go. It simulates the management of financial tools and performs real‑time stock price queries using the Alpha Vantage public API. It is designed for developers learning how to structure an MCP server that exposes an endpoint /metadata alongside custom tools.

How to use MCP Server Financeiro?

Clone the repository, create a .env file with your Alpha Vantage API key (ALPHA_VANTAGE_API_KEY=your_key), run go mod tidy to install dependencies, then start the server with go run cmd/main.go. The server listens on http://localhost:8080. Use the endpoints: POST /register-financial-tool, GET /list-financial-tools, POST /query-stock-price, and GET /metadata.

Key features of MCP Server Financeiro

• Register financial tools dynamically
• List all registered financial tools
• Query real‑time stock prices via Alpha Vantage
• Expose metadata in standard MCP format

Use cases of MCP Server Financeiro

• Register a new financial tool for stock price queries
• Query the current price of a stock symbol (e.g., AAPL)
• List all tools for inspection by MCP client agents
• Provide MCP‑compliant metadata to client agents

FAQ from MCP Server Financeiro

How do I get an Alpha Vantage API key?

Sign up for a free account at the Alpha Vantage website and generate an API key.

What endpoints does MCP Server Financeiro expose?

It exposes four endpoints: POST /register-financial-tool, GET /list-financial-tools, POST /query-stock-price, and GET /metadata.

Where do I put the Alpha Vantage API key?

Create a .env file in the project root with the line ALPHA_VANTAGE_API_KEY=your_api_key_here.

What runtime does MCP Server Financeiro require?

A Go environment; dependencies are managed with go mod tidy and the server runs via go run cmd/main.go.