> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Client AI Account

> Reference for a connected client's own subscriptions, invoices, and credits.

The `client_ai_account` module lets a client's AI assistant read the client's
own subscriptions, invoices, and credit balances. Client AI tools are
subject-bound: every call resolves to the authenticated client
(`subjectClientId`) and can never access another client's records. The module
is available only when the company MCP integration feature is enabled, client
AI access is enabled for the client-company relationship, and the company's
client MCP policy allows the module.

| Key                  | Value                      |
| :------------------- | :------------------------- |
| **Module Key**       | `client_ai_account`        |
| **Sensitivity**      | `operational`              |
| **Consent Required** | None (OAuth approval only) |

***

## Available Tools

### `client_ai_get_my_subscription`

Retrieve your active or past subscriptions in this company, including product details, start date, end date, and next billing date.

* **Type:** Read-only
* **Important Input Fields:**
  * `page` (integer, optional): Page number for pagination.
  * `limit` (integer, optional): Number of subscriptions per page, max 50.

### `client_ai_list_my_invoices`

Retrieve your own invoices, sorted newest first. Safe/redacted DTOs are returned; no payment credentials or bank details are leaked.

* **Type:** Read-only
* **Important Input Fields:**
  * `page` (integer, optional): Page number for pagination.
  * `limit` (integer, optional): Number of invoices per page, max 100.

### `client_ai_get_my_credits`

Retrieve your own active credits and credit pools (session packs, subscription credits) and total available credits.

* **Type:** Read-only
* **Important Input Fields:**
  * `includeInactive` (boolean, optional): Include inactive/expired credit pools. Defaults to `false`.

***

## Natural Language Examples

* *"How many credits do I have left this month?"*
* *"When is my next subscription payment due?"*
* *"Show me my last three invoices."*

***

## JSON-RPC Call Example (`client_ai_get_my_credits`)

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": "client-account-1",
  "method": "tools/call",
  "params": {
    "name": "client_ai_get_my_credits",
    "arguments": {
      "includeInactive": false
    }
  }
}
```