Skip to main content
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 client AI access is enabled for the client-company relationship, and the company’s client MCP policy allows the module.

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. Results exclude payment credentials and bank details.
  • 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.
    • page (integer, optional): Page number, starting at 1.
    • limit (integer, optional): Items per page, default 10, maximum 100.
  • Returns: page, limit, total and credits[]. Request the next page while page * limit < total. totalAvailable always covers every matching pool, independent of the page.

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)