Financials
PIT-safe
Get Capital Allocation Profile
get_capital_allocation_profilesp500
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
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker | string | required | Ticker symbol |
limit | integer | optional | Number of periods. Defaults to 8. |
as_of_date | string | optional | YYYY-MM-DD PIT filter. |
Output Fields
fiscal_yearfiscal_periodperiod_endoperating_cash_flowcapexfree_cash_flowdividends_paidshare_repurchasesdebt_issuancedebt_repaymentnet_debt_changedividend_payout_ratiofcf_to_revenueExample 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.
Plan Access
sample
— Not includedsp500
✓ Availablefull
✓ Available