💵 Finance MCP

Model Context Protocol (MCP) server and client for retrieving annual reports of publicly listed companies across global stock exchanges.

Overview

Finance MCP provides a lightweight MCP-compatible server and client architecture for discovering and retrieving annual reports from publicly listed companies worldwide.

The project is designed for:

• Financial research teams
• Investment analysis platforms
• Internal finance automation systems

Features

• Retrieve annual report URLs for globally listed companies
• MCP-compatible server and client implementation
• Simple Python-based architecture
• Easy integration into existing workflows
• Optimized for automation and research use cases

Requirements

• Python 3.13+
• uv package manager

Install uv:

pip install uv

Setup

1. Sync up with the environment

uv sync

Running the Application

Start the MCP server and client in separate terminals.

Start MCP Server

uvicorn server:app --host 0.0.0.0 --port 8000

Start Streamlit

streamlit run app.py

Example Use Cases

Financial Research

Retrieve annual reports for public companies and integrate them into research workflows.

Compliance Automation

Automate collection and archival of company disclosures and filings.

Internal Tooling

Integrate report discovery into enterprise finance systems and dashboards.

License

This project is licensed under the MIT License.