Yahoo Finance MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Yahoo Finance: 16 typed functions through one MCP server. No Yahoo Finance API key needed.
- Functions
- 16
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Yahoo Finance alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/yahoo_financeOne MCP server for Yahoo Finance and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getAnalystEstimatesReads Wall Street's own consensus numbers for a ticker.Arguments
Name Type Required symbolstringYes Returns
YahooFinanceAnalystEstimatesinterface YahooFinanceEstimateColumn { key: string; // Yahoo's own code: "0q" | "+1q" | "0y" | "+1y" label: string; // "Current Qtr. (Sep 2026)" } interface YahooFinanceEstimateRow { label: string; // "No. of Analysts", "Avg. Estimate", "Low Estimate", "High Estimate", … values: Record<string, string | null>; // keyed by column key, kept as the site renders ("113.62B", "27", "8.82") } interface YahooFinanceEstimateTable { columns: YahooFinanceEstimateColumn[]; rows: YahooFinanceEstimateRow[]; } interface YahooFinanceAnalystEstimates { symbol: string; revenueEstimate: YahooFinanceEstimateTable | null; earningsEstimate: YahooFinanceEstimateTable | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getAnalystEstimatesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getAnalystEstimates("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getAnalystEstimates("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getAnalystEstimates \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getAnalystEstimates("AAPL");getCompanyProfileReads a ticker's company profile the way the site's own Profile tab does.Arguments
Name Type Required symbolstringYes Returns
YahooFinanceCompanyProfileinterface YahooFinanceExecutive { name: string; title: string; } interface YahooFinanceCompanyProfile { symbol: string; sector: string | null; industry: string | null; website: string | null; description: string | null; employeeCount: number | null; headquarters: string | null; executives: YahooFinanceExecutive[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getCompanyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getCompanyProfile("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getCompanyProfile("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getCompanyProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getCompanyProfile("AAPL");getEarningsDatesReads a ticker's next scheduled earnings date and the analyst consensus EPS/revenue estimates around it, plus the next earnings call date and the…Arguments
Name Type Required symbolstringYes Returns
YahooFinanceEarningsDatesinterface YahooFinanceEarningsDates { symbol: string; nextEarningsDate: string | null; isEarningsDateEstimate: boolean; nextEarningsCallDate: string | null; epsEstimateAverage: string | null; // "1.98", kept as the site renders epsEstimateLow: string | null; epsEstimateHigh: string | null; revenueEstimateAverage: string | null; // "113.62B", kept as the site renders revenueEstimateLow: string | null; revenueEstimateHigh: string | null; exDividendDate: string | null; dividendDate: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getEarningsDatesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getEarningsDates("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getEarningsDates("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getEarningsDates \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getEarningsDates("AAPL");getFinancialsReads a ticker's income statement, balance sheet and cash-flow statement the way the site's own Financials tab presents them, annual or quarterly.Arguments
Name Type Required symbolstringYes Returns
YahooFinanceFinancialsinterface YahooFinanceFinancialRow { label: string; values: Record<string, string | null>; } interface YahooFinanceFinancialStatement { rows: YahooFinanceFinancialRow[]; } interface YahooFinanceFinancials { symbol: string; incomeStatement: YahooFinanceFinancialStatement | null; balanceSheet: YahooFinanceFinancialStatement | null; cashFlow: YahooFinanceFinancialStatement | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getFinancialsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getFinancials("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getFinancials("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getFinancials \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getFinancials("AAPL");getHistoricalPricesReads a ticker's daily open/high/low/close/volume history over a requested range, the way the site's own History tab does.Arguments
Name Type Required symbolstringYes Returns
YahooFinanceHistoricalPricesinterface YahooFinancePriceBar { date: string; // ISO date "YYYY-MM-DD" open: number | null; high: number | null; low: number | null; close: number | null; volume: number | null; adjClose: number | null; } interface YahooFinanceHistoricalPrices { symbol: string; prices: YahooFinancePriceBar[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getHistoricalPricesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getHistoricalPrices("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getHistoricalPrices("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getHistoricalPrices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getHistoricalPrices("AAPL");getHoldersReads who owns a ticker, the top institutional and mutual-fund holders and the insider-ownership summary, with percentage held and shares held, the…Arguments
Name Type Required symbolstringYes Returns
YahooFinanceHoldersinterface YahooFinanceHoldersBreakdownRow { label: string; // Yahoo's own wording, "% of Shares Held by All Insider" value: string | null; // kept as the site renders, "1.65%" or "7,760" } interface YahooFinanceHolderRow { holder: string; shares: string | null; // "1.16B", kept as the site renders dateReported: string | null; // "Jun 30, 2026" percentOut: string | null; // "7.97%" value: string | null; // "394,232,715,159", dollar value, kept as a string } interface YahooFinanceHolders { symbol: string; breakdown: YahooFinanceHoldersBreakdownRow[]; topInstitutionalHolders: YahooFinanceHolderRow[]; topMutualFundHolders: YahooFinanceHolderRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getHoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getHolders("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getHolders("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getHolders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getHolders("AAPL");getKeyStatisticsReads the fuller valuation and share-statistics sheet the site's own Statistics tab shows for a ticker.Arguments
Name Type Required symbolstringYes Returns
YahooFinanceKeyStatisticsinterface YahooFinanceKeyStat { label: string; // "Market Cap", "P/E Ratio", "52 Week Range", etc. value: string | null; // "2.95T", "31.45", "150.00 - 199.62", etc., kept as the site renders } interface YahooFinanceKeyStatistics { symbol: string; stats: YahooFinanceKeyStat[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getKeyStatisticsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getKeyStatistics("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getKeyStatistics("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getKeyStatistics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getKeyStatistics("AAPL");getMarketSummaryReads the market-wide overview the site's own Markets home shows.Arguments
None.
Returns
YahooFinanceMarketSummaryinterface YahooFinanceMarketIndex { symbol: string; // Yahoo's own symbol, "^GSPC", "^DJI", "^IXIC", "^RUT" name: string; // Yahoo's own display name, "S&P 500", "Dow 30" price: number | null; change: number | null; changePercent: number | null; } interface YahooFinanceMover { symbol: string; name: string | null; price: number | null; change: number | null; changePercent: number | null; marketCap: string | null; // "4.823B", kept as the site renders volume: number | null; } interface YahooFinanceMarketSummary { marketState: string | null; // Yahoo's own sentence, e.g. "U.S. markets closed" indices: YahooFinanceMarketIndex[]; topGainers: YahooFinanceMover[]; topLosers: YahooFinanceMover[]; mostActive: YahooFinanceMover[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getMarketSummaryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getMarketSummary();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getMarketSummary())curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getMarketSummary \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getMarketSummary();getNewsReads the news stories Yahoo Finance itself has attached to a ticker's News tab.Arguments
Name Type Required symbolstringYes Returns
YahooFinanceNewsinterface YahooFinanceNewsStory { headline: string; url: string; source: string | null; // "Motley Fool", kept as the site renders published: string | null; // "55m ago", relative only, no absolute timestamp on the card tickers: string[]; // every ticker the story is tagged with, not just the one asked about } interface YahooFinanceNews { symbol: string; stories: YahooFinanceNewsStory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getNews("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getNews("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getNews("AAPL");getOptionsChainReads a ticker's options chain.Arguments
Name Type Required symbolstringYes expirationDatestringNo Returns
YahooFinanceOptionsChaininterface YahooFinanceOptionContract { contractSymbol: string; strike: number; lastPrice: number | null; change: number | null; percentChange: number | null; volume: number | null; openInterest: number | null; bid: number | null; ask: number | null; expiration: string | null; // ISO date "YYYY-MM-DD" lastTradeDate: string | null; // full ISO datetime, the time of day is real impliedVolatility: number | null; inTheMoney: boolean; } interface YahooFinanceOptionsChain { symbol: string; expirationDate: string | null; // ISO date "YYYY-MM-DD" this response answers for expirationDates: string[]; // every expiration Yahoo Finance lists, ISO dates, ascending strikes: number[]; // every strike across ALL expirations, not just this one calls: YahooFinanceOptionContract[]; puts: YahooFinanceOptionContract[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getOptionsChainCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getOptionsChain("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getOptionsChain("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getOptionsChain \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getOptionsChain("AAPL");getQuoteReads the live quote header for one ticker ("AAPL") the way the site's own quote page does.Arguments
Name Type Required symbolstringYes Returns
YahooFinanceQuoteinterface YahooFinanceQuote { symbol: string; price: number | null; change: number | null; changePercent: number | null; marketCap: string | null; trailingPE: number | null; fiftyTwoWeekRange: string | null; volume: number | null; averageVolume: number | null; targetMeanPrice: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getQuote("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getQuote("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getQuote("AAPL");getTrendingTickersReads what Yahoo Finance itself is showing as trending right now.Arguments
None.
Returns
YahooFinanceTrendingTicker[]interface YahooFinanceTrendingTicker { symbol: string; price: number | null; changePercent: number | null; trendingScore: number; quoteType: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/getTrendingTickersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.getTrendingTickers();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.getTrendingTickers())curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/getTrendingTickers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.getTrendingTickers();listCryptoPricesReads the live crypto leaderboard the way the site's own Crypto markets page does.Arguments
None.
Returns
YahooFinanceCryptoPricesinterface YahooFinanceCryptoPrice { symbol: string; // e.g., "BTC-USD", "ETH-USD" name: string | null; // display name price: number | null; // current price change: number | null; // 24h change changePercent: number | null; // 24h change percent } interface YahooFinanceCryptoPrices { prices: YahooFinanceCryptoPrice[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/listCryptoPricesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.listCryptoPrices();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.listCryptoPrices())curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/listCryptoPrices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.listCryptoPrices();listWatchlistsReads the signed-in viewer's saved watchlists with their tickers and current quotes.Arguments
None.
Returns
YahooFinanceWatchlistsinterface YahooFinanceWatchlistItem { symbol: string; price: number | null; change: number | null; changePercent: number | null; } interface YahooFinanceWatchlist { name: string; items: YahooFinanceWatchlistItem[]; } interface YahooFinanceWatchlists { watchlists: YahooFinanceWatchlist[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/listWatchlistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.listWatchlists();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.listWatchlists())curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/listWatchlists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.listWatchlists();searchSymbolsResolves what a person would type.Arguments
Name Type Required querystringYes Returns
yahooFinanceSearchResultinterface yahooFinanceSearchMatch { symbol: string; // "AAPL" name: string; // "Apple Inc." exchange: string | null; // Yahoo's short code, "NMS" exchangeName: string | null; // Yahoo's own name, "NASDAQ" quoteType: string; // "EQUITY" | "ETF" | "FUTURE" | "INDEX" | "CURRENCY" | "CRYPTOCURRENCY" | ... score: number; // Yahoo's own relevance ranking, descending } interface yahooFinanceSearchResult { query: string; matches: yahooFinanceSearchMatch[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/searchSymbolsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.searchSymbols("apple");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.searchSymbols("apple"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/searchSymbols \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"apple"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.searchSymbols("apple");
addToWatchlistAdds a ticker to one of the signed-in viewer's watchlists.Arguments
Name Type Required watchlistNamestringYes symbolstringYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_finance/addToWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_finance.addToWatchlist("<watchlistName>", "<symbol>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_finance.addToWatchlist("<watchlistName>", "<symbol>"))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_finance/addToWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"watchlistName":"<watchlistName>","symbol":"<symbol>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_finance.addToWatchlist("<watchlistName>", "<symbol>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/yahoo_finance/<function> - OpenAPI
/v1/sites/yahoo_finance/openapi.json