📈 Financial Data MCP Server

A Model Context Protocol server that gives AI assistants like Claude live access to stock, equities, and cryptocurrency data from Yahoo Finance.

Ask your assistant "What's Apple trading at?" or "Compare AAPL, MSFT, and GOOGL" and get real-time answers backed by market data — no copy-pasting from finance sites.

✨ Features

Related MCP server: Yahoo Finance MCP Server

🧰 Available Tools

period values: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max

📋 Prerequisites

• Python 3.9 or newer

• pip for installing dependencies

• An MCP-compatible client (e.g. Claude Desktop) to use the server interactively

🚀 Installation

# 1. Clone the repository
git clone https://github.com/<your-username>/financial-data-mcp-server.git
cd financial-data-mcp-server

# 2. (Recommended) create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

▶️ Usage

Run the server directly (it communicates over stdio):

python server.py

Run the test suite to confirm everything works:

python test_server.py

Connect to Claude Desktop

Add the server to your claude_desktop_config.json (see DOCS.md for the exact path on your OS and platform-specific notes):

{
  "mcpServers": {
    "financial-data": {
      "command": "python3",
      "args": ["/absolute/path/to/financial-data-mcp-server/server.py"]
    }
  }
}

Restart Claude Desktop and the financial-data tools will be available.

💬 Example

You:  Compare AAPL, MSFT, and GOOGL.

Claude (via compare_stocks):
  AAPL   $301.54   P/E 36.46
  MSFT   $411.74   P/E 24.52
  GOOGL  $363.31   P/E 27.69

🗂️ Project Structure

.
├── server.py            # Main MCP server implementation
├── test_server.py       # Functional tests
├── client_example.py    # Example tool calls
├── requirements.txt     # Python dependencies
├── README.md            # You are here
└── LICENSE              # MIT License

Full documentation — setup, Claude Desktop connection, tools, MCP protocol reference, and troubleshooting — lives in DOCS.md.

📡 Data Source

All data is sourced from Yahoo Finance via the yfinance library. This project is not affiliated with or endorsed by Yahoo. Data is provided for informational purposes only and is not financial advice.

🔒 Security

Found a vulnerability? Please review our Security Policy for responsible disclosure instructions.

📄 License

Distributed under the MIT License. See LICENSE for details.

MCP-SERVER