PT Distinction MCP server Let your AI agent do the PT Distinction admin.

ToolWhat it doesAccess

• list_clients Clients, searchable by name or email, with group, package and last activity. read

  Returns clients with ID, groups, package, current program and the last day they logged anything.

  MCP callpt_distinction_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/pt-distinction/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  query string	string	Name or email.
  group string	string	Only this group.
  inactive_days integer	integer	Only clients with nothing logged in this many days.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "clients": [
      {
        "client_id": "C-50211",
        "name": "Emma Whitfield",
        "groups": [
          "12-week transformation"
        ],
        "program": "Strength phase 2",
        "last_activity": "2026-11-07"
      }
    ],
    "page": 1
  }

• get_client One client with program, schedule, forms and progress. read

  Returns the client: program and this week's schedule, completed workouts, latest weight and habits, and forms still waiting.

  MCP callpt_distinction_read → get_client

  REST endpointGET https://cotlet.dev/api/v1/pt-distinction/clients/{client_id}

  Parameters

  Parameters: get_client

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

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "C-50211",
    "name": "Emma Whitfield",
    "program": "Strength phase 2",
    "done_this_week": 2,
    "planned_this_week": 4,
    "latest_weight_kg": 66.8,
    "forms_pending": [
      "Weekly check-in"
    ]
  }

• add_client Adds a client and sends their welcome email. writeasks first

  Creates the client the way Clients > Add Client does; PT Distinction emails their app login. By default you confirm each call; you can switch that off for this tool.

  MCP callpt_distinction_write → add_client

  REST endpointPOST https://cotlet.dev/api/v1/pt-distinction/clients

  Parameters

  Parameters: add_client

  Name	Type	Description
  first_name string required	string	First name.
  last_name string required	string	Last name.
  email string required	string	Email for the welcome message.
  group string	string	Group to add them to.

  Example input

  {
    "first_name": "first name",
    "last_name": "last name",
    "email": "jane@example.com"
  }

  Example response

  {
    "client_id": "C-50388",
    "name": "Jack Hargreaves",
    "status": "Invited"
  }

• add_to_group Puts a client into a group, with its content. writeasks first

  Adds the client to the group, so the group's schedule and messages reach them in their app. By default you confirm each call; you can switch that off for this tool.

  MCP callpt_distinction_write → add_to_group

  REST endpointPOST https://cotlet.dev/api/v1/pt-distinction/clients/{client_id}/groups

  Parameters

  Parameters: add_to_group

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  group string required	string	Group name.

  Example input

  {
    "client_id": "client_8c41d2",
    "group": "group"
  }

  Example response

  {
    "client_id": "C-50388",
    "group": "12-week transformation",
    "status": "Added"
  }

ToolWhat it doesAccess

• list_library Programs, forms and habits in your library. read

  Returns library items by type and name, so the agent assigns the exact one.

  MCP callpt_distinction_read → list_library

  REST endpointGET https://cotlet.dev/api/v1/pt-distinction/libraries

  Parameters

  Parameters: list_library

  Name	Type	Description
  type string	string	Program, Form, Habit.
  query string	string	Name contains.

  Example response

  {
    "items": [
      {
        "type": "Program",
        "name": "Fat loss 8 weeks"
      },
      {
        "type": "Form",
        "name": "PAR-Q"
      }
    ]
  }

• assign_program Copies a library program to a client from a start date. writeasks first

  Adds the program to the client's schedule; they see it in their app. By default you confirm each call; you can switch that off for this tool.

  MCP callpt_distinction_write → assign_program

  REST endpointPOST https://cotlet.dev/api/v1/pt-distinction/clients/{client_id}/program/assign

  Parameters

  Parameters: assign_program

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  program string required	string	Program name from the library.
  start string required	string	ISO start date.

  Example input

  {
    "client_id": "C-50388",
    "program": "Fat loss 8 weeks",
    "start": "2026-11-16"
  }

  Example response

  {
    "client_id": "C-50388",
    "program": "Fat loss 8 weeks",
    "start": "2026-11-16"
  }

• send_form Assigns a form or questionnaire to a client. writeasks first

  Puts the form, for example a PAR-Q or weekly check-in, in the client's app to fill in. By default you confirm each call; you can switch that off for this tool.

  MCP callpt_distinction_write → send_form

  REST endpointPOST https://cotlet.dev/api/v1/pt-distinction/clients/{client_id}/forms

  Parameters

  Parameters: send_form

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  form string required	string	Form name from the library.

  Example input

  {
    "client_id": "client_8c41d2",
    "form": "form"
  }

  Example response

  {
    "client_id": "C-50388",
    "form": "PAR-Q",
    "status": "Sent"
  }

• get_form_answers A client's answers to a form. read

  Returns the latest answers to the form, question by question.

  MCP callpt_distinction_read → get_form_answers

  REST endpointGET https://cotlet.dev/api/v1/pt-distinction/clients/{client_id}/form-answers

  Parameters

  Parameters: get_form_answers

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  form string required	string	Form name.

  Example input

  {
    "client_id": "client_8c41d2",
    "form": "form"
  }

  Example response

  {
    "client_id": "C-50211",
    "form": "Weekly check-in",
    "submitted": "2026-11-08",
    "answers": [
      {
        "q": "Energy 1-10",
        "a": "7"
      },
      {
        "q": "Sleep hours",
        "a": "6.5"
      }
    ]
  }