{"name":"Investor Tool Public Finance API","authentication":"none","baseUrl":"https://finance.mannhowie.com","mcp":{"url":"https://finance.mannhowie.com/api/mcp","transport":"streamable-http","authentication":"none","readOnly":true,"tools":[{"name":"list_companies","title":"List stored companies","description":"Find stored tickers by ticker or company name. Returns a bounded page with nextOffset. Reads stored data only; never imports or refreshes a company."},{"name":"list_watchlists","title":"List saved watchlists","description":"List visible saved watchlists and their ticker memberships. Use to identify a cohort before querying financial metrics. Reads saved data only; never refreshes memberships."},{"name":"query_financials","title":"Query selected financial metrics","description":"Read selected annual or quarterly financial facts for stored tickers, with period limits, dates, currency and units. Reads only requested financial columns and required FX; never loads price history or triggers imports/refreshes. Cash flows retain reported signs. Null and missing reasons mean unavailable, never zero."},{"name":"query_ratios","title":"Query website financial ratios","description":"Read the same current ratio-table values or annual ratio history as the website using its shared calculator, labels and formatting. Stored data only; no refreshes or writes. Includes formulas, denominator guards, period selection and estimate flags by default. Current values may use TTM or an annual fallback; CAGR and reinvestment rate use annual data. Missing cash/debt/annual SBC can use the website zero-input assumptions with missingInputs flags. Formula catalog: pe: marketCap / netIncome; evEbit: (marketCap + longTermDebt + currentDebt - cash) / operatingIncome; evRevenue: (marketCap + longTermDebt + currentDebt - cash) / revenue; fcfYield: (operatingCashFlow - abs(capitalExpenditure) - sbc) / marketCap; dividendYield: abs(dividendsPaid) / marketCap; revenue3yCagr: (annualRevenue / annualRevenueThreeFiscalYearsEarlier)^(1/3) - 1; ebit3yCagr: (annualOperatingIncome / annualOperatingIncomeThreeFiscalYearsEarlier)^(1/3) - 1; grossMargin: grossProfit / revenue; operatingMargin: operatingIncome / revenue; fcfConversion: (operatingCashFlow - abs(capitalExpenditure) - sbc) / operatingIncome; roic: (operatingIncome - taxProvision) / investedCapital; reinvestmentRate: (annualInvestedCapital - previousStoredAnnualInvestedCapital) / (annualOperatingIncome - annualTaxProvision); netDebtEbit: (longTermDebt + currentDebt - cash) / operatingIncome"},{"name":"get_shareholder_returns","title":"Calculate stored shareholder returns","description":"Read cash dividends and gross share repurchases for consecutive fiscal years and calculate per-company totals and contribution percentages in USD millions. Default ends at latest reported completed year; throughYears can include completed but unreported years. Missing values/years remain explicit. Exact combined totals and percentages are null unless all requested companies are complete; observed subtotals are partial, not estimates. Reads stored data only."}],"limits":{"tickers":20,"cells":2000,"concurrency":4,"resultBytes":128000,"requestBytes":32768}},"examples":{"statementSelection":[{"label":"AAPL: five annual dividend and repurchase records","href":"/api/financials/AAPL/statements?metrics=dividendsPaid,stockRepurchase&interval=annual&limit=5&currency=usd"},{"label":"MSFT: twenty quarters of revenue and net income","href":"/api/financials/MSFT/statements?metrics=revenue,netIncome&interval=quarterly&limit=20&currency=usd"}],"shareholderReturns":[{"ticker":"AAPL","label":"AAPL: FY2022–2026","href":"/api/financials/AAPL/statements?view=shareholder-returns&years=5&throughYear=2026"},{"ticker":"MSFT","label":"MSFT: FY2022–2026","href":"/api/financials/MSFT/statements?view=shareholder-returns&years=5&throughYear=2026"},{"ticker":"GOOG","label":"GOOG: FY2021–2025","href":"/api/financials/GOOG/statements?view=shareholder-returns&years=5&throughYear=2025"},{"ticker":"NVDA","label":"NVDA: FY2022–2026","href":"/api/financials/NVDA/statements?view=shareholder-returns&years=5&throughYear=2026"},{"ticker":"AMZN","label":"AMZN: FY2021–2025","href":"/api/financials/AMZN/statements?view=shareholder-returns&years=5&throughYear=2025"},{"ticker":"TSM","label":"TSM: FY2021–2025","href":"/api/financials/TSM/statements?view=shareholder-returns&years=5&throughYear=2025"},{"ticker":"AVGO","label":"AVGO: FY2022–2026","href":"/api/financials/AVGO/statements?view=shareholder-returns&years=5&throughYear=2026"},{"ticker":"META","label":"META: FY2021–2025","href":"/api/financials/META/statements?view=shareholder-returns&years=5&throughYear=2025"},{"ticker":"TSLA","label":"TSLA: FY2021–2025","href":"/api/financials/TSLA/statements?view=shareholder-returns&years=5&throughYear=2025"},{"ticker":"SPCX","label":"SPCX: FY2021–2025","href":"/api/financials/SPCX/statements?view=shareholder-returns&years=5&throughYear=2025"}],"datedShareholderReturnsSnapshot":"/data/shareholder-returns-2026-11-22.json"},"openapi":"/api/openapi.json","documentation":"/api/docs","agentGuide":"/llms.txt","endpoints":[{"method":"GET","path":"/api/companies","operationId":"listStoredCompanies","summary":"Enumerate stored companies","example":"/api/companies?limit=100"},{"method":"GET","path":"/api/watchlists","operationId":"listWatchlists","summary":"List visible saved watchlists and all members","example":"/api/watchlists"},{"method":"GET","path":"/api/financials/{ticker}","operationId":"getFinancials","summary":"Query company financials, valuations and price history","example":"/api/financials/AAPL?storedOnly=1&view=history"},{"method":"GET","path":"/api/financials/{ticker}/statements","operationId":"getStoredStatements","summary":"Read annual and quarterly statements, prices and FX in original units","example":"/api/financials/AAPL/statements?view=shareholder-returns&years=5"},{"method":"GET","path":"/api/search","operationId":"searchTickers","summary":"Search Yahoo Finance for equity and ETF symbols","example":"/api/search?q=apple"},{"method":"GET","path":"/api/watchlists/quotes","operationId":"getWatchlistQuotes","summary":"Get lightweight market-cap snapshots for up to 200 symbols","example":"/api/watchlists/quotes?tickers=AAPL,MSFT&storedOnly=1"},{"method":"GET","path":"/api/watchlists/start","operationId":"getWatchlistStart","summary":"Get watchlist snapshots and the largest company history","example":"/api/watchlists/start?tickers=AAPL,MSFT&storedOnly=1"},{"method":"GET","path":"/api/benchmark","operationId":"getSp500Benchmark","summary":"Read S&P 500 price index history","example":"/api/benchmark?frequency=monthly"}]}