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

Just Yahoo Finance

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_finance
Every site

One 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/mcp
Set it up in your client

Both 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.

Read 15
  • getAnalystEstimatesReads Wall Street's own consensus numbers for a ticker.

    Arguments

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceAnalystEstimates

    interface 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/getAnalystEstimates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.getAnalystEstimates("AAPL");
  • getCompanyProfileReads a ticker's company profile the way the site's own Profile tab does.

    Arguments

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceCompanyProfile

    interface 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/getCompanyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceEarningsDates

    interface 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/getEarningsDates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceFinancials

    interface 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/getFinancials

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceHistoricalPrices

    interface 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/getHistoricalPrices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceHolders

    interface 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/getHolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceKeyStatistics

    interface 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/getKeyStatistics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.getKeyStatistics("AAPL");
  • getMarketSummaryReads the market-wide overview the site's own Markets home shows.

    Arguments

    None.

    Returns YahooFinanceMarketSummary

    interface 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/getMarketSummary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.getMarketSummary();
  • getNewsReads the news stories Yahoo Finance itself has attached to a ticker's News tab.

    Arguments

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceNews

    interface 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/getNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.getNews("AAPL");
  • getOptionsChainReads a ticker's options chain.

    Arguments

    NameTypeRequired
    symbolstringYes
    expirationDatestringNo

    Returns YahooFinanceOptionsChain

    interface 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/getOptionsChain

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    symbolstringYes

    Returns YahooFinanceQuote

    interface 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/getQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getTrendingTickers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.getTrendingTickers();
  • listCryptoPricesReads the live crypto leaderboard the way the site's own Crypto markets page does.

    Arguments

    None.

    Returns YahooFinanceCryptoPrices

    interface 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/listCryptoPrices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.listCryptoPrices();
  • listWatchlistsReads the signed-in viewer's saved watchlists with their tickers and current quotes.

    Arguments

    None.

    Returns YahooFinanceWatchlists

    interface 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/listWatchlists

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.listWatchlists();
  • searchSymbolsResolves what a person would type.

    Arguments

    NameTypeRequired
    querystringYes

    Returns yahooFinanceSearchResult

    interface 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/searchSymbols

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.searchSymbols("apple");
Act 1
  • addToWatchlistAdds a ticker to one of the signed-in viewer's watchlists.

    Arguments

    NameTypeRequired
    watchlistNamestringYes
    symbolstringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_finance/addToWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_finance.addToWatchlist("<watchlistName>", "<symbol>");

Use it from code