# Billing actions

> Billing: 5 Xholic actions (5 read, 0 change), each with its MCP tool, REST endpoint and CLI command.

Source: https://docs.xholic.ai/actions/billing/

5 actions. Every field marked *Required* must be sent; `account`, `dryRun`, `idempotencyKey`, `confirmCredits` and `quoteId` are the [control fields](/api/responses/#control-fields) every surface adds.

## 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

`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

`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

`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

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