Skip to main content
Glama

Worthune Verified Financial Models

try_household_projection

Read-onlyIdempotent

Run the deterministic multi-year household projection on a document you pass in — income, RMDs, Roth conversions, federal and covered-state tax, expenses, amortization, the tax-grossed-up deficit draw, and net worth per year — optionally with a seeded Monte Carlo. NOTHING IS STORED: no household is created, no id issued, no record kept. Takes any key, a free sandbox key included (worthune.com/sandbox). The response carries every simplification that fired in projection.assumptionsApplied and an evidence record whose hash reproduces on an identical document, so you can show your work. Use list_example_households for a starting shape. For a household that persists — with an id, bulk import, webhooks and drift detection — see create_household.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
policyNo
api_keyNoWorthune API key (wk_…); a free sandbox key works
horizonYes
householdYesA household document: { schemaVersion, filingStatus, state?, members[], accounts[], liabilities[], incomes[], expenses[] }. It has no name field and no account numbers by design. Any expense `label` is stripped before anything is computed.
monteCarloNoSimulations are clamped to 500 on this surface, and the clamp is reported back.
assumptionsYesRequired here: this surface has no org profile to fall back on.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / api_key
      Added value: +{
      +  "description": "Worthune API key (wk_…); a free sandbox key works",
      +  "type": "string"
      +}
    • changedInput schema / properties / monteCarlo / description
      Previous value: -"Simulations are clamped to 500 on this keyless surface, and the clamp is reported back."New value: +"Simulations are clamped to 500 on this surface, and the clamp is reported back."
  2. Changed6 schema fields changed
    • addedInput schema / properties / assumptions / additionalProperties
      Added value: +false
    • addedInput schema / properties / horizon / additionalProperties
      Added value: +false
    • changedInput schema / properties / horizon / properties / startYear / maximum
      Previous value: -9007199254740991New value: +2150
    • changedInput schema / properties / horizon / properties / startYear / minimum
      Previous value: --9007199254740991New value: +1900
    • addedInput schema / properties / monteCarlo / additionalProperties
      Added value: +false
    • addedInput schema / properties / policy / additionalProperties
      Added value: +false
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources