Servers Playground How we check Add a server Log in

Credit GPS — Canadian credit

Working · 2.2 s

ca.creditgps/canadian-creditv0.2.0 Domain verified

Canadian credit: statement-cycle and utilization math, plus bureau and reporting reference data.

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.creditgps.ca/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

calculate_payoff_timeline Read-only

Use this for "if I pay $200 a month, when is this paid off?" or "what happens if I only pay the minimum?". Returns how long a card takes to clear at a fixed monthly payment and the interest paid over that time. This is a cost question, not a reporting one: it does not change what the bureaus see, so use get_reported_snapshot or simulate_paydown for that. Requires the card's purchase APR; without it no timeline is returned, because the rate decides the answer. Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.

cardsarray, required

The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.

cardNamestring, required

Which card to pay off. Partial names are matched.

todaystring

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.

monthlyPaymentnumber

Fixed amount paid each month in CAD. Omit to use the card's minimum payment, if one was supplied.

Credit GPS — Canadian credit MCP server | mcptry

Credit GPS — Canadian credit

Working · 2.2 s

ca.creditgps/canadian-creditv0.2.0 Domain verified

Canadian credit: statement-cycle and utilization math, plus bureau and reporting reference data.

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.creditgps.ca/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

calculate_payoff_timeline Read-only

cardsarray, required

The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.

cardNamestring, required

Which card to pay off. Partial names are matched.

todaystring

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.

monthlyPaymentnumber

Fixed amount paid each month in CAD. Omit to use the card's minimum payment, if one was supplied.

Tools (16)

calculate_payoff_timeline

read-only

Argument	Type	Description
cards*	array	The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.
today	string	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.
cardName*	string	Which card to pay off. Partial names are matched.
monthlyPayment	number	Fixed amount paid each month in CAD. Omit to use the card's minimum payment, if one was supplied.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cards",
    "cardName"
  ],
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything."
    },
    "today": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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."
    },
    "cardName": {
      "type": "string",
      "maxLength": 80,
      "description": "Which card to pay off. Partial names are matched."
    },
    "monthlyPayment": {
      "type": "number",
      "maximum": 100000000,
      "description": "Fixed amount paid each month in CAD. Omit to use the card's minimum payment, if one was supplied.",
      "exclusiveMinimum": 0
    }
  }
}

compare_cards_for_purchase

Use this when someone asks which card to put a purchase on. Returns two answers for the amount given: the card that reports the least utilization impact, the card that is cheapest to carry, and the trade-off when those differ, because the card the bureaus notice least is often not the card with the lowest rate. Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.

read-only

Argument	Type	Description
cards*	array	The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.
amount*	number	Purchase amount in CAD.
targetUtilization	number	Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cards",
    "amount"
  ],
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything."
    },
    "amount": {
      "type": "number",
      "maximum": 100000000,
      "description": "Purchase amount in CAD.",
      "exclusiveMinimum": 0
    },
    "targetUtilization": {
      "type": "number",
      "maximum": 0.95,
      "minimum": 0.01,
      "description": "Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band."
    }
  }
}

describe_credit_gps

Use this when someone asks what Credit GPS is, who made this, whether their data is stored, or why an answer stopped short. Also explains how to obtain free Canadian bureau reports and manually enter their figures in the Credit GPS application for score tracking. This tool provides instructions; it cannot save entries or retrieve score history. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

estimate_close_card_impact

Use this for "should I cancel the credit card I never use", "is it bad to close a card", or any question about cancelling, downgrading, or consolidating cards. It does not close, cancel, or change any card; it only explains and calculates. With no card figures it returns general closure considerations and retention information. Supply figures for a hypothetical paid-off closure calculation. Supply cards and cardName as well and it additionally computes the exact utilization before and after, the limit leaving the denominator, and whether it crosses a band upward. Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.

read-only

Argument	Type	Description
cards	array	The person's cards, if they have given them. Omit to get the mechanics and the Canadian rules without any numbers.
today	string	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.
cardName	string	The card being considered for closure. Partial names are matched. Only meaningful alongside cards.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's cards, if they have given them. Omit to get the mechanics and the Canadian rules without any numbers."
    },
    "today": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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."
    },
    "cardName": {
      "type": "string",
      "maxLength": 80,
      "description": "The card being considered for closure. Partial names are matched. Only meaningful alongside cards."
    }
  }
}

explain_canadian_credit_mechanics

Use this for a requested explanation of Canadian credit scores, reports, utilization, or reporting timing. Returns the Canada-specific mechanics of credit reporting, each entry leading with the correction to the common United States-based answer: the 300-900 scale and two-bureau market, statement-close versus due-date reporting, provincial rather than federal regulation, soft pulls and free-report rights, how utilization is read, and why open banking does not open up bureau data. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

