Portrait Care MCP server Let your AI agent run the Portrait schedule.

ToolWhat it doesAccess

• list_appointments Appointments for a day or range, by provider. read

  Returns appointments with patient name, service, provider, start time and status from the schedule.

  MCP callportrait_care_read → list_appointments

  REST endpointGET https://cotlet.dev/api/v1/portrait-care/appointments

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string	string	ISO date. Default: date_from.
  provider string	string	Provider name.
  page integer	integer	Page number. Default: 1.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "AP-50812",
        "patient": "Jessica Moreno",
        "service": "Neurotoxin",
        "provider": "Dr. Patel",
        "start": "2026-11-12T11:00",
        "status": "Booked"
      }
    ],
    "page": 1
  }

• find_free_slots Open times for a service, optionally with one provider. read

  Reads the schedule and returns start times where the service fits.

  MCP callportrait_care_read → find_free_slots

  REST endpointGET https://cotlet.dev/api/v1/portrait-care/free-slots/find

  Parameters

  Parameters: find_free_slots

  Name	Type	Description
  service string required	string	Service name.
  date string required	string	ISO date.
  provider string	string	Provider name.

  Example input

  {
    "service": "service",
    "date": "date"
  }

  Example response

  {
    "service": "Dermal filler consult",
    "slots": [
      {
        "provider": "Dr. Patel",
        "start": "2026-11-13T14:30"
      }
    ]
  }

• book_appointment Books a service for a patient with a provider. writeasks first

  Creates the appointment on the schedule. Portrait sends its usual confirmation and intake forms by your settings. By default you confirm each call; you can switch that off for this tool.

  MCP callportrait_care_write → book_appointment

  REST endpointPOST https://cotlet.dev/api/v1/portrait-care/patients/{patient_id}/appointments

  Parameters

  Parameters: book_appointment

  Name	Type	Description
  patient_id string required	string	Patient ID from list_patients.
  service string required	string	Service name.
  provider string required	string	Provider name.
  start string required	string	ISO date and time.

  Example input

  {
    "patient_id": "PT-7790",
    "service": "Dermal filler consult",
    "provider": "Dr. Patel",
    "start": "2026-11-13T14:30"
  }

  Example response

  {
    "appointment_id": "AP-50877",
    "patient": "Emily Carter",
    "service": "Dermal filler consult",
    "provider": "Dr. Patel",
    "start": "2026-11-13T14:30",
    "status": "Booked"
  }

• reschedule_appointment Moves an appointment to a new time or provider. writeasks first

  Moves the appointment on the schedule; your settings decide what the patient hears. By default you confirm each call; you can switch that off for this tool.

  MCP callportrait_care_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/portrait-care/appointments/{appointment_id}/reschedule

  Parameters

  Parameters: reschedule_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.
  start string required	string	New ISO date and time.
  provider string	string	New provider. Default: unchanged.

  Example input

  {
    "appointment_id": "appointment_8c41d2",
    "start": "start"
  }

  Example response

  {
    "appointment_id": "AP-50812",
    "start": "2026-11-14T10:00",
    "provider": "Dr. Patel",
    "status": "Booked"
  }

ToolWhat it doesAccess

• list_patients Patients, searchable by name, phone or email, with last visit. read

  Returns patient contact details, last visit and last service. No charts or clinical notes.

  MCP callportrait_care_read → list_patients

  REST endpointGET https://cotlet.dev/api/v1/portrait-care/patients

  Parameters

  Parameters: list_patients

  Name	Type	Description
  query string	string	Name, phone or email.
  not_visited_days integer	integer	Only patients with no visit in this many days.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "patients": [
      {
        "patient_id": "PT-7712",
        "name": "Danielle Brooks",
        "phone": "(512) 555-0188",
        "last_visit": "2026-06-18",
        "last_service": "Neurotoxin"
      }
    ],
    "page": 1
  }