What inputs does get_capital_allocation_profile accept?

ticker (string, required): Ticker symbol limit (integer, optional): Number of periods. Defaults to 8. as_of_date (string, optional): YYYY-MM-DD PIT filter.

Which Valuein plans include get_capital_allocation_profile?

Available on: sample, sp500, full. Point-in-time safe via as_of_date filtering.

Financials

PIT-safe

Capital Allocation Profile

get_capital_allocation_profile

Free

Pro · Institutional

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

example_call.pypython

# 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)

Try it now

No token required

Paste this in your terminal — the free tier returns real S&P500 data without authentication.

try-it.shbash

# No auth required — sample tier covers S&P500 with a 5-year window.# Add an Authorization: Bearer header for full universe and history.$ curl -X POST https://mcp.valuein.biz/mcp \    -H "Content-Type: application/json" \    -d '{        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {          "name": "get_capital_allocation_profile",          "arguments": {            "ticker": "AAPL",            "limit": 3          }        }      }'

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_revenue

Example Response

Illustrative

response.jsonjson

[  {    "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  }]

Shape only — field names match the live schema; values are placeholders, not real filings. Returns 5 periods of Apple capital allocation showing $90B+ annual buybacks and $15B dividends.