Financial Reports MCP Server
@itisaevalex
Instantly query European financial data for AI. This FastMCP server connects the FinancialReports.eu API to powerful language models, making complex reports easy to search, analyze, and explain
概览
What is Financial Reports MCP Server?
An MCP (Model Context Protocol) server for accessing the Financial Reports API. It provides tools and resources to search for companies, retrieve financial filings, look up GICS industry classifications, and access related data. Designed for developers using MCP clients like Claude Desktop.
How to use Financial Reports MCP Server?
You can run it via Docker (recommended), the Smithery CLI, or locally with Python 3.11+. Configure with a .env file containing API_KEY, API_BASE_URL, and MCP_TRANSPORT=stdio. For Claude Desktop, use the Docker or uv configuration examples in the examples/ directory.
Key features of Financial Reports MCP Server
- Search for companies by name, country, or sector
- Get detailed company information
- Access latest financial filings
- Look up GICS industry classifications
- Retrieve filing details and content
- All tools use the real Financial Reports API (no mock)
Use cases of Financial Reports MCP Server
- Search for a company and retrieve its profile and recent filings
- Find the latest annual reports from major European banks
- Look up industry classifications for a specific sector
- Access processed content from specific filings
- Integrate financial data into an AI assistant workflow
FAQ from Financial Reports MCP Server
What are the prerequisites to run the server?
Python 3.11+ is required. Docker is recommended for reproducibility. For local development, install dependencies from requirements.txt and set up a virtual environment.
How do I configure the server?
Create a .env file in the root directory with API_KEY, API_BASE_URL (e.g., https://api.financialreports.eu/), and MCP_TRANSPORT=stdio. Pass secrets as -e arguments when using Docker.
What transport does the server use?
The server uses stdio transport by default, which is compatible with Claude Desktop.
Is the server compatible with Windows?
Yes. All methods are supported on Windows. For Claude Desktop, uv-based installation is recommended. Docker requires Docker Desktop for Windows.
Can I run the server without an API key?
No. A valid Financial Reports API key is required for authentication. The server only uses the real API and no longer includes mock logic.
