Skip to main content
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.

​
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)