Skip to main content
The intake module provides access to onboarding questionnaires and daily summaries of dietary/lifestyle logs.

Available Tools

get_client_intake_form

Retrieve the client’s submitted intake responses and onboarding answers. Returns the latest submitted intake for the accessible client in the connected company. An unsubmitted questionnaire is not an intake response. If no submission exists, COMPANY_MCP_INTAKE_NOT_FOUND includes a reason distinguishing a missing company intake form from a client who has not submitted one. This read never creates or changes a questionnaire.
  • Type: Read-only
  • Important Input Fields:
    • clientId (string, required): Unique identifier for the client.

get_client_intake_assignments

Check for one or more clients whether an intake form is currently assigned and how far each client got. Returns one row per requested client, in request order. Each row also contains formId, formName, assignedAt (ISO 8601), accessEnabled (whether the client can open the form) and submittedAt. Fields are null when not applicable. If any clientId is not an accessible client of the connected company, the whole call fails with COMPANY_MCP_CLIENT_NOT_FOUND.
  • Type: Read-only
  • Important Input Fields:
    • clientIds (string[], required): 1-50 client IDs.

list_intake_submissions

Read submitted intake forms of many members at once, newest first. Each item contains clientId, clientName and the same submission fields as get_client_intake_form. Members that are removed, rejected, blocked or erased are left out. Not available to client-bound connections.
  • Type: Read-only
  • Important Input Fields:
    • dateFrom / dateTo (string, required): Submission date range, max 366 days.
    • clientIds (string[], optional): Up to 50 client IDs.
    • questionContains (string, optional): Only return answers whose question contains this text (case-insensitive).
    • page / limit (integer, optional): Paging; up to 25 submissions per page. Continue while hasMore is true.

get_client_daily_intake

Retrieve daily logged totals (such as total calories, protein, carbs, fat, and water intake).
  • Type: Read-only
  • Important Input Fields:
    • clientId (string, required): Unique client ID.
    • date (string, required): Target date in YYYY-MM-DD format.

assign_client_form Write

Assign one company intake form to a member, replacing their current form like the dashboard. Use a formId from get_client_intake_assignments or list_checkup_forms. sendEmail (default false here) emails the member a link. Get explicit coach confirmation first.
  • Type: Write (requires userConfirmed: true and the write-tool grant)
  • Input Fields:
    • clientId (string, required)
    • formId (string, required)
    • sendEmail (boolean, optional)
    • idempotencyKey (string, optional)

Natural Language Examples

  • “Show me the onboarding questionnaire answers for Sarah Jenkins.”
  • “Which of tomorrow’s trial session prospects have not submitted their intake form yet?”
  • “What was client client_123’s total calorie and protein intake yesterday?”

JSON-RPC Call Example (get_client_daily_intake)