compare_stocks
Compare Stocks
Compare key metrics across multiple stocks. Returns: Comparison table of price, market cap, P/E, dividend yield, and returns
tickersrequired
io.github.lkcairPublished by GitHub account lkcairv5.0.5Updated Oct 29, 2026
Yahoo Finance in 68 tools: stocks, crypto, forex, commodities, funds, options, analysts, calendars.
The publisher's own server: Finance Foundation
Local MCP server exposing 68 read-only Yahoo Finance tools so an assistant can look up stock, fund, crypto, forex and commodity market data.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
World's first AI-powered Yahoo Finance integration: 68 tools for stocks, ETFs, mutual funds, crypto, forex and commodities, in one Python file.
🚀 Thousands of downloads on ClawHub and OpenWebUI
Prices and history, financial statements, ratios and valuation history, analyst estimates and price targets, earnings, dividends, options, holders and insiders, funds and ETFs, market movers, sectors and industries, and earnings, IPO, economic and split calendars.
Needs uv. No API key.
Claude Code:
VS Code:
Claude Desktop, Cursor, Windsurf and other clients, in the client's MCP config file:
@latest picks up new releases when the client starts. Without uv: pip install yfinance-ai, then use "command": "yfinance-ai" with no args.
Listed in the MCP Registry as io.github.lkcair/yfinance-ai. Every tool is read-only.
The server runs over stdio with uvx yfinance-ai@latest, so any framework with MCP support can load all its tools.
LangChain: pip install "langchain[mcp]" langchain-anthropic
Google ADK: pip install "google-adk[mcp]"
Strands Agents: pip install strands-agents
MIT. Data comes from Yahoo Finance through yfinance and may be delayed. Not affiliated with Yahoo. For research and education, not investment advice.
Source: README.md at commit 2477fa8
Compare Stocks
Compare key metrics across multiple stocks. Returns: Comparison table of price, market cap, P/E, dividend yield, and returns
tickersrequiredDownload Multiple Tickers
Download historical data for multiple tickers at once (bulk operation). Returns: Summary of downloaded data for all tickers
periodtickersrequiredintervalAnalyst Estimates
Get analyst estimates for earnings, revenue, and EPS. Returns: Comprehensive analyst estimates and forecasts
tickerrequiredAnalyst Price Targets
Get detailed analyst price targets for a stock. Returns: Comprehensive price target data including current, low, mean, median, high targets and the number of analysts covering the stock
tickerrequiredAnalyst Recommendations
Get analyst recommendations and ratings. Returns: Analyst buy/hold/sell recommendations, consensus, and recent upgrades/downgrades
tickerrequiredAPI Status
Get API status and usage information. Returns: Current API usage statistics and configuration
Takes no parameters.
Balance Sheet
Get balance sheet data. Returns: Balance sheet with assets, liabilities, and equity
periodtickerrequiredCapital Gains
Get capital gains distributions (primarily for funds/ETFs). Returns: Capital gains distribution history
tickerrequiredCash Flow
Get cash flow statement data. Returns: Cash flow statement with operating, investing, and financing activities
periodtickerrequiredCommodity Price
Get commodity/futures price data. Returns: Current price, day change, and key market data
commodityrequiredCompany Info
Get detailed company information and business description. Returns: Company overview including sector, industry, employees, website, and business summary
tickerrequiredCompany Officers
Get company officers and key management. Returns: List of company officers with titles and compensation
tickerrequiredCompany Overview
Get a beautiful, insightful company overview with context for every metric. Perfect for quick overviews and basic questions about a company. Returns: Beautifully formatted company overview with insights and context
tickerrequiredComplete Analysis
Run a complete analysis of a stock by calling ALL available functions. This is the most comprehensive analysis available - use when user asks for "everything about" or "complete analysis of" a company. Returns: Comprehensive analysis with results from all applicable functions
peerstickerrequiredCorporate Actions
Get all corporate actions (dividends + splits combined). Returns: Combined history of dividends and stock splits
tickerrequiredCrypto Price
Get cryptocurrency price and market data. Returns: Current price, 24h change, market cap, volume, and key metrics
symbolrequiredDividends
Get dividend payment history and current metrics. Returns: Dividend history and current dividend metrics
periodtickerrequiredEarnings Calendar
Get earnings calendar including next earnings date and dividend dates. Returns: Upcoming earnings dates, ex-dividend dates, and dividend payment dates
tickerrequiredEarnings Dates
Get upcoming and past earnings dates with estimates. Returns: Earnings calendar with dates, estimates, and actual results
tickerrequiredEarnings History
Get historical earnings data with annual and quarterly figures. Returns: Historical earnings by year and quarter
tickerrequiredEconomic Calendar
Get upcoming economic events (CPI, jobs, GDP, rate decisions) with expected and prior values. Returns: Table of economic events by region and time
dayslimitEPS Revisions
Get EPS revision data showing analyst estimate changes. Returns: EPS revisions showing up/down estimate changes by analysts
tickerrequiredEPS Trend
Get EPS (Earnings Per Share) trend data showing how estimates have changed. Returns: EPS trend data showing estimate changes over different time periods
tickerrequiredFast Info
Get fast-access ticker information (lightweight, quick response). Returns: Quick summary with most recent price, market cap, and basic metrics
tickerrequiredFinancial Summary
Get a comprehensive one-page financial summary of a stock. Returns: Comprehensive summary including price, valuation, financials, and analyst data
tickerrequiredForex Rate
Get foreign exchange (forex) rate for a currency pair. Returns: Current exchange rate, bid/ask, day range, and recent changes
pairrequiredFund Holdings
Get top holdings for an ETF or mutual fund. Returns: List of top holdings with weights and values
limittickerrequiredFund Overview
Get overview data for an ETF or mutual fund. Returns: Fund category, family, total assets, expense ratio, and other key metrics
tickerrequiredFund Sector Weights
Get sector allocation/weights for an ETF or mutual fund. Returns: Sector allocation percentages for the fund
tickerrequiredGrowth Estimates
Get analyst growth estimates. Returns: Growth rate estimates for various periods
tickerrequiredHistorical Comparison
Compare historical price performance of multiple stocks. Returns: Performance comparison showing % returns for each ticker
periodtickersrequiredHistorical Data
Get historical price data for a stock. Returns: Historical price data summary with statistics and returns
periodtickerrequiredintervalHistorical Price on Date
Get historical price for a specific date. Returns: Price on that date (or closest trading day)
daterequiredtickerrequiredIncome Statement
Get income statement data. Returns: Income statement with revenue, expenses, and net income
periodtickerrequiredIndustry Overview
Get an industry overview: largest, best-performing and fastest-growing companies. Returns: Industry summary with top companies by size, YTD performance and growth
industryInsider Purchases
Get insider purchases only (filtered for buys). Returns: Recent insider purchase transactions
tickerrequiredInsider Roster Holders
Get insider roster (list of company insiders). Returns: List of company insiders and their positions
tickerrequiredInsider Transactions
Get recent insider trading activity. Returns: Recent insider buy/sell transactions
tickerrequiredInstitutional Holders
Get major institutional holders and their ownership. Returns: List of institutional holders with shares owned and percentage ownership
tickerrequiredIPO Calendar
Get upcoming IPOs (exchange, expected date, price range, shares). Returns: Table of upcoming IPOs
dayslimitISIN
Get International Securities Identification Number (ISIN) for a ticker. Returns: ISIN code and related identification information
tickerrequiredKey Ratios
Get key financial ratios and valuation metrics. Returns: Comprehensive ratios including P/E, P/B, ROE, ROA, profit margins, debt ratios
tickerrequiredMajor Holders
Get major holders summary (institutions, insiders, public float). Returns: Summary of insider vs institutional ownership percentages
tickerrequiredMarket Indices
Get current prices for major market indices. Returns: Current values and changes for S&P 500, Nasdaq, Dow Jones, and other major indices
Takes no parameters.
Market Movers
Get today's market movers from Yahoo Finance screeners. Returns: Table of tickers with price, change %, volume and market cap
countcategoryMarket Status
Check if US stock markets are currently open. Returns: Market status (open/closed), current time, and market hours
Takes no parameters.
Market Summary
Get a market overview for a region: open/closed status plus main indices, futures, bonds and FX. Returns: Market status and a table of the region's headline instruments
regionMutual Fund Holders
Get mutual fund holders. Returns: List of mutual funds holding the stock
tickerrequiredOptions Chain
Get options chain data (calls and puts). Returns: Options chain with top calls and puts by volume
tickerrequiredexpirationOptions Expirations
Get all available options expiration dates. Returns: List of all available options expiration dates
tickerrequiredPeer Comparison
Compare a stock with its peers on key metrics. Returns: Comparison table of key metrics across stocks
peerstickerrequiredSEC Filings
Get recent SEC filings (10-K, 10-Q, 8-K, etc.). Returns: Recent SEC filings with types and dates
tickerrequiredSector Overview
Get a sector overview: size, weight, largest companies, industries and sector ETFs. Returns: Sector summary with top companies and its industries
sectorSector Performance
Get performance of major market sectors. Returns: Performance data for major S&P 500 sectors
Takes no parameters.
Shares History
Get shares outstanding over time (dilution or buybacks). Returns: Shares outstanding at several points and the total change
yearstickerrequiredSplits Calendar
Get upcoming stock splits. Returns: Table of upcoming splits with ratios
dayslimitStock News
Get recent news articles about a stock. Returns: Recent news headlines, sources, and links
limittickerrequiredStock Price
Get current stock price and key metrics for a ticker symbol. Returns: Formatted string with current price, market cap, P/E ratio, and other key metrics
tickerrequiredStock Quote
Get detailed quote with bid/ask, day range, and trading info. Returns: Detailed quote information including bid/ask spreads and intraday trading data
tickerrequiredStock Splits
Get stock split history. Returns: Complete stock split history with dates and ratios
tickerrequiredTrending Tickers
Get today's most active (trending) US tickers. Returns: List of trending tickers with basic info
countTTM Financials
Get trailing-twelve-month (TTM) income statement and cash flow. Returns: Key TTM lines: revenue, gross profit, operating income, net income, EBITDA, EPS, cash flows
tickerrequiredUpcoming Earnings
Get the market-wide earnings calendar (which companies report in the next N days). Returns: Companies with report date, timing and EPS estimate
dayslimitUpgrades and Downgrades
Get detailed analyst upgrades and downgrades history. Returns: Recent analyst rating changes including firm, action, and grade changes
limittickerrequiredValuation History
Get valuation measures now and for the last quarters (market cap, EV, P/E, PEG, P/S, P/B, EV/EBITDA). Returns: Table of valuation measures by quarter
tickerrequiredSelf-Test
Run comprehensive self-test of the yfinance-ai tools (64 checks). This function is designed to be called by AI assistants to verify that all tools are working correctly. It tests each tool category, reports success/failure status, and shows sample data from each test. Returns: Comprehensive test report with pass/fail status and sample data for all tools
tickerSearch Ticker
Search for ticker symbols by company name or keyword. Returns: List of matching tickers
queryrequiredValidate Ticker
Validate if a ticker symbol exists and is tradeable. Returns: Validation result with ticker details if valid
tickerrequired90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
foundation.financeOfficial publisher
A remote MCP server for open financial reference data: look up companies, markets, funds and assets, resolve identifiers, traverse a knowledge graph and read a
fyi.fynOfficial publisher
Read-only personal finance for AI agents: budgets, receipts, net worth, bills. OAuth 2.1.

