Account: Get Plan Benefits & AI Credits
get_plan_and_credits[Subscribe/Credits]
[What it does] Reads the current account's subscription plan, plan limits/benefits, and current AI Credits balance in one call.
[When to use] Use when the user asks about their current plan, what the plan includes, or their remaining AI Credits. Trigger words: my plan, plan benefits, Credits balance.
[When not to use] For identity or permissions, use get_account_profile. For billing history or invoices, use get_plan_and_credit_billing. This tool returns no usage history or billing line items.
[How to use] No inputs are required; call with an empty object. benefits are plan allowances and feature switches, not current usage. credit_balance has subscription_credits, lifetime_credits, and an authoritative total_credits; never sum the first two to replace it. current_subscription is only the current snapshot, not full subscription history. All required upstream reads must succeed together; if any fails, the whole call returns a retryable error instead of partial data.
[Side effects] None; read-only.
[Confirmation] Not required.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_plan_and_credits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| benefits | Yes | Limits and feature entitlements included in the effective current subscription; these are allowances, not current usage | |
| credit_balance | Yes | Current AI Credits balance split by subscription and lifetime buckets | |
| active_subscriptions | Yes | All currently effective DSers plans returned by Plan BFF: the recurring subscription first, followed by every active one-time Advanced, Pro, or Enterprise plan; an empty list is valid | |
| current_subscription | Yes | Effective current DSers subscription returned by the Plan endpoint; use active_subscriptions to distinguish the recurring plan from active one-time plans | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |