Home / Tools / analyze_capital_allocation
Company data · MCP tool

analyze_capital_allocation

Combines SEC-reported operating cash flow, capital expenditures, dividends, repurchases, and shares outstanding. It calculates free cash flow and selected cash-return measures when the required source inputs are complete.

Investors reviewing how reported cash flows and shareholder returns changed over time.

What it does

Summarize SEC-reported operating cash flow, capital expenditures, dividends, common-share repurchases, and shares outstanding by annual or TTM period. Calculates free cash flow, cash returns as a share of positive free cash flow when source inputs are complete, and date-aligned share-count changes. Missing values remain unavailable; outputs describe reported flows and do not judge management decisions or provide financial advice.

Annual or TTM reported flows, calculated free cash flow, cash returns relative to positive free cash flow when supported, and date-aligned share-count changes.

Who it helps

Investors reviewing how reported cash flows and shareholder returns changed over time.

Inputs

Input names and constraints below come from the registered MCP tool schema.

InputWhat it controls
ticker requiredUS ticker symbol
period requiredAnnual reported periods or latest trailing twelve months Default: annual.
limit requiredNumber of periods; TTM returns the latest period Default: 5.

Example request

Summarize Microsoft's latest TTM free cash flow, dividends, repurchases, and share-count change.

{
  "ticker": "MSFT",
  "period": "ttm",
  "limit": 1
}

What to expect

Annual or TTM reported flows, calculated free cash flow, cash returns relative to positive free cash flow when supported, and date-aligned share-count changes.

Important limits

Missing inputs remain unavailable. The figures describe reported flows and do not assess whether management's capital-allocation decisions were good or sustainable.

Data sources and verification

EdgarStack uses SEC EDGAR filings and, for applicable tools, SEC XBRL company-facts data. Coverage depends on the issuer, filing, taxonomy tags, and tool inputs. Follow the source filing references and verify material facts against the official filing.

Related tools

Related guide

How does SEC XBRL company-facts data work?