mcpField
Y
yfinance MCP Server

yfinance MCP Server

Local
github.com/Otman404Finance5Updated 80w ago
Repository

About yfinance MCP Server

yfinance MCP Server gives LLMs current prices and news for stock and cryptocurrency tickers. It exposes separate tools for price lookup over a selected period and news retrieval.

Key features

  1. 01Stock and crypto price lookup
  2. 02Selectable price history period
  3. 03Ticker-specific news retrieval
  4. 04Configurable article count

Use cases

  1. 01Checking a ticker's current price
  2. 02Reviewing prices over a chosen period
  3. 03Gathering news about a ticker

MCP support

It exposes price and news lookup tools to MCP clients. The tools accept a ticker and optional period or article count.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

yfinance MCP Server

smithery badge Model Context Protocol server that allows LLMs to get accurate and up-to-date prices and news about stock/cryptocurrencies tickers.

Available Tools

  • get_price_tool: Get the price of a stock/cryptocurrency ticker
    • Arguments:
      • ticker (string): Required - Ticker name or alias (e.g., "BTC-USD", "AAPL")
      • period (string): Optional - Time period (e.g., "1d", "5d", "1mo"). Defaults to "1d"
  • get_news_tool: Get the news of a stock/cryptocurrency ticker.
    • Required arguments:
      • ticker (string): Required
      • count (string): Optional - Number of articles to retrieve (default: 5)

Installation

Installing via Smithery

To install yfinance-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Otman404/finance-mcp-server --client claude
Using uv

Install the package locally

uv pip install -e .

Run the server

finance-mcp-server

Using docker

# build the container
docker build -t finance-server .

# run the container
docker run -it finance-server

Configuration

Usage for Claude Desktop

Add the following to claude_desktop_config.json

uvx
"mcpServers": {
  "finance": {
    "command": "uvx",
    "args": ["finance-mcp-server"]
  }
}
docker
{
  "mcpServers": {
    "finance": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "finance-server"]
    }
  }
}

Usage for 5ire

uvx
{
  "key": "finance",
  "command": "uvx",
  "args": ["finance-mcp-server"]
}
docker
{
  "key": "finance-server",
  "command": "docker",
  "args": ["run", "-i", "--rm", "finance-server"]
}

Example Interactions

example

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.