Skip to content
Xholic AI

Billing actions

MarkdownAsk ChatGPTAsk Claude

5 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.

Plan and subscription

Section titled “Plan and subscription”

billing.status · read

The user’s plan and subscription state, including trial dates. Read-only: plan changes, cancelling and payments happen in the Xholic app.

  • MCP tool: billing_status. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
  • REST: GET /v1/billing/status
  • CLI: xholic billing status
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Free.
  • Rate limit bucket: read

Input

No input.

Billing details

Section titled “Billing details”

billing.details · read

The billing details on file for the subscription. Read-only: changes happen in the Xholic app.

  • MCP tool: billing_details. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
  • REST: GET /v1/billing/details
  • CLI: xholic billing details
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Free.
  • Rate limit bucket: read

Input

No input.

Payment history

Section titled “Payment history”

billing.payments · read

Past payments and invoices. Read-only.

  • MCP tool: billing_payments. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
  • REST: GET /v1/billing/payments
  • CLI: xholic billing payments
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Free.
  • Rate limit bucket: read

Input

No input.

AI credit packs

Section titled “AI credit packs”

billing.credit_packs · read

The AI credit packs the user can buy and their prices. Buying happens in the Xholic app; point the user there.

  • MCP tool: billing_credit_packs. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
  • REST: GET /v1/billing/credit-packs
  • CLI: xholic billing credit-packs
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Free.
  • Rate limit bucket: read

Input

No input.

Trial eligibility

Section titled “Trial eligibility”

billing.trial_eligibility · read

Whether a checkout would still include the free trial for this user.

  • MCP tool: billing_trial_eligibility. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
  • REST: GET /v1/billing/trial-eligibility
  • CLI: xholic billing trial-eligibility
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Free.
  • Rate limit bucket: read

Input

No input.