Kahunas MCP server Let your AI agent do the Kahunas admin.

ToolWhat it doesAccess

• list_clients Clients with package, check-in status and last activity. read

  Returns clients with ID, package, next check-in date and whether the last one is missing.

  MCP callkahunas_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/kahunas/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  query string	string	Name or email.
  missed_checkin boolean	boolean	Only clients who missed their last check-in.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "clients": [
      {
        "client_id": "K-30121",
        "name": "Sam Rivera",
        "package": "12-week transformation",
        "next_checkin": "2026-11-11",
        "missed_last": false
      }
    ],
    "page": 1
  }

• list_checkins Submitted check-ins for a date range, with answers and metrics. read

  Returns check-ins with client, date, weight and other metrics, and the answers to your form.

  MCP callkahunas_read → list_checkins

  REST endpointGET https://cotlet.dev/api/v1/kahunas/checkins

  Parameters

  Parameters: list_checkins

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string	string	ISO date.

  Example input

  {
    "date_from": "2026-11-03",
    "date_to": "2026-11-09"
  }

  Example response

  {
    "checkins": [
      {
        "client": "Jess Taylor",
        "date": "2026-11-08",
        "weight_kg": 64.1,
        "answers": [
          {
            "q": "Energy 1-10",
            "a": "5"
          },
          {
            "q": "Adherence %",
            "a": "70"
          }
        ]
      }
    ]
  }

ToolWhat it doesAccess

• add_client Adds a client to a package and sends the invite. writeasks first

  Creates the client on the package with start date and check-in schedule; Kahunas sends the app invite. By default you confirm each call; you can switch that off for this tool.

  MCP callkahunas_write → add_client

  REST endpointPOST https://cotlet.dev/api/v1/kahunas/clients

  Parameters

  Parameters: add_client

  Name	Type	Description
  name string required	string	Full name.
  email string required	string	Email for the invite.
  package string required	string	Package name.
  start string	string	ISO start date.

  Example input

  {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "package": "package"
  }

  Example response

  {
    "client_id": "K-30188",
    "name": "Maya Ortiz",
    "package": "12-week transformation",
    "status": "Invited"
  }

• assign_workout_plan Assigns a workout or nutrition plan from your library. writeasks first

  Puts the plan on the client; they see it in their app. By default you confirm each call; you can switch that off for this tool.

  MCP callkahunas_write → assign_workout_plan

  REST endpointPOST https://cotlet.dev/api/v1/kahunas/clients/{client_id}/workout-plan/assign

  Parameters

  Parameters: assign_workout_plan

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  plan string required	string	Plan name from your library.
  type string	string	workout or nutrition. Default: workout.

  Example input

  {
    "client_id": "client_8c41d2",
    "plan": "plan"
  }

  Example response

  {
    "client_id": "K-30188",
    "plan": "Upper/Lower 4-day",
    "type": "workout"
  }

• send_message Sends a chat message to a client. writeasks first

  Posts the message in the client's Kahunas chat. By default you confirm each call; you can switch that off for this tool.

  MCP callkahunas_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/kahunas/clients/{client_id}/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  text string required	string	Message.

  Example input

  {
    "client_id": "client_8c41d2",
    "text": "text"
  }

  Example response

  {
    "client_id": "K-30121",
    "sent": true
  }