get_subscription

Return subscription status for the authenticated tenant: plan name, Stripe subscription status, current billing period end, and whether the subscription is set to cancel at period end. Use this when the user asks about their plan, billing, or renewal state. Returns: plan (str), stripe_subscription_status (str|null), current_period_end_iso (str ISO-8601|null), cancel_at_period_end (bool).

read-only · idempotent

Parameters

This tool takes no parameters.

Returns

Returns a structured object. Top-level fields:

• plan (string)
• stripe_subscription_status (string)
• current_period_end_iso (string)
• cancel_at_period_end (boolean)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "get_subscription",
  "arguments": {}
}

Response

{
  "plan": "pro",
  "stripe_subscription_status": "active",
  "current_period_end_iso": "2026-06-01T00:00:00+00:00",
  "cancel_at_period_end": false
}

Notes

• Module: Billing
• Requires authentication via API token or Auth0 JWT.