Advertise
MCP.so
Sign In

yfinance MCP Server

@Otman404

Repository

Basic information

Category

Finance & Commerce

Transports

stdio

Author

Otman404

About yfinance MCP Server

Finance mcp server- Get up-to-date prices and news about stocks and cryptocurrencies

yfinance MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "finance-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@Otman404/finance-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

yfinance MCP Server tools

2

Get the price of a stock/cryptocurrency ticker

Get the news of a stock/cryptocurrency ticker.

Overview

What is yfinance MCP Server?

yfinance MCP Server is a Model Context Protocol (MCP) server that gives LLMs access to accurate and up-to-date prices and news for stock and cryptocurrency tickers. It is designed for AI assistants that need live financial market data.

How to use yfinance MCP Server?

Install via Smithery, uv pip, or Docker. The server exposes two tools: get_price_tool (requires a ticker string, with an optional period string defaulting to "1d") and get_news_tool (requires a ticker string, with an optional count integer defaulting to 5). Add the server configuration to your MCP client’s settings (examples are provided for Claude Desktop and 5ire).

Key features of yfinance MCP Server

  • Provides real-time prices for stock and cryptocurrency tickers
  • Delivers news articles for any given ticker symbol
  • Configurable data periods and article count
  • Deployable via Smithery, uv, or Docker
  • Integrates with Claude Desktop and 5ire clients

Use cases of yfinance MCP Server

  • An AI assistant answering “What is AAPL’s current share price?”
  • An agent summarizing the latest news for BTC-USD
  • A research tool fetching one‑week price history for a stock portfolio
  • A chat‑based market monitor that checks multiple tickers on demand

Frequently asked questions

1

What data sources does it use?

The README does not specify the underlying data source, but it uses the package name `finance-mcp-server` and is listed as a yfinance MCP server.

2

What are the tool arguments for `get_price_tool`?

A `ticker` string (required) and a `period` string (optional; defaults to "1d").

3

What are the tool arguments for `get_news_tool`?

A `ticker` string (required) and a `count` string (optional; defaults to 5 articles).

4

How can I install yfinance MCP Server?

Via Smithery (`npx -y @smithery/cli install @Otman404/finance-mcp-server --client claude`), with `uv pip install -e .` and then running `finance-mcp-server`, or by building and running a Docker container.

5

Does yfinance MCP Server require an API key?

No — the README does not mention any authentication or API key requirement.

Comments

More Finance & Commerce MCP servers

akta.pro

akta-pro

Pay-as-you-go private company data, news and signals API for AI agents, financial services and GTM. Data on 20M+ companies (74 data points) and news across 77 event types.

x402-list-mcp

mcccsm

MCP server for x402-list.com: discover x402 payment services and on-chain-verified facilitator settlement volumes. Published on npm as x402-list-mcp.

26

Cliometry

Cliometry

Live Korean market measurements for AI agents — SK Hynix ADR premium, realized leverage multiples for KODEX/SOXL/TQQQ, VIX regime, Korean semiconductor sector RRG. Pre-computed daily values, structured responses, CC BY 4

BackPow PoW Oracle MCP Server

BackpowCom

Live Proof-of-Work mining data for AI agents: difficulty, hashrate, solo-mining odds, cost of production and hardware profitability for 126+ networks and 770+ ASIC/GPU/CPU models. Read-only, no API key.

1

ROIC.ai MCP Server

Roic AI

ROIC.ai is a financial data and stock market MCP server for AI assistants.

Advertise