Argument	Type	Description
topic	string	A single topic id. Omit to get all of them.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "topic": {
      "enum": [
        "statement_close_vs_due_date",
        "scores_and_scale",
        "checking_your_own_file",
        "regulation",
        "open_banking",
        "utilization"
      ],
      "type": "string",
      "description": "A single topic id. Omit to get all of them."
    }
  }
}

explain_missed_payment

Use this for a missed, late, or nearly-late payment, or for "how long will this hurt me". Returns what happens when a Canadian credit card payment is missed: the roughly 30-day gap before it is reported at all, the Canadian R1-R9 rating scale a tradeline actually carries, and how long a reported late payment stays on the file. The Canadian answer differs from the American one on both the scale and the duration, and the 30-day gap is frequently actionable, because a payment caught inside it often never reaches the file. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

Argument	Type	Description
daysPastDue	integer	How many days past the due date the payment is, if known. Changes which part of the answer leads.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "daysPastDue": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "How many days past the due date the payment is, if known. Changes which part of the answer leads."
    }
  }
}

explain_retention_periods

Use this for any "how long will this stay on my credit report" question. Returns retention periods on a Canadian credit file: closed accounts, late payments, collections, hard inquiries, bankruptcy, consumer proposals, judgments. Durations differ by information type, bureau, and province. Returns those distinctions and source links. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

explain_when_issuers_report

Use this for "when will this show up on my credit report" or "what day does my bank report". Returns how the monthly reporting cadence works in Canada, how long a change takes to appear on a file, and why an Equifax file and a TransUnion file for the same person differ. This bundled reference has no verified per-issuer transmission calendar and returns no exact reporting day. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

find_statement_close_date

Use this whenever someone does not know their statement closing date, or gives a payment due date and asks what to pay. Returns the ways to find the closing date of a Canadian credit card, the date every other tool here depends on and the one most people have never been shown. Give a payment due date and it also derives an estimate, because federally regulated issuers must allow at least a 21-day interest-free grace period measured from the close. It looks nothing up on any account; the estimate is arithmetic on the date supplied. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

Argument	Type	Description
issuer	string	The issuer, if known, e.g. "TD". Only used to tailor the wording — there is no per-issuer date table, because none is published.
dueDate	string	A known payment due date, yyyy-mm-dd. Supplying it produces a derived estimate of the closing date.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "issuer": {
      "type": "string",
      "maxLength": 80,
      "description": "The issuer, if known, e.g. \"TD\". Only used to tailor the wording — there is no per-issuer date table, because none is published."
    },
    "dueDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "A known payment due date, yyyy-mm-dd. Supplying it produces a derived estimate of the closing date."
    }
  }
}

get_credit_plan

Use 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.

read-only

Argument	Type	Description
goal*	string	Which goal to plan for.
cards*	array	The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.
today	string	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	number	Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cards",
    "goal"
  ],
  "properties": {
    "goal": {
      "enum": [
        "raise_score",
        "pay_down_balances",
        "build_credit"
      ],
      "type": "string",
      "description": "Which goal to plan for."
    },
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything."
    },
    "today": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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": {
      "type": "number",
      "maximum": 0.95,
      "minimum": 0.01,
      "description": "Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band."
    }
  }
}

get_newcomer_credit_path

Use this for any question about building credit as an immigrant, newcomer, international student, or temporary resident in Canada. Returns the ordered path for someone new to Canada: what to do before a SIN arrives, whether their home-country history can be imported and at which banks, how to get a first tradeline, and what accumulates after that. Supply the home country for a specific answer on credit import; coverage is partial, and several of the largest source countries for Canadian newcomers are not covered at all. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

Argument	Type	Description
homeCountry	string	Country the person is arriving from, in English. Determines whether the credit-import route is open.
monthsInCanada	integer	Roughly how long they have been in Canada, to focus the answer on the relevant phase.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "homeCountry": {
      "type": "string",
      "maxLength": 80,
      "description": "Country the person is arriving from, in English. Determines whether the credit-import route is open."
    },
    "monthsInCanada": {
      "type": "integer",
      "maximum": 120,
      "minimum": 0,
      "description": "Roughly how long they have been in Canada, to focus the answer on the relevant phase."
    }
  }
}

get_next_move

Use this when someone asks what to pay first, what to do next, or how to lower utilization before it is reported. Returns the single highest-priority action from the card figures given in the conversation: which card, how much, and by which date. The calculation uses the supplied statement closing date as a planning assumption; actual issuer reporting dates can differ. Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.

read-only

