MCP Server live — AI agents can now query 105M+ SEC facts. Connect your agent →
ValueinValuein
MCP Tools/get_capital_allocation_profile
Financials
PIT-safe

Get Capital Allocation Profile

get_capital_allocation_profile
sp500
full

Capital allocation breakdown per fiscal period: operating cash flow, capex, free cash flow, dividends paid, share repurchases, debt issuance, and debt repayment. Includes derived payout ratio and FCF-to-revenue.

Example Call

# Using the Valuein MCP server from Python (via MCP SDK)
# Or call directly from Claude / Cursor after setup

result = await client.call_tool(
    "get_capital_allocation_profile",
    arguments={
    "ticker": "EXAMPLE"
}
)
print(result)

Direct tool call:get_capital_allocation_profile(ticker="AAPL", limit=5)

Inputs

ParameterTypeRequiredDescription
tickerstring
required
Ticker symbol
limitintegeroptionalNumber of periods. Defaults to 8.
as_of_datestringoptionalYYYY-MM-DD PIT filter.

Output Fields

fiscal_yearfiscal_periodperiod_endoperating_cash_flowcapexfree_cash_flowdividends_paidshare_repurchasesdebt_issuancedebt_repaymentnet_debt_changedividend_payout_ratiofcf_to_revenue

Example Response

[
  {
    "fiscal_year": 2024,
    "fiscal_period": "FY",
    "period_end": "2024-03-15",
    "operating_cash_flow": 394328000000,
    "capex": 394328000000,
    "free_cash_flow": 394328000000,
    "dividends_paid": null,
    "share_repurchases": null
  }
]

Returns 5 periods of Apple capital allocation showing $90B+ annual buybacks and $15B dividends.

Notes

Cash flow figures use COALESCE(derived_quarterly_value, numeric_value) to handle YTD-to-quarterly conversions in 10-Q filings automatically.