Skip to main content
The client_ai_messages module lets a client’s AI assistant list the client’s chats, read message history, and send text messages to coaches within the company. Client AI tools are subject-bound: every call resolves to the authenticated client (subjectClientId); only chats the client participates in are readable, and messages can be sent exclusively to coaches within the client’s company. 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 private communication consent.

Available Tools

client_ai_list_my_chats

Retrieve all chats where you are a participant. Chats are sorted by most recent activity.
  • Type: Read-only
  • Important Input Fields:
    • page (integer, optional): Page number for pagination.
    • limit (integer, optional): Number of chats per page, max 50.

client_ai_get_my_messages

Retrieve the message history of a chat that you belong to, sorted by most recent message first.
  • Type: Read-only
  • Important Input Fields:
    • chatId (string, required): The unique ID of the chat.
    • page (integer, optional): Page number for pagination.
    • limit (integer, optional): Number of messages to load, max 100.

client_ai_send_message_to_my_coach Write

Send a text message to your coach in this company. Restricts communication exclusively to coaches within your company.
  • Type: Write
  • Important Input Fields:
    • coachId (string, required): The unique ID of the coach.
    • message (string, required): The text message content to send. Max 2000 chars.

Natural Language Examples

  • “Did my coach reply to my question about deload week?”
  • “Message my coach that I’ll be 10 minutes late tomorrow.”
  • “Summarize my chat with my coach from this week.”

JSON-RPC Call Example (client_ai_send_message_to_my_coach)