budget-bench.surge.sh

{
  "name": "get_budget_summary",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the current household budget: total income, each category with budget/spent/remaining, totals, and which categories are over budget or tight.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "find_savings",
  "kind": "answer",
  "impl": "imperative",
  "description": "Analyses the budget and PROPOSES concrete rebalances: trims over-allocated discretionary categories and moves the difference to savings. Returns the proposals that were added to the human approval tray.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "target_amount": {
        "type": "number",
        "description": "Optional total monthly savings target in GBP. If omitted, proposes whatever the budget can sensibly free up."
      }
    }
  }
}

{
  "name": "set_category_budget",
  "kind": "act",
  "impl": "imperative",
  "description": "PROPOSES changing a category’s monthly budget amount. The change is applied only after the human approves it in the proposal tray.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "description": "Exact or partial category name, e.g. \"Groceries\"."
      },
      "new_budget": {
        "type": "number",
        "description": "New monthly budget amount in GBP."
      },
      "reason": {
        "type": "string",
        "description": "One-line human-readable justification shown in the tray."
      }
    },
    "required": [
      "category",
      "new_budget"
    ]
  }
}

{
  "name": "add_category",
  "kind": "act",
  "impl": "imperative",
  "description": "PROPOSES adding a new budget category with a starting budget. Applied after human approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string"
      },
      "budget": {
        "type": "number",
        "description": "Monthly budget in GBP."
      },
      "reason": {
        "type": "string"
      }
    },
    "required": [
      "name",
      "budget"
    ]
  }
}

{
  "name": "record_spend",
  "kind": "act",
  "impl": "imperative",
  "description": "PROPOSES recording an amount spent in a category. Applied after human approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string"
      },
      "amount": {
        "type": "number"
      },
      "note": {
        "type": "string",
        "description": "What the spend was for."
      }
    },
    "required": [
      "category",
      "amount"
    ]
  }
}

{
  "name": "propose_plan",
  "kind": "act",
  "impl": "imperative",
  "description": "Given a monthly savings target, PROPOSES a complete rebalanced budget: keeps fixed costs (rent/utilities) untouched, scales discretionary categories, and assigns the remainder to savings. All as one pending plan the human can approve.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "savings_target": {
        "type": "number",
        "description": "Desired monthly savings/buffer amount in GBP."
      }
    },
    "required": [
      "savings_target"
    ]
  }
}