# Yahoo Finance

Connects AI assistants to Yahoo Finance market quotes, balance sheets, options chains, and news via yfinance. It lets you chart price history and screen equities directly from the prompt.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 204
- Author: narumiruna
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/narumiruna/yfinance-mcp
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/yahoo-finance

## What it does

This server connects AI environments to market records using the Python `yfinance` package. It exposes tools for historical OHLCV numbers, insider transactions, balance sheets, and analyst revisions. Beyond tabular output, it can render candlestick or volume profile charts as WebP pictures directly in the session.

You can inspect ETF holdings, run stock screeners, or track leaders across eleven distinct market sectors. The server enforces rigid ticker validation. If a symbol includes unexpected characters outside ASCII letters or supported separators like `BRK.B`, the tool rejects the call with an `INVALID_PARAMS` error without calling Yahoo servers.

Starting the server requires `uvx` on your system.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add yfinance-mcp -- uvx yfmcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add yahoo-finance -- uvx yfmcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": [
                "yfmcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yahoo-finance": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "yfmcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add yahoo-finance uvx yfmcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>

## When to use it
- pull stock fundamentals, balance sheets, and valuation metrics for a ticker
- generate candlestick and volume profile charts as WebP images
- track consensus price targets and recent analyst rating revisions
- filter market leaders and exchange-traded funds across industry sectors

## Example prompts
- Show me a candlestick chart for `AAPL` covering the past month alongside consensus targets.
- Find the top five growth companies in the Technology sector using `yfinance_get_top`.
- Check recent news headlines and income statement figures for ticker `MSFT`.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

## Other versions with the same name
- [Yahoo Finance · danishashko](https://affpapa.org/en/nevibecode/mcp/danishashko-yahoo-finance.md) — ★ 23

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md