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

> Reference for a connected client reviewing and submitting their own checkups.

The `client_ai_checkups` module lets a client's AI assistant list assigned
checkup schedules, review past submissions, and submit answers for open
checkup forms. Client AI tools are subject-bound: every call resolves to the
authenticated client (`subjectClientId`) and can only touch checkups assigned
to that client. The module is available only when the company MCP integration
feature is enabled, client AI access is enabled for the client-company
relationship, the company's client MCP policy allows the module (write tools
additionally require the company policy to allow them), and the client has
granted health data consent.

| Key                  | Value                |
| :------------------- | :------------------- |
| **Module Key**       | `client_ai_checkups` |
| **Sensitivity**      | `health`             |
| **Consent Required** | `healthDataConsent`  |

***

## Available Tools

### `client_ai_list_my_checkups`

Retrieve all checkup settings and assigned schedules for yourself. Results are sorted newest first.

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

### `client_ai_get_my_checkup`

Retrieve your own checkup submission history for a specific checkup setting. Results are sorted newest first.

* **Type:** Read-only
* **Important Input Fields:**
  * `settingId` (string, required): The unique ID of the checkup setting.
  * `page` (integer, optional): Page number for pagination.
  * `limit` (integer, optional): Number of submissions per page, max 50.

### `client_ai_submit_my_checkup` **`Write`**

Submit answers for an assigned open checkup form. Clients may submit only checkups assigned to themselves and cannot alter templates or coach reviews.

* **Type:** Write
* **Important Input Fields:**
  * `settingId` (string, required): The unique checkup setting ID.
  * `sectionAnswers` (array, required): List of section answers. Each item has an optional `sectionId` (string) and a required `answers` array of `{ questionId (string, required), answerType (string, optional), answer (string, required) }` objects.
  * `measurementAnswers` (array, optional): List of measurement answers with `typeId` (string, required) and `value` (number, required).
  * `submittedFor` (string, optional): Target date string (`YYYY-MM-DD`). Defaults to today.

***

## Natural Language Examples

* *"Do I have a weekly check-in due today?"*
* *"Fill in my checkup: energy 8/10, slept 7 hours, weight 82.4 kg."*
* *"What did I answer on last week's checkup?"*

***

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

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": "client-checkups-1",
  "method": "tools/call",
  "params": {
    "name": "client_ai_submit_my_checkup",
    "arguments": {
      "settingId": "64b64c0f2f5f4c0012345678",
      "sectionAnswers": [
        {
          "sectionId": "64b64c0f2f5f4c0012345679",
          "answers": [
            {
              "questionId": "64b64c0f2f5f4c001234567a",
              "answer": "Felt strong this week, energy 8/10."
            }
          ]
        }
      ],
      "submittedFor": "2026-08-23"
    }
  }
}
```