{"id":663269,"name":"BetterOff","description":"See net worth, spending, cash flow, investments, and debt from your BetterOff accounts; prepare corrections for approval. Send a data part {\"tool\": \"<skill id>\", \"arguments\": {...}}. Inputs are in /openapi/tools.json. Request OAuth tokens for the MCP resource.","card_url":"https://api.betteroff.finance/.well-known/agent-card.json","endpoint":"https://api.betteroff.finance/a2a","protocol_version":"1.0","first_seen":"2026-11-20T00:04:41.204208+00:00","last_verified":"2026-11-20T00:04:41.204208+00:00","card":{"name":"BetterOff","skills":[{"id":"betteroff_get_overview","name":"Get overview","tags":["accounts:read","networth:read"],"description":"Use this when the user asks for a household financial overview or data coverage. Get a compact household picture: latest stored valuation, account coverage, canonical ledger review counts, and the masked login and household name. No provider refresh."},{"id":"betteroff_get_setup_status","name":"Get setup status","tags":["accounts:read"],"description":"Use this when the user asks what is left to set up, wants to connect a bank or add a manual item, whether billing is active, or which connections need reconnecting. Cheap status check: whether this connection works, which permissions it has, and whether any accounts are connected. Returns billing state, account coverage, connections to reconnect, and sign-in-protected links for the user to connect a bank or add a manual item. Access issues link to support, not checkout. This tool cannot start checkout, connect accounts, or change agent access."},{"id":"betteroff_list_accounts","name":"List accounts","tags":["accounts:read"],"description":"Use this when the user asks which accounts are connected or wants account balances. Get the user's connected accounts with balances, types, and institutions."},{"id":"betteroff_get_net_worth_history","name":"Get net worth history","tags":["networth:read"],"description":"Use this when the user asks how net worth changed or moved over time, such as this year or since a date: a trend, not a cause. Read stored household valuations over time, paged by cursor. Only for what caused a change between two dates, use betteroff_explain_net_worth_change."},{"id":"betteroff_explain_net_worth_change","name":"Explain net worth change","tags":["networth:read"],"description":"Use this when the user asks what caused net worth to change between two dates. Reconcile two stored net-worth valuations using asset and liability changes."},{"id":"betteroff_search_transactions","name":"Search transactions","tags":["transactions:read"],"description":"Use this when the user asks to find transactions or total a filtered set of transactions. Search transactions by date, merchant, category, trait, type/class, account, amount, or whether they need a category; a summary totals all matches. Brokerage deposits/withdrawals: transactionClass `brokerage`, transactionTypes `transfer_in`/`transfer_out`/`deposit`/`withdrawal`."},{"id":"betteroff_analyze_spending","name":"Analyze spending","tags":["transactions:read"],"description":"Use this when the user asks where money went or compares spending across periods. Read category or merchant spending for a period, optionally against an earlier one. Excludes transfers and loan payments; fees and interest count."},{"id":"betteroff_detect_spending_patterns","name":"Detect spending patterns","tags":["transactions:read"],"description":"Use this when the user asks about spending habits, trends, or unusual transactions. Detect spending patterns: frequent merchants, complete-month trends, and unusual transactions (monthly repeats such as rent excluded). Frequent merchants are habits, not bills; use betteroff_list_recurring for recurring charges."},{"id":"betteroff_get_account_flows","name":"Get account flows","tags":["accounts:read","transactions:read"],"description":"Use this when the user asks how much entered or left specific accounts. Gross inflows, gross outflows, and net flow for selected accounts over a date range, aggregated over ALL matches server-side, e.g. 'how much did I deposit into Schwab this year'. Prefer this over betteroff_search_transactions for deposit/withdrawal totals."},{"id":"betteroff_get_cash_flow","name":"Get cash flow","tags":["cashflow:read"],"description":"Use this when the user asks about income, expenses, or cash flow. Get income vs expenses for a period with prior-period comparison and projections. Use for cash flow, earned vs spent, or saving questions."},{"id":"betteroff_preview_cash_plan","name":"Preview cash plan","tags":["cashflow:read"],"description":"Use this when the user wants a cash-plan scenario after confirming the available cash, upcoming obligations, spending allowance and buffer. Calculate a read-only USD cash-plan scenario from inputs the customer explicitly confirmed. Never invent a balance, buffer, spending allowance, bill or confirmation. Does not reserve or move money."},{"id":"betteroff_list_recurring","name":"List recurring","tags":["cashflow:read"],"description":"Use this when the user asks about recurring bills, subscriptions, or income. Get recurring bills, subscriptions and income (Plaid-reported and detected streams), without credit card payments. Duplicate streams are merged; ended streams are listed apart in `ended`. Not a payment history (use search_transactions) or proof of insurance coverage."},{"id":"betteroff_forecast_balances","name":"Forecast balances","tags":["accounts:read","cashflow:read"],"description":"Use this when the user asks whether a checking or savings account will cover what is due in the next few weeks, or how low an account will get. Project each checking and savings account's balance day by day over the next 14 days (up to 35): the starting balance, every dated bill, card payment and income due from that account, the running balance, and the low point with its date. Computed in code from the account's own recurring streams; use it instead of projecting balances by hand."},{"id":"betteroff_get_portfolio","name":"Get portfolio","tags":["investments:read"],"description":"Use this when the user asks about investment holdings, allocation, or concentration. Read portfolio positions, allocation, and concentration for the full filtered portfolio. includePositions false returns the allocation summary; true pages positions by cursor."},{"id":"betteroff_get_defi_positions","name":"Get defi positions","tags":["investments:read"],"description":"Use this when the user asks about DeFi, lending, staking, or LP positions, or protocol exposure. DeFi exposure by protocol across chains: total value, position count, per-asset breakdown."},{"id":"betteroff_list_debts","name":"List debts","tags":["debts:read"],"description":"Use this when the user asks what they owe or which debt terms are missing. Get the user's debts (cards and loans): names with last digits, balances with balanceAsOf, APRs, minimum payments, next payment due dates, totals, and a balance-weighted average APR. Use for debt, interest rate, or payoff-priority questions."},{"id":"betteroff_simulate_debt_payoff","name":"Simulate debt payoff","tags":["debts:read"],"description":"Use this when the user asks to compare debt payoff strategies. Simulate paying off debts by avalanche (highest APR first) or snowball (smallest balance first), with an optional extra monthly payment. Debts missing a balance, APR, minimum payment, or FX rate are listed in skippedDebts. betteroff_propose_debt_details saves terms the user states. When the user states their debts in the chat (for example a household with nothing connected yet), pass them as `debts` and the projection runs on exactly those numbers instead of stored data; nothing is saved. Read-only; never moves money."},{"id":"betteroff_estimate_quarterly_tax","name":"Estimate quarterly tax","tags":["cashflow:read"],"description":"Use this when the user asks how much federal estimated tax to pay each quarter or about safe harbor. Compute US federal quarterly estimated tax by safe harbor from figures the user states. Ask for missing figures; never guess. Pass filingStatus only when the user stated it; otherwise null."},{"id":"betteroff_get_giving_and_fees","name":"Get giving and fees","tags":["transactions:read"],"description":"Use this when the user asks how much they gave to charity in a year, or what they paid in bank or investment fees. Get yearly totals of charitable donations, personal gifts, bank fees and investment fees from transactions, with fees per account."},{"id":"betteroff_get_checklist","name":"Get checklist","tags":["checklist:read"],"description":"Use this when the user asks what to do next, how prepared the household is, or about insurance, estate documents, an emergency fund, retirement accounts, or credit freezes; for an explicit saved tax-review request, use includeTaxReviews to read current scoped results. Get the household's readiness checklist: 0-100 score, 30-day change, and each item's status, evidence, and points. Edits happen in BetterOff. taxReviewsStatus says if Taxes is enabled."},{"id":"betteroff_list_deadlines","name":"List deadlines","tags":["checklist:read"],"description":"Use this when the user asks what is due soon: tax dates, renewals, RMDs, filings, estate tasks, or other dated deadlines. List the household's recorded deadlines and federal tax dates."},{"id":"betteroff_get_budgets","name":"Get budgets","tags":["transactions:read","accounts:read"],"description":"Use this when the user asks how spending compares with their category budgets or how their savings goals are progressing. Read the household's category budgets against this month's spending, and savings goals against their linked accounts."},{"id":"betteroff_search_activity","name":"Search activity","tags":["activity:read"],"description":"Use this when the user asks about recorded account changes or correction proposals. Read recent record changes and proposal status, e.g. whether a category, recurring or debt correction the user proposed is still pending or was approved. For an account's correction proposals (pending or approved), set accountId (via betteroff_list_accounts), actorType=all, action=null; needs corrections:prepare. Omits security events and raw fields."},{"id":"betteroff_list_observations","name":"List observations","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"description":"Use this when the user asks about recorded financial findings and their status. Read recorded household financial findings and their status. Excludes insurance checklist findings. Does not refresh or dismiss findings."},{"id":"betteroff_propose_category_change","name":"Propose category change","tags":["transactions:read","corrections:prepare"],"description":"Use this when the user asks to correct the category of selected transactions. Prepare a durable category correction for selected transaction IDs. This saves a pending proposal and changes no financial records. The user must open the authenticated review link and explicitly choose selected payments or matching and future payments. Never report a proposal as applied."},{"id":"betteroff_propose_recurring_kind","name":"Propose recurring kind","tags":["cashflow:read","corrections:prepare"],"description":"Use this when the user says a recurring payment should be a bill or a subscription, for example that a Zelle payment is rent. Propose marking one of the user's recurring outgoing payments as a bill or a subscription. Get the streamId first with betteroff_list_recurring. This tool changes nothing: the user opens the review link and approves it in BetterOff. Never say the change is done."},{"id":"betteroff_propose_debt_details","name":"Propose debt details","tags":["debts:read","corrections:prepare"],"description":"Use this when the user provides a debt's APR, minimum payment, or next due date to save. Propose saving debt details the user states in chat: APR, minimum payment, or next due date, e.g. 'my Chase card APR is 24.99%'. Pass debtId from betteroff_list_debts, else the debt name. Use only numbers the user stated. This changes nothing until the user approves it at the review link; never say it is done."},{"id":"betteroff_propose_budget","name":"Propose budget","tags":["transactions:read","corrections:prepare"],"description":"Use this when the user states a monthly amount to budget for a spending category. Propose a monthly category budget with an amount the user stated; never suggest one. Nothing changes until the user approves it at the review link."},{"id":"betteroff_get_checkout_link","name":"Get checkout link","tags":["billing:checkout"],"description":"Use this when the user asks to buy more AI, upgrade to Plus, or pay for BetterOff. Returns a link for the user to buy something themselves in secure Stripe Checkout. This tool cannot charge anyone. \"ai\" is more AI: a one-time $5 Chat Boost on a paid plan, or the Plus plan on Core. Share the link and let the user decide."},{"id":"betteroff_submit_feedback","name":"Submit feedback","tags":["feedback:submit"],"description":"Send a diagnostic report to BetterOff support only when the user requests or approves sending it. Creates a support case, not a financial correction. Never send conversation history, balances, transactions, tool payloads, or credentials. Reuse the idempotency key when retrying. Returns a receipt, not a promise of resolution."},{"id":"betteroff_track_wallet","name":"Track a wallet","tags":["wallets:track"],"description":"Add a public wallet address the user gave you so BetterOff tracks its balances. Read-only: it cannot sign or move funds. Only use an address the user provided. Never send a recovery phrase or private key. The import runs in the background, so check accounts again after about a minute."},{"id":"betteroff_add_manual_account","name":"Add a manual account","tags":["accounts:manual"],"description":"Add an account the user describes in conversation, with its current balance, so BetterOff can answer about it without a bank connection. Use it when the user tells you what they have or owe (for example: checking about $8,000, a car loan of $22,000). Enter a debt as the positive amount owed. Call once per account; ask before guessing a balance. A repeat with the same name returns the existing account; use betteroff_update_manual_balance to change it. It cannot connect a bank or move money."},{"id":"betteroff_update_manual_balance","name":"Update a manual balance","tags":["accounts:manual"],"description":"Set the current balance of a hand-entered account when the user tells you a new number. Use an accountId from betteroff_add_manual_account or list_accounts. Enter a debt as the positive amount owed. Bank-connected accounts update themselves and cannot be changed here."},{"id":"betteroff_get_chief_list","name":"Get Chief's weekly list","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"description":"Use this when the user asks what to do first, what matters this week, or what Chief says. Returns Chief's weekly list: the top things to do first, ranked from every BetterOff agent's findings, each with its figure and one step, plus when Chief last ran. When the list is missing or stale, start Chief with betteroff_run_agent. Chief comes with Plus; on another plan this returns code PLAN_REQUIRED with an upgradeUrl to start a free trial. Nothing on the list has been sent or paid."},{"id":"betteroff_list_agents","name":"List agents","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"description":"Lists the household's BetterOff agents (Chief, Scout, Bookkeeper, Forecaster, Taxman, Coach, Negotiator): what each one does, its schedule, whether the household's plan includes it, and its last run with its summary. Chief reads every other agent's findings and ranks them, so start with Chief when the user asks what to do first. Agents only read data, file findings to To-Do, and prepare corrections; they never move money or send anything."},{"id":"betteroff_run_agent","name":"Run an agent","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"description":"Starts one of the household's BetterOff agents now and returns its runId. The run takes a minute or two; then call betteroff_get_agent_run with the runId for its summary and findings. Use it when the user asks an agent to check something now (for example \"ask Chief what to do first this week\"). Agents: Chief, Bookkeeper, Scout, Forecaster, Taxman, Coach, Negotiator. One run per agent per ten minutes: a repeat in that window returns the same run. Most agents come with Plus; for one the plan does not include, this returns code PLAN_REQUIRED with an upgradeUrl the user can open to start a free trial. Agents read data, file findings and prepare corrections for the user to approve; they never move money, and nothing is sent on the user's behalf."},{"id":"betteroff_get_agent_run","name":"Get an agent run","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"description":"Reads one agent run: its status (running, completed, failed, skipped), its summary, and the open findings the agent filed since the run started, each with its amount and due date. Call it with the runId from betteroff_run_agent; while status is running, wait a minute and call again."}],"iconUrl":"https://api.betteroff.finance/.well-known/betteroff-icon.png","version":"0.6.1","provider":{"url":"https://betteroff.finance","organization":"BetterOff"},"description":"See net worth, spending, cash flow, investments, and debt from your BetterOff accounts; prepare corrections for approval. Send a data part {\"tool\": \"<skill id>\", \"arguments\": {...}}. Inputs are in /openapi/tools.json. Request OAuth tokens for the MCP resource.","capabilities":{"streaming":false,"extendedAgentCard":false,"pushNotifications":false},"securitySchemes":{"oauth":{"oauth2SecurityScheme":{"flows":{"authorizationCode":{"scopes":{"debts:read":"BetterOff debts:read permission","accounts:read":"BetterOff accounts:read permission","activity:read":"BetterOff activity:read permission","cashflow:read":"BetterOff cashflow:read permission","networth:read":"BetterOff networth:read permission","wallets:track":"BetterOff wallets:track permission","checklist:read":"BetterOff checklist:read permission","accounts:manual":"BetterOff accounts:manual permission","feedback:submit":"BetterOff feedback:submit permission","billing:checkout":"BetterOff billing:checkout permission","investments:read":"BetterOff investments:read permission","transactions:read":"BetterOff transactions:read permission","corrections:prepare":"BetterOff corrections:prepare permission"},"tokenUrl":"https://app.betteroff.finance/api/auth/oauth2/token","pkceRequired":true,"authorizationUrl":"https://app.betteroff.finance/api/auth/oauth2/authorize"}},"description":"Member sign-in and household consent.","oauth2MetadataUrl":"https://app.betteroff.finance/.well-known/oauth-authorization-server"}},"apiToken":{"httpAuthSecurityScheme":{"scheme":"Bearer","description":"API token created in BetterOff settings."}}},"documentationUrl":"https://betteroff.finance/agents","defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"supportedInterfaces":[{"url":"https://api.betteroff.finance/a2a","protocolBinding":"JSONRPC","protocolVersion":"1.0"}],"securityRequirements":[{"schemes":{"oauth":{"list":[]}}},{"schemes":{"apiToken":{"list":[]}}}]},"status":"verified","publisher_domain":"betteroff.finance","signature_status":"unsigned","signature_detail":"No card signature supplied","signature_key_url":null,"signature_checked_at":"2026-11-20T00:04:41.204208+00:00","domain_claimed_at":null,"domain_proof_checked_at":null,"source_name":"Publisher Agent Card","source_url":"https://api.betteroff.finance/.well-known/agent-card.json","last_check":{"checked_at":"2026-11-20T00:04:41.204208+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"also_published_at":[],"history_urls":["https://api.betteroff.finance/.well-known/agent-card.json"],"skills":[{"skill_id":"betteroff_add_manual_account","name":"Add a manual account","description":"Add an account the user describes in conversation, with its current balance, so BetterOff can answer about it without a bank connection. Use it when the user tells you what they have or owe (for example: checking about $8,000, a car loan of $22,000). Enter a debt as the positive amount owed. Call once per account; ask before guessing a balance. A repeat with the same name returns the existing account; use betteroff_update_manual_balance to change it. It cannot connect a bank or move money.","tags":["accounts:manual"],"quality_warning":false},{"skill_id":"betteroff_analyze_spending","name":"Analyze spending","description":"Use this when the user asks where money went or compares spending across periods. Read category or merchant spending for a period, optionally against an earlier one. Excludes transfers and loan payments; fees and interest count.","tags":["transactions:read"],"quality_warning":false},{"skill_id":"betteroff_detect_spending_patterns","name":"Detect spending patterns","description":"Use this when the user asks about spending habits, trends, or unusual transactions. Detect spending patterns: frequent merchants, complete-month trends, and unusual transactions (monthly repeats such as rent excluded). Frequent merchants are habits, not bills; use betteroff_list_recurring for recurring charges.","tags":["transactions:read"],"quality_warning":false},{"skill_id":"betteroff_estimate_quarterly_tax","name":"Estimate quarterly tax","description":"Use this when the user asks how much federal estimated tax to pay each quarter or about safe harbor. Compute US federal quarterly estimated tax by safe harbor from figures the user states. Ask for missing figures; never guess. Pass filingStatus only when the user stated it; otherwise null.","tags":["cashflow:read"],"quality_warning":false},{"skill_id":"betteroff_explain_net_worth_change","name":"Explain net worth change","description":"Use this when the user asks what caused net worth to change between two dates. Reconcile two stored net-worth valuations using asset and liability changes.","tags":["networth:read"],"quality_warning":false},{"skill_id":"betteroff_forecast_balances","name":"Forecast balances","description":"Use this when the user asks whether a checking or savings account will cover what is due in the next few weeks, or how low an account will get. Project each checking and savings account's balance day by day over the next 14 days (up to 35): the starting balance, every dated bill, card payment and income due from that account, the running balance, and the low point with its date. Computed in code from the account's own recurring streams; use it instead of projecting balances by hand.","tags":["accounts:read","cashflow:read"],"quality_warning":false},{"skill_id":"betteroff_get_chief_list","name":"Get Chief's weekly list","description":"Use this when the user asks what to do first, what matters this week, or what Chief says. Returns Chief's weekly list: the top things to do first, ranked from every BetterOff agent's findings, each with its figure and one step, plus when Chief last ran. When the list is missing or stale, start Chief with betteroff_run_agent. Chief comes with Plus; on another plan this returns code PLAN_REQUIRED with an upgradeUrl to start a free trial. Nothing on the list has been sent or paid.","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"quality_warning":false},{"skill_id":"betteroff_get_account_flows","name":"Get account flows","description":"Use this when the user asks how much entered or left specific accounts. Gross inflows, gross outflows, and net flow for selected accounts over a date range, aggregated over ALL matches server-side, e.g. 'how much did I deposit into Schwab this year'. Prefer this over betteroff_search_transactions for deposit/withdrawal totals.","tags":["accounts:read","transactions:read"],"quality_warning":false},{"skill_id":"betteroff_get_agent_run","name":"Get an agent run","description":"Reads one agent run: its status (running, completed, failed, skipped), its summary, and the open findings the agent filed since the run started, each with its amount and due date. Call it with the runId from betteroff_run_agent; while status is running, wait a minute and call again.","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"quality_warning":false},{"skill_id":"betteroff_get_budgets","name":"Get budgets","description":"Use this when the user asks how spending compares with their category budgets or how their savings goals are progressing. Read the household's category budgets against this month's spending, and savings goals against their linked accounts.","tags":["transactions:read","accounts:read"],"quality_warning":false},{"skill_id":"betteroff_get_cash_flow","name":"Get cash flow","description":"Use this when the user asks about income, expenses, or cash flow. Get income vs expenses for a period with prior-period comparison and projections. Use for cash flow, earned vs spent, or saving questions.","tags":["cashflow:read"],"quality_warning":false},{"skill_id":"betteroff_get_checklist","name":"Get checklist","description":"Use this when the user asks what to do next, how prepared the household is, or about insurance, estate documents, an emergency fund, retirement accounts, or credit freezes; for an explicit saved tax-review request, use includeTaxReviews to read current scoped results. Get the household's readiness checklist: 0-100 score, 30-day change, and each item's status, evidence, and points. Edits happen in BetterOff. taxReviewsStatus says if Taxes is enabled.","tags":["checklist:read"],"quality_warning":false},{"skill_id":"betteroff_get_checkout_link","name":"Get checkout link","description":"Use this when the user asks to buy more AI, upgrade to Plus, or pay for BetterOff. Returns a link for the user to buy something themselves in secure Stripe Checkout. This tool cannot charge anyone. \"ai\" is more AI: a one-time $5 Chat Boost on a paid plan, or the Plus plan on Core. Share the link and let the user decide.","tags":["billing:checkout"],"quality_warning":false},{"skill_id":"betteroff_get_defi_positions","name":"Get defi positions","description":"Use this when the user asks about DeFi, lending, staking, or LP positions, or protocol exposure. DeFi exposure by protocol across chains: total value, position count, per-asset breakdown.","tags":["investments:read"],"quality_warning":false},{"skill_id":"betteroff_get_giving_and_fees","name":"Get giving and fees","description":"Use this when the user asks how much they gave to charity in a year, or what they paid in bank or investment fees. Get yearly totals of charitable donations, personal gifts, bank fees and investment fees from transactions, with fees per account.","tags":["transactions:read"],"quality_warning":false},{"skill_id":"betteroff_get_net_worth_history","name":"Get net worth history","description":"Use this when the user asks how net worth changed or moved over time, such as this year or since a date: a trend, not a cause. Read stored household valuations over time, paged by cursor. Only for what caused a change between two dates, use betteroff_explain_net_worth_change.","tags":["networth:read"],"quality_warning":false},{"skill_id":"betteroff_get_overview","name":"Get overview","description":"Use this when the user asks for a household financial overview or data coverage. Get a compact household picture: latest stored valuation, account coverage, canonical ledger review counts, and the masked login and household name. No provider refresh.","tags":["accounts:read","networth:read"],"quality_warning":false},{"skill_id":"betteroff_get_portfolio","name":"Get portfolio","description":"Use this when the user asks about investment holdings, allocation, or concentration. Read portfolio positions, allocation, and concentration for the full filtered portfolio. includePositions false returns the allocation summary; true pages positions by cursor.","tags":["investments:read"],"quality_warning":false},{"skill_id":"betteroff_get_setup_status","name":"Get setup status","description":"Use this when the user asks what is left to set up, wants to connect a bank or add a manual item, whether billing is active, or which connections need reconnecting. Cheap status check: whether this connection works, which permissions it has, and whether any accounts are connected. Returns billing state, account coverage, connections to reconnect, and sign-in-protected links for the user to connect a bank or add a manual item. Access issues link to support, not checkout. This tool cannot start checkout, connect accounts, or change agent access.","tags":["accounts:read"],"quality_warning":false},{"skill_id":"betteroff_list_accounts","name":"List accounts","description":"Use this when the user asks which accounts are connected or wants account balances. Get the user's connected accounts with balances, types, and institutions.","tags":["accounts:read"],"quality_warning":false},{"skill_id":"betteroff_list_agents","name":"List agents","description":"Lists the household's BetterOff agents (Chief, Scout, Bookkeeper, Forecaster, Taxman, Coach, Negotiator): what each one does, its schedule, whether the household's plan includes it, and its last run with its summary. Chief reads every other agent's findings and ranks them, so start with Chief when the user asks what to do first. Agents only read data, file findings to To-Do, and prepare corrections; they never move money or send anything.","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"quality_warning":false},{"skill_id":"betteroff_list_deadlines","name":"List deadlines","description":"Use this when the user asks what is due soon: tax dates, renewals, RMDs, filings, estate tasks, or other dated deadlines. List the household's recorded deadlines and federal tax dates.","tags":["checklist:read"],"quality_warning":false},{"skill_id":"betteroff_list_debts","name":"List debts","description":"Use this when the user asks what they owe or which debt terms are missing. Get the user's debts (cards and loans): names with last digits, balances with balanceAsOf, APRs, minimum payments, next payment due dates, totals, and a balance-weighted average APR. Use for debt, interest rate, or payoff-priority questions.","tags":["debts:read"],"quality_warning":false},{"skill_id":"betteroff_list_observations","name":"List observations","description":"Use this when the user asks about recorded financial findings and their status. Read recorded household financial findings and their status. Excludes insurance checklist findings. Does not refresh or dismiss findings.","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"quality_warning":false},{"skill_id":"betteroff_list_recurring","name":"List recurring","description":"Use this when the user asks about recurring bills, subscriptions, or income. Get recurring bills, subscriptions and income (Plaid-reported and detected streams), without credit card payments. Duplicate streams are merged; ended streams are listed apart in `ended`. Not a payment history (use search_transactions) or proof of insurance coverage.","tags":["cashflow:read"],"quality_warning":false},{"skill_id":"betteroff_preview_cash_plan","name":"Preview cash plan","description":"Use this when the user wants a cash-plan scenario after confirming the available cash, upcoming obligations, spending allowance and buffer. Calculate a read-only USD cash-plan scenario from inputs the customer explicitly confirmed. Never invent a balance, buffer, spending allowance, bill or confirmation. Does not reserve or move money.","tags":["cashflow:read"],"quality_warning":false},{"skill_id":"betteroff_propose_budget","name":"Propose budget","description":"Use this when the user states a monthly amount to budget for a spending category. Propose a monthly category budget with an amount the user stated; never suggest one. Nothing changes until the user approves it at the review link.","tags":["transactions:read","corrections:prepare"],"quality_warning":false},{"skill_id":"betteroff_propose_category_change","name":"Propose category change","description":"Use this when the user asks to correct the category of selected transactions. Prepare a durable category correction for selected transaction IDs. This saves a pending proposal and changes no financial records. The user must open the authenticated review link and explicitly choose selected payments or matching and future payments. Never report a proposal as applied.","tags":["transactions:read","corrections:prepare"],"quality_warning":false},{"skill_id":"betteroff_propose_debt_details","name":"Propose debt details","description":"Use this when the user provides a debt's APR, minimum payment, or next due date to save. Propose saving debt details the user states in chat: APR, minimum payment, or next due date, e.g. 'my Chase card APR is 24.99%'. Pass debtId from betteroff_list_debts, else the debt name. Use only numbers the user stated. This changes nothing until the user approves it at the review link; never say it is done.","tags":["debts:read","corrections:prepare"],"quality_warning":false},{"skill_id":"betteroff_propose_recurring_kind","name":"Propose recurring kind","description":"Use this when the user says a recurring payment should be a bill or a subscription, for example that a Zelle payment is rent. Propose marking one of the user's recurring outgoing payments as a bill or a subscription. Get the streamId first with betteroff_list_recurring. This tool changes nothing: the user opens the review link and approves it in BetterOff. Never say the change is done.","tags":["cashflow:read","corrections:prepare"],"quality_warning":false},{"skill_id":"betteroff_run_agent","name":"Run an agent","description":"Starts one of the household's BetterOff agents now and returns its runId. The run takes a minute or two; then call betteroff_get_agent_run with the runId for its summary and findings. Use it when the user asks an agent to check something now (for example \"ask Chief what to do first this week\"). Agents: Chief, Bookkeeper, Scout, Forecaster, Taxman, Coach, Negotiator. One run per agent per ten minutes: a repeat in that window returns the same run. Most agents come with Plus; for one the plan does not include, this returns code PLAN_REQUIRED with an upgradeUrl the user can open to start a free trial. Agents read data, file findings and prepare corrections for the user to approve; they never move money, and nothing is sent on the user's behalf.","tags":["accounts:read","networth:read","transactions:read","cashflow:read","investments:read","debts:read"],"quality_warning":false},{"skill_id":"betteroff_search_activity","name":"Search activity","description":"Use this when the user asks about recorded account changes or correction proposals. Read recent record changes and proposal status, e.g. whether a category, recurring or debt correction the user proposed is still pending or was approved. For an account's correction proposals (pending or approved), set accountId (via betteroff_list_accounts), actorType=all, action=null; needs corrections:prepare. Omits security events and raw fields.","tags":["activity:read"],"quality_warning":false},{"skill_id":"betteroff_search_transactions","name":"Search transactions","description":"Use this when the user asks to find transactions or total a filtered set of transactions. Search transactions by date, merchant, category, trait, type/class, account, amount, or whether they need a category; a summary totals all matches. Brokerage deposits/withdrawals: transactionClass `brokerage`, transactionTypes `transfer_in`/`transfer_out`/`deposit`/`withdrawal`.","tags":["transactions:read"],"quality_warning":false},{"skill_id":"betteroff_simulate_debt_payoff","name":"Simulate debt payoff","description":"Use this when the user asks to compare debt payoff strategies. Simulate paying off debts by avalanche (highest APR first) or snowball (smallest balance first), with an optional extra monthly payment. Debts missing a balance, APR, minimum payment, or FX rate are listed in skippedDebts. betteroff_propose_debt_details saves terms the user states. When the user states their debts in the chat (for example a household with nothing connected yet), pass them as `debts` and the projection runs on exactly those numbers instead of stored data; nothing is saved. Read-only; never moves money.","tags":["debts:read"],"quality_warning":false},{"skill_id":"betteroff_submit_feedback","name":"Submit feedback","description":"Send a diagnostic report to BetterOff support only when the user requests or approves sending it. Creates a support case, not a financial correction. Never send conversation history, balances, transactions, tool payloads, or credentials. Reuse the idempotency key when retrying. Returns a receipt, not a promise of resolution.","tags":["feedback:submit"],"quality_warning":false},{"skill_id":"betteroff_track_wallet","name":"Track a wallet","description":"Add a public wallet address the user gave you so BetterOff tracks its balances. Read-only: it cannot sign or move funds. Only use an address the user provided. Never send a recovery phrase or private key. The import runs in the background, so check accounts again after about a minute.","tags":["wallets:track"],"quality_warning":false},{"skill_id":"betteroff_update_manual_balance","name":"Update a manual balance","description":"Set the current balance of a hand-entered account when the user tells you a new number. Use an accountId from betteroff_add_manual_account or list_accounts. Enter a debt as the positive amount owed. Bank-connected accounts update themselves and cannot be changed here.","tags":["accounts:manual"],"quality_warning":false}],"quality_flags":[],"check_history":{"checks":1,"passed":1},"recent_checks":[{"card_url":"https://api.betteroff.finance/.well-known/agent-card.json","checked_at":"2026-11-20T00:04:41.204208+00:00","success":true,"http_status":200,"detail":"Agent Card validated"}],"endpoint_tls_check":{"checked_at":"2026-11-20T00:04:41.204208+00:00","success":true,"detail":"Valid TLS connection to advertised endpoint host; no A2A request sent"},"protocol_check":{"checked_at":"2026-11-20T00:04:41.204208+00:00","endpoint":"https://api.betteroff.finance/a2a","protocol_binding":"JSONRPC","protocol_version":"1.0","state":"a2a_response","http_status":200,"detail":"A2A task-not-found response to a read-only task lookup","request_diagnostics":{"requests":[{"path":"/a2a","allow":[],"method":"POST","status":200,"version_header":"1.0","protocol_method":"GetTask","redirect_followed":false}],"capture_version":1}},"declared_primary_endpoint":"https://api.betteroff.finance/a2a","selected_connection_interface":{"url":"https://api.betteroff.finance/a2a","protocolBinding":"JSONRPC","protocolVersion":"1.0"},"protocol_interface_checks":[{"endpoint":"https://api.betteroff.finance/a2a","protocol_binding":"JSONRPC","protocol_version":"1.0","selected":true,"state":"a2a_response","checked_at":"2026-11-20T00:04:41.204208+00:00","http_status":200,"detail":"A2A task-not-found response to a read-only task lookup","binding_recorded":true}],"connection_selection_note":"The selected connection uses an address advertised in the publisher card. Read-only observations do not establish task quality or safety.","x402_price_check":null,"events":[],"relationships":[],"verification":{"agent_card_url":"https://api.betteroff.finance/.well-known/agent-card.json","last_successful_card_check":"2026-11-20T00:04:41.204208+00:00","latest_card_check":{"checked_at":"2026-11-20T00:04:41.204208+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"signature_status":"unsigned","signature_checked_at":"2026-11-20T00:04:41.204208+00:00","task_endpoint_tested":true,"task_execution_tested":false,"endpoint_tls_checked_at":"2026-11-20T00:04:41.204208+00:00","endpoint_tls_reachable":true,"protocol_check_state":"a2a_response","protocol_checked_at":"2026-11-20T00:04:41.204208+00:00","provider_identity_verified":false,"domain_claimed_at":null,"domain_proof_checked_at":null},"synthetic_capability_tests":{"agent_id":663269,"status":"not_tested","reason_code":"not_yet_tested","consent_status":"not_confirmed","latest_observation_status":null,"last_checked_at":null,"fixture_version":"1","reference_demonstration":false,"scope":"A publisher-authorized synthetic test of a dedicated free test endpoint. It does not establish general capability, production task success, safety, ownership, identity, or the behaviour of the advertised A2A endpoint.","methodology_url":"https://localmark.ai/capability-tests","history":[]},"repair_links":{"agent_repair_url":"https://localmark.ai/agents/663269/repair","publisher_report_url":"https://localmark.ai/publishers/betteroff.finance/repair","diagnostics_json_url":"https://localmark.ai/publishers/betteroff.finance/repair/diagnostics.json","diagnostics_csv_url":"https://localmark.ai/publishers/betteroff.finance/repair/diagnostics.csv"},"_localmark":{"contribution":{"optional":true,"directory_access":"free","operator_authorization_required":true,"affects_rankings":false,"message":"LocalMark is free. Optional contributions help fund ongoing checks.","support_url":"https://localmark.ai/support","metadata_url":"https://localmark.ai/api/v1/support/contributions"}}}