MCP Yahoo Finance

by marckwei

MCP Yahoo Finance

A Model Context Protocol (MCP) server for Yahoo Finance interaction. This server provides tools to get pricing, company information and more.

Please note that mcp-yahoo-finance is currently in early development. The functionality and available tools are subject to change and expansion as I continue to develop and improve the server.

Installation

You don't need to manually install mcp-yahoo-finance if you use uv. We'll use uvx to directly run mcp-yahoo-finance.

I would recommend using this method if you simply want to use the MCP server.

Using pip

Using pip.

pip install mcp-yahoo-finance

Using Git

You can also install the package after cloning the repository to your machine.

git clone git@github.com:maxscheijen/mcp-yahoo-finance.git cd mcp-yahoo-finance uv sync

Configuration

Claude Desktop

Add this to your claude_desktop_config.json:

{ "mcpServers": { "yahoo-finance": { "command": "uvx", "args": ["mcp-yahoo-finance"] } } }

You can also use docker:

{ "mcpServers": { "yahoo-finance": { "command": "docker", "args": ["run", "-i", "--rm", "IMAGE"] } } }

VSCode

Add this to your .vscode/mcp.json:

{ "servers": { "yahoo-finance": { "command": "uvx", "args": ["mcp-yahoo-finance"] } } }

Examples of Questions

  1. "What is the stock price of Apple?"
  2. "What is the difference in stock price between Apple and Google?"
  3. "How much did the stock price of Apple change between 2024-01-01 and 2025-01-01?"

Build

Docker:

docker build -t [IMAGE] .

Test with MCP Inspector

npx @modelcontextprotocol/inspector uv run mcp-yahoo-finance

Acknowledgements

-
security - not tested
-
license - not tested
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides tools for interacting with Yahoo Finance, allowing users to retrieve stock prices, company information, and perform financial data comparisons.

  1. Installation
    1. Using pip
    2. Using Git
  2. Configuration
    1. Claude Desktop
    2. VSCode
  3. Examples of Questions
    1. Build
      1. Test with MCP Inspector
        1. Acknowledgements
          ID: l4agmpmhk1