MCP Server: Yahoo Finance Data Extractor

Multi-purpose backend server combining FastAPI and MCP capabilities for extracting comprehensive financial data from Yahoo Finance.

• GitHub Repo

What It Does

A comprehensive financial data extraction platform that combines FastAPI endpoints and Model Context Protocol (MCP) integration:

• Exposes three types of endpoints: /docs (API Docs), /yfin/* (FastAPI), and /mcp (MCP/LLM).
• Enhanced with MCP capabilities using fastapi-mcp package.
• Includes detailed API documentation and Pydantic models.
• Provides both financial statements and market data.
• Excel-friendly data formats available.

How to Use

• Available Endpoints
  • Base URL: https://yfin.hosting.tigzig.com/
  • MCP Endpoint: https://yfin.hosting.tigzig.com/mcp
  • API Documentation: https://yfin.hosting.tigzig.com/docs
• Access Methods
  • API Documentation: Visit /docs for interactive Swagger UI.
  • Direct API: Make HTTP requests to /yfin/* endpoints.
  • MCP/LLM: Connect to /mcp using any MCP-compatible client.

How It Works

• Financial Statements: Balance Sheet, Income Statement, Cash Flow. Annual and quarterly data available. Excel-friendly formats supported.
• Market Data: Historical price data with adjustments. Market cap and share statistics. Comprehensive OHLCV data.
• AI Integration: Natural language query support via MCP. Structured responses for AI consumption. Automatic request/response validation.

How to Replicate

• Installation Steps: Clone the repository shared-yfin-coolify. Install dependencies from requirements.txt. Run the server with uvicorn main:app --reload.
• Key Dependencies: FastAPI & fastapi-mcp, yfinance & pandas, Python-dotenv, OpenAPI tools.

Resources & Examples

• MCP Server Source Code (GitHub)
• API Docs
• FastAPI MCP (GitHub)