Practice Better MCP by usefulapi

The practitioner (API user) behind this connection: id, name, title, timezone, default currency, role flags and the practice (company) id and name. Settings, integrations and the bio are not returned. GET /consultant/profile.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the practitioners and admin users of the practice, with id, name, role flags and activation status. Use the ids to filter sessions and invoices. GET /company/administration/members.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List client records, newest first: id, status, name, email, phone, timezone and activity dates. Date of birth, address, insurance and notes are not returned. A page holds at most 100 records. To look up one person by name or email use practice_better_find_clients. GET /consultant/records.

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Only these statuses. pendingcreate = prospective client, created = added client.",
      "minItems": 1,
      "maxItems": 2,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "pendingcreate",
          "created"
        ]
      }
    },
    "has_account": {
      "description": "true = only clients with an active Practice Better user account.",
      "type": "boolean"
    },
    "child_records": {
      "description": "true = only sub-records (dependants), false = only primary records.",
      "type": "boolean"
    },
    "modified_after": {
      "type": "string",
      "description": "ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z."
    },
    "modified_before": {
      "type": "string",
      "description": "ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z."
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search client records by name, preferred name or email (case-insensitive text match). Practice Better has no search endpoint, so this reads the 500 most recent records (5 pages of 100) and filters them; `complete` says whether every record was checked. Returns at most `max_results` matches with the same fields as practice_better_list_clients. GET /consultant/records.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Text to look for in first name, last name, preferred name or email."
    },
    "status": {
      "description": "Only these statuses.",
      "minItems": 1,
      "maxItems": 2,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "pendingcreate",
          "created"
        ]
      }
    },
    "max_results": {
      "description": "Most matches to return, 1-50 (default 10).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One client record by id: status, name, preferred name, pronouns, email, phones, timezone, activity dates and tag ids. Date of birth, address, insurance, emergency contacts, notes and health history are not returned. GET /consultant/records/{recordId}.

{
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Client record id."
    }
  },
  "required": [
    "record_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List sessions (appointments), newest first: date, duration, service, practitioner, client (id and name), status and payment status. Booking notes and session notes are not returned. Filter by date range, practitioner, client record, service or group/1-1. GET /consultant/sessions.

{
  "type": "object",
  "properties": {
    "date_after": {
      "description": "Sessions on or after this date-time (ISO 8601 with timezone).",
      "type": "string"
    },
    "date_before": {
      "description": "Sessions on or before this date-time (ISO 8601 with timezone).",
      "type": "string"
    },
    "practitioner_ids": {
      "description": "Only sessions of these practitioners (ids from practice_better_list_practitioners).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Practice Better id."
      }
    },
    "record_ids": {
      "description": "Only sessions of these client records.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Practice Better id."
      }
    },
    "service_ids": {
      "description": "Only sessions of these services (ids from practice_better_list_services).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Practice Better id."
      }
    },
    "group": {
      "description": "true = only group sessions, false = only 1-1 sessions.",
      "type": "boolean"
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One session (appointment) by id: date, duration, service, practitioner, client (id and name), location and status. Booking notes and session notes are not returned. For a group session pass record_id to see one client's view. GET /consultant/sessions/{sessionId}.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Session id."
    },
    "record_id": {
      "description": "Group sessions only: the client record id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "session_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Open booking slots of one practitioner for one service, starting on the given day: start, end and duration of each slot. It follows the practitioner's booking settings. Needs a practitioner id and a service id. GET /consultant/availability/slots.

{
  "type": "object",
  "properties": {
    "practitioner_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Practitioner id (practice_better_list_practitioners)."
    },
    "service_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Service id (practice_better_list_services)."
    },
    "day": {
      "type": "string",
      "description": "The day to start from, ISO 8601 date-time with timezone, e.g. 2026-10-12T00:00:00Z."
    },
    "type": {
      "description": "Session type: face (in person), phone or virtual.",
      "type": "string",
      "enum": [
        "face",
        "phone",
        "virtual"
      ]
    },
    "location_id": {
      "description": "Only slots at this location.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "package_id": {
      "description": "Only slots usable with this client package.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "practitioner_id",
    "service_id",
    "day"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the services (appointment types) the practice offers: id, name, duration, group or 1-1, session types and SKU. GET /consultant/services.

{
  "type": "object",
  "properties": {
    "team_for": {
      "description": "Whose items: self (default), all (all team members) or other (team members except you).",
      "type": "string",
      "enum": [
        "self",
        "all",
        "other"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the package definitions (bundles of sessions or programs) the practice sells: id, name and SKU. GET /consultant/packages.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the tags the practice uses to organize clients: id and name. A client record carries tag ids. GET /tags.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List client invoices, newest first: number, date, totals, amount due and paid, payment status, client (id and name) and practitioner. Payment history and line items are not in the list; use practice_better_get_invoice. GET /consultant/payments/invoices.

{
  "type": "object",
  "properties": {
    "payment_status": {
      "description": "Only invoices with these payment statuses.",
      "minItems": 1,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "unpaid",
          "partial",
          "paid"
        ]
      }
    },
    "invoice_date_after": {
      "description": "Invoice date on or after this date-time.",
      "type": "string"
    },
    "invoice_date_before": {
      "description": "Invoice date on or before this date-time.",
      "type": "string"
    },
    "practitioner_ids": {
      "description": "Only invoices of these practitioners.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Practice Better id."
      }
    },
    "record_ids": {
      "description": "Only invoices of these client records.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Practice Better id."
      }
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One invoice by id with its line items (date, quantity, amount, tax) and totals. Descriptions, payment history and billing contact are not returned. GET /consultant/payments/invoices/{invoiceId}.

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Invoice id."
    }
  },
  "required": [
    "invoice_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the form templates of the practice (intake forms, questionnaires, consent forms): id and name only. GET /consultant/forms.

{
  "type": "object",
  "properties": {
    "team_for": {
      "description": "Whose items: self (default), all (all team members) or other (team members except you).",
      "type": "string",
      "enum": [
        "self",
        "all",
        "other"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List forms sent to clients, newest first: which form, which client (id), practitioner, and whether it was started or completed, with dates. The answers are never returned. GET /consultant/formrequests.

{
  "type": "object",
  "properties": {
    "completed": {
      "description": "true = only completed requests, false = only incomplete ones.",
      "type": "boolean"
    },
    "created_after": {
      "description": "Created on or after this date-time.",
      "type": "string"
    },
    "created_before": {
      "description": "Created on or before this date-time.",
      "type": "string"
    },
    "practitioner_ids": {
      "description": "Only requests of these practitioners.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Practice Better id."
      }
    },
    "record_ids": {
      "description": "Only requests for these client records.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Practice Better id."
      }
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before_id": {
      "description": "Cursor: pass next_page.before_id of the previous reply to get the next page (lists are newest first).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "after_id": {
      "description": "Cursor for lists in ascending order: return items after this id. Normally use before_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}