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

Stockpile Market MCP

casualbrooks

Official Model Context Protocol (MCP) server for Stockpile Market - Autonomous Agent Commerce & Curation.

Capital.com MCP

capital-com-sv

CFDs are complex instruments and come with a high risk of losing money rapidly due to leverage. 81.31% of retail investor accounts lose money when trading CFDs with this provider. You should consider whether you understa

4

Priors

priors-agents

On-chain credit pool for ERC-8004 AI agents on Robinhood Chain: agents borrow USDG, repay it and earn a public credit score. Contracts, SDK, CLI, MCP server (@priors/mcp), x402 helpers (@priors/x402) and an agent skill.

4

WISEPIM Commerce Reference

WISEPIM

Look up HS headings, check listing requirements across 12 commerce channels, and flag environmental claims in product copy. Runs offline with no account or API key.

OpenProfit

Ask your agent which of your apps makes money. OpenProfit reads revenue from Stripe, Polar, Paddle, Lemon Squeezy and RevenueCat and costs from OpenAI, Anthropic, Vercel, Cloudflare, Railway and more, then gives Claude,

Advertise