Published by GitHub account hs85-newbie
Fact-checks numbers in Korean finance writing against DART, Bank of Korea ECOS and US Treasury

Published by GitHub account nafadza14
Apizie Finance is a remote MCP server giving assistants cited access to official financial and economic data from SEC EDGAR, FRED, ECB, Treasury, GLEIF and…

Published by GitHub account aowang-ai
Hosted MCP server that lets an assistant discover, inspect and run finance data tools covering US stocks, SEC filings, macro series, crypto and prediction…
claude mcp add yfinance-ai -- uvx yfinance-ai@latestcode --add-mcp '{"name":"yfinance-ai","type":"stdio","command":"uvx","args":["yfinance-ai@latest"]}'{ "mcpServers": { "yfinance-ai": { "command": "uvx", "args": [ "yfinance-ai@latest" ] } }}import asynciofrom langchain.agents import create_agentfrom langchain.mcp import MCPAdapter
async def main(): config = {"mcpServers": {"yfinance-ai": { "command": "uvx", "args": ["yfinance-ai@latest"], }}} async with MCPAdapter(config) as adapter: tools = await adapter.list_tools() agent = create_agent("claude-sonnet-5", tools) result = await agent.ainvoke({"messages": [{"role": "user", "content": "What is Apple's P/E, and how does it compare with Microsoft and Google?"}]}) print(result["messages"][-1].content)
asyncio.run(main())from google.adk.agents import LlmAgentfrom google.adk.tools.mcp_tool import McpToolsetfrom google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParamsfrom mcp import StdioServerParameters
root_agent = LlmAgent( model="gemini-flash-latest", name="yfinance_ai", instruction="Answer with the yfinance-ai tools.", tools=[McpToolset(connection_params=StdioConnectionParams( server_params=StdioServerParameters(command="uvx", args=["yfinance-ai@latest"]), timeout=60, ))],)from mcp import stdio_client, StdioServerParametersfrom strands import Agentfrom strands.tools.mcp import MCPClient
yfinance_ai = MCPClient(lambda: stdio_client(StdioServerParameters( command="uvx", args=["yfinance-ai@latest"],)))agent = Agent(tools=[yfinance_ai])agent("What is Apple's P/E, and how does it compare with Microsoft and Google?")