Advertise
MCP.so
Sign In

Yfinance MCP Server

@onori

Repository

Basic information

Category

Finance & Commerce

Transports

stdio

Author

onori

About Yfinance MCP Server

Unofficial MCP server for Yahoo Finance stock data.

Yfinance MCP Server config

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

{
  "mcpServers": {
    "yfinance": {
      "command": "npx",
      "args": [
        "@onori/yfinance-mcp-server"
      ]
    }
  }
}

Yfinance MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is yfinance-mcp-server?

yfinance-mcp-server is an unofficial Message Control Protocol (MCP) server that provides a simple interface to retrieve stock market data from Yahoo Finance. It is built with TypeScript and intended for use with any MCP client to fetch historical stock data for given symbols.

How to use yfinance-mcp-server?

Install and run using npx @onori/yfinance-mcp-server. Configure your MCP client (e.g., Cursor) with the command and arguments shown above. The server exposes one tool, getStockHistory, which requires a symbol (e.g., "AAPL") and a period (e.g., "1d", "1mo", "1y"), with an optional interval ("1d", "1wk", "1mo").

Key features of yfinance-mcp-server

  • Get historical stock data with customizable periods and intervals.
  • Easy to use with any MCP client.
  • Built with TypeScript for type safety.
  • Single tool for retrieving stock history.
  • Supports common stock symbols via Yahoo Finance.

Use cases of yfinance-mcp-server

  • Fetch daily stock prices for a given symbol over the past week.
  • Retrieve monthly historical data for portfolio analysis.
  • Obtain stock data to render as formatted markdown tables in MCP clients.

Frequently asked questions

1

What data does yfinance-mcp-server provide?

It provides historical stock data including Date, Open, High, Low, Close, and Volume for a given symbol and period.

2

How do I configure yfinance-mcp-server with my MCP client?

Add the following to your MCP client configuration: `"command": "npx", "args": ["@onori/yfinance-mcp-server"]`.

3

What are the runtime requirements?

You need Node.js and npx installed. The server runs as a command-line tool and fetches data from Yahoo Finance.

4

Is yfinance-mcp-server an official Yahoo Finance product?

No, it is an unofficial MCP server and not affiliated with Yahoo Finance.

5

What parameters does the getStockHistory tool accept?

It requires `symbol` (string) and `period` (string, e.g., "1d", "1mo", "1y") and optionally `interval` ("1d", "1wk", "1mo").

Comments

More Finance & Commerce MCP servers

InvestJournal

Your investing research inside Claude: watchlists, financial ratios, reverse-DCF valuations, investment theses, notes, portfolio, earnings calendar and news for the companies you follow. 70 read and write tools; ask what

K

Korea & Asia Everyday Calculators (kWhmate)

kWhmate

Free, no-key calculators with sources: household electricity bills and LED savings for Korea (KEPCO), Taiwan (Taipower), the Philippines (Meralco, updated monthly) and Japan (TEPCO); Seoul/Busan taxi fares, tourist tax r

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

fAlpha

fAlpha.ai, Inc.

Read-only US equity research for AI agents: fAlpha's model signal for a stock with the drivers behind it, signal history and flips, news sentiment, analyst coverage, SEC filings, FRED macro and fundamentals. Every result

The Gold Barometer

thegoldbarometer

Today's gold buying-conditions score (0-100), its published history, and what followed similar readings since 1971. Three read-only tools, no key, free CC BY data.

Advertise