Yahoo Finance · narumiruna — Claude Code MCP server: what it does, how to install
Connects AI assistants to Yahoo Finance market quotes, balance sheets, options chains, and news via yfinance. It lets you chart price history and screen equities directly from the prompt.
claude mcp add yfinance-mcp -- uvx yfmcpWhat Yahoo Finance does
This server connects AI environments to market records using the Python yfinance package. It exposes tools for historical OHLCV numbers, insider transactions, balance sheets, and analyst revisions. Beyond tabular output, it can render candlestick or volume profile charts as WebP pictures directly in the session.
You can inspect ETF holdings, run stock screeners, or track leaders across eleven distinct market sectors. The server enforces rigid ticker validation. If a symbol includes unexpected characters outside ASCII letters or supported separators like BRK.B, the tool rejects the call with an INVALID_PARAMS error without calling Yahoo servers.
Starting the server requires uvx on your system.
What it helps with
- pull stock fundamentals, balance sheets, and valuation metrics for a ticker
- generate candlestick and volume profile charts as WebP images
- track consensus price targets and recent analyst rating revisions
- filter market leaders and exchange-traded funds across industry sectors
Example prompts for the agent
- Show me a candlestick chart for
AAPLcovering the past month alongside consensus targets. - Find the top five growth companies in the Technology sector using
yfinance_get_top. - Check recent news headlines and income statement figures for ticker
MSFT.
How to install Yahoo Finance
Platform CLI
claude mcp add yfinance-mcp -- uvx yfmcpuvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>
Platform CLI
codex mcp add yahoo-finance -- uvx yfmcpuvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>
Config file
{
"mcpServers": {
"yahoo-finance": {
"command": "uvx",
"args": [
"yfmcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>
Config file
{
"servers": {
"yahoo-finance": {
"type": "stdio",
"command": "uvx",
"args": [
"yfmcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>
Platform CLI
gemini mcp add yahoo-finance uvx yfmcpuvx runs the command named after the package; if the README names another one, use uvx --from yfmcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Yahoo Finance
How to install Yahoo Finance in Claude Code?
Run claude mcp add yahoo-finance -- uvx yfmcp in your terminal. You will need uv installed so the CLI can execute the command with uvx.
What does the Yahoo Finance MCP server do?
It bridges AI chat assistants with the yfinance library. This allows your agent to fetch equity prices, balance sheets, options chains, analyst ratings, and rendered price charts.
Does this MCP server require an API key?
No API key is needed because the server retrieves data through the open-source yfinance package. You only need an internet connection and valid ASCII ticker symbols like AAPL or BTC-USD.
Similar MCP servers
Everything for Finance and business →Yahoo Finance by other authors comes first.
