Yahoo Fianace MCP

Created By
a05031113a year ago
Provides a Model Context Protocol (MCP) server that exposes various functions from the yfinance library as individual tools. This allows an MCP client to query Yahoo Finance data. Uses uv for environment management and FastMCP for the server implementation.
Overview

Overview

What is Yahoo Finance MCP?

Yahoo Finance MCP is a Python-based Model Context Protocol (MCP) server built using FastMCP. It exposes a comprehensive set of tools derived from the yfinance library, allowing AI clients (like Claude Desktop) to easily access and query various types of financial data directly from Yahoo Finance.

How to use Yahoo Finance MCP?

To use Yahoo Finance MCP, clone the repository, set up a Python virtual environment using uv, and install the required dependencies (requirements.txt). Run the server by executing python main.py. Configure your MCP client (e.g., Claude Desktop) to connect to the server process using the specified command and args in the server configuration (pointing to the project's virtual environment Python and main.py). The client can then invoke specific financial data tools like get_news(symbol='AAPL') or get_income_statement(symbol='TSLA', freq='quarterly').

Key features of Yahoo Finance MCP?

  • Direct MCP access to a wide range of Yahoo Finance data via the yfinance library.
  • Granular tools for specific data retrieval (e.g., price, history, financials, news, holders, options, ESG).
  • Standard MCP server implementation using FastMCP and stdio transport.
  • Easy setup using uv for environment and dependency management.
  • Returns structured financial data, often as JSON strings, suitable for AI processing.

Use cases of Yahoo Finance MCP?

  1. Retrieving real-time or historical stock prices for specific tickers.
  2. Fetching fundamental financial data like income statements, balance sheets, and cash flow reports (annually or quarterly).
  3. Accessing company news, dividend history, analyst recommendations, and upcoming earnings dates.
  4. Querying holder information (major, institutional, mutual fund) and sustainability (ESG) scores.
  5. Getting options data like expiration dates and option chains.

FAQ from Yahoo Finance MCP?

  • Is Yahoo Finance MCP free to use?

    Yes, the project itself is open-source. It relies on the yfinance library which accesses publicly available data from Yahoo Finance.

  • Where does the financial data come from?

    All data is sourced directly from Yahoo Finance via the yfinance library. Data accuracy and availability depend on Yahoo Finance itself.

  • What do I need to run this server?

    You need Python and uv installed. Clone the repository and follow the setup instructions in the README to install dependencies within a virtual environment.

  • Can I request data for any stock symbol?

    You can request data for any symbol available on Yahoo Finance. Availability of specific data points (like options or certain historical intervals) may vary by symbol and market.

Server Config

{
  "mcpServers": {
    "yahoo_finance_engine": {
      "command": "/path/to/your/yahoo-finance/.venv/bin/python",
      "args": [
        "/path/to/your/yahoo-finance/main.py"
      ]
    }
  }
}
Project Info
Created At
a year ago
Updated At
a year ago
Author Name
a05031113
Star
-
Language
-
License
-
Category

Recommend Servers

View All
//beforeyouship — LLM Cost Modeling From Your Editor
@Indiegoing

Query realistic LLM cost models without leaving your editor. beforeyouship models the **true monthly cost** of an LLM app architecture — retries, prompt caching, batch discounts, infra overhead, and 3×/10× growth — across GPT-5.x, Claude, Gemini, DeepSeek, and more. Not a token calculator: a planning tool for the design phase, before you commit to a stack. **No API key needed to try it** — demo mode covers the six free-tier models. A Pro key from [beforeyouship.dev](https://beforeyouship.dev) unlocks the full 18-model catalog. ## What you can ask - "How much will a RAG chatbot cost at 10,000 requests/day?" - "Compare Claude Haiku vs Gemini Flash pricing for my workload" - "What's the cheapest model for a multi-step agent at scale?" - "Show me current per-token prices for Anthropic models" ## Tools ### `estimate_cost` Full cost model for an architecture at a given usage level. Returns Naive / Realistic / Worst Case monthly cost per model, 3×/10× growth scenarios, and an opinionated recommendation with reasoning. ### `get_model_prices` Current per-1M-token pricing — input, output, cached input, batch — with context windows and staleness metadata. ### `list_archetypes` Seven preset architecture patterns (simple chatbot, chatbot with history, RAG pipeline, multi-model router, coding assistant, document processor, multi-step agent) used as starting points for estimates. ## Setup **Claude Code:** ​```bash claude mcp add --transport http beforeyouship https://beforeyouship.dev/api/mcp ​``` **Cursor / other clients** — add a remote server: ​```json { "mcpServers": { "beforeyouship": { "type": "streamable-http", "url": "https://beforeyouship.dev/api/mcp" } } } ​``` Add an `Authorization: Bearer bys_...` header with a Pro key for the full catalog. ## Try it > Estimate the monthly cost of a RAG pipeline at 10,000 requests/day

12 hours ago
Docwand

12 hours ago
Shippo
@Shippo

20 hours ago