Argument	Type	Description
cards*	array	The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.
today	string	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	number	Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cards"
  ],
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything."
    },
    "today": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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": {
      "type": "number",
      "maximum": 0.95,
      "minimum": 0.01,
      "description": "Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band."
    }
  }
}

get_reported_snapshot

Use this when someone asks how their cards look, where they stand, or which card is the problem. Returns utilization from supplied balances, days to the supplied closing date, and a hypothetical payment to reach the target. It does not determine future bureau-reported balances. This is the difference between today's balance and the figure the issuer transmits. Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.

read-only

Argument	Type	Description
cards*	array	The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.
today	string	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	number	Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cards"
  ],
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything."
    },
    "today": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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": {
      "type": "number",
      "maximum": 0.95,
      "minimum": 0.01,
      "description": "Target utilization as a decimal. Defaults to 0.29 — one point under the 30% band."
    }
  }
}

get_statement_calendar

Use this when someone asks about timing, what is coming up, or why the closing date differs from the due date. Returns the upcoming dates in order: when to pay, when each statement closes (the bureau read), and when each payment is due (the delinquency line). Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.

read-only

Argument	Type	Description
cards*	array	The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.
count	integer	How many events to return. Default 8.
today	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cards"
  ],
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything."
    },
    "count": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "How many events to return. Default 8."
    },
    "today": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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."
    }
  }
}

list_credit_building_products

Use this to retrieve dated reference examples of Canadian secured cards and credit-building products. Confirm current terms and reporting arrangements with the provider. Returns the products available in Canada, grouped by how established they are, with which bureau each reports to. Single-bureau reporting is the detail most often missed: several well-known products report to Equifax only, which leaves the TransUnion file empty. Also flags the warning signs on upfront-fee credit repair and advertised-certainty lending. Returns bundled reference material, optionally filtered or calculated from inputs; does not fetch live data or change accounts.

read-only

Argument	Type	Description
tier	string	Filter to one credibility tier. Omit for all.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "tier": {
      "enum": [
        "established",
        "legitimate_but_costly",
        "treat_with_caution"
      ],
      "type": "string",
      "description": "Filter to one credibility tier. Omit for all."
    }
  }
}

simulate_paydown

Use this when someone asks what happens if they pay a particular amount, or wants to compare two amounts. Returns a what-if for a specific payment on a specific card before it closes: reported utilization before and after, per card and blended. No score change is predicted. It is a calculation only; no payment is made. Calculates scenarios from supplied figures; does not make payments, change accounts, fetch external data, or retain tool inputs.

read-only

Argument	Type	Description
cards*	array	The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything.
today	string	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.
amount*	number	Payment amount in CAD, posting before that card's statement closes.
cardName*	string	Which card the payment goes on. Partial names are matched.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cards",
    "cardName",
    "amount"
  ],
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "creditLimit",
          "statementBalance"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "description": "What the person calls this card, e.g. \"TD Cash Back Visa\" or \"the blue one\"."
          },
          "last4": {
            "type": "string",
            "maxLength": 4,
            "description": "Last four digits, only to tell two similar cards apart. Optional and never required."
          },
          "dueDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Payment due date for the current statement. Defaults to 21 days after the closing date."
          },
          "isOverdue": {
            "type": "boolean",
            "description": "True if a payment is past due right now."
          },
          "aprPercent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Purchase APR as a percentage, e.g. 19.99. Omit when unknown. Never pass 0 to mean unknown — 0 is a real interest-free rate and cost estimates would understate what a balance costs."
          },
          "creditLimit": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Credit limit in CAD. Use 0 for a charge card or any account with no set limit — it is then excluded from utilization."
          },
          "currentBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Today's balance, if it differs from the statement balance. Defaults to statementBalance."
          },
          "minimumPayment": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "The issuer's minimum payment. Omit if unknown — do not pass 0 to mean unknown."
          },
          "statementBalance": {
            "type": "number",
            "maximum": 100000000,
            "minimum": 0,
            "description": "Balance at the most recent statement close. This is the figure the issuer reported, and the one utilization is read from. If only today's balance is known, pass it here and say so."
          },
          "statementCloseDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "The day the NEXT statement closes — the date the engine targets. Found on a statement or in online banking. If omitted, a placeholder 30 days out is assumed and flagged."
          }
        }
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "The person's revolving credit accounts. Ask for limit, statement balance, and statement closing date per card — those three drive everything."
    },
    "today": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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."
    },
    "amount": {
      "type": "number",
      "maximum": 100000000,
      "description": "Payment amount in CAD, posting before that card's statement closes.",
      "exclusiveMinimum": 0
    },
    "cardName": {
      "type": "string",
      "maxLength": 80,
      "description": "Which card the payment goes on. Partial names are matched."
    }
  }
}