Multi-step credit plan
get_credit_planUse this when someone wants more than the next single action. Returns an ordered plan for one of three goals: raise_score, pay_down_balances, or build_credit. Safety steps come first (anything overdue, then imminent minimums), then goal steps, each with the specific action, the mechanism behind it, and a date. The plan is returned as text and structured data for the person to act on themselves; nothing is scheduled or executed. Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | Which goal to plan for. | |
| cards | Yes | The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything. | |
| today | No | Today's date in the person's local timezone, yyyy-mm-dd. Pass it — the server otherwise falls back to UTC, which is a day ahead for Canadian evenings. | |
| targetUtilization | No | Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | ||
| steps | Yes | ||
| disclosure | Yes | ||
| assumptions | Yes | ||
| generatedForDate | Yes |