simplepractice-mcp 0.4.1 → 1.0.0

package/dist/tools/account.js

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { minifiedResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { parseJsonString } from '../jsonapi.js';
 /**
@@ -14,7 +15,7 @@ export function registerAccountTools(server, client) {
     server.registerTool('simplepractice_get_account', {
         description: 'The practice, the signed-in client, and every client this login can see. One portal login is a "client access" and may cover more than one client — a parent seeing two children, say — so clients is always a list.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const { records } = await client.list('/environment', {
             include: 'currentPractice,currentClient,currentClientOptions,currentClientAccess',

package/dist/tools/appointments.js

@@ -25,7 +25,7 @@ export function registerAppointmentTools(server, client) {
     server.registerTool('simplepractice_list_appointments', {
         description: 'Appointments from the Client Portal. status "scheduled" returns confirmed/upcoming ones; "requested" returns those still awaiting the practice\'s confirmation. Pages by number.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {
+        inputSchema: z.object({
             status: z
                 .enum(['scheduled', 'requested'])
                 .default('scheduled')
@@ -33,7 +33,7 @@ export function registerAppointmentTools(server, client) {
             page: z.number().int().positive().default(1),
             pageSize: z.number().int().positive().max(PAGE_SIZE_MAX).default(PAGE_SIZE_MAX),
             view: viewArg(),
-        },
+        }),
     }, async ({ status, page, pageSize, view }) => {
         const { records } = await client.list('/appointments', {
             include: 'clinician,office,client',

package/dist/tools/auth.js

@@ -14,7 +14,7 @@ export function registerAuthTools(server, client) {
     server.registerTool('simplepractice_session_status', {
         description: 'Report whether this server holds a Client Portal session, for which practice, and how that practice was determined (from a sign-in link, from SIMPLEPRACTICE_PRACTICE, or remembered from the stored session). Reads local state only — makes no network call.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const host = client.knownPortalHost();
         const session = client.getSession();
@@ -35,7 +35,7 @@ export function registerAuthTools(server, client) {
     server.registerTool('simplepractice_request_sign_in_link', {
         description: 'Ask SimplePractice to email a sign-in link to a Client Portal address. The portal has no password — this is how you sign in. Sends a real email and is rate-limited per email address AND per IP, so it requires confirm:true. A success does not prove the address has an account: the API answers identically for unknown addresses by design.',
         annotations: toolAnnotations({ readOnly: false, idempotent: false }),
-        inputSchema: {
+        inputSchema: z.object({
             email: z.string().email().describe('The email address the Client Portal is registered to.'),
             practice: z
                 .string()
@@ -43,7 +43,7 @@ export function registerAuthTools(server, client) {
                 .optional()
                 .describe('The practice whose portal to sign in to — the slug ("achievebalancetherapy"), the host, or the portal URL. Only needed when this server does not know the practice yet; signing in with an emailed link teaches it, and it then remembers.'),
             confirm: schemaConfirm,
-        },
+        }),
     }, async ({ email, practice, confirm }) => {
         if (!confirm) {
             return minifiedResult({
@@ -75,24 +75,24 @@ export function registerAuthTools(server, client) {
     server.registerTool('simplepractice_verify_sign_in_token', {
         description: 'Exchange an emailed sign-in link (or the token in it) for a Client Portal session. Accepts the whole link or just the part after the "#". Prefer passing the WHOLE link: its address names the practice, so no practice has to be configured, and this server remembers it afterwards. Tokens are single-use and last 24 hours.',
         annotations: toolAnnotations({ readOnly: false, idempotent: false }),
-        inputSchema: {
+        inputSchema: z.object({
             link: z
                 .string()
                 .min(1)
                 .describe('The sign-in link from the email, or just the token after the "#".'),
-        },
+        }),
     }, async ({ link }) => minifiedResult(await verifySignInToken(client, link)));
     server.registerTool('simplepractice_verify_sign_in_pin', {
         description: 'Exchange a 6-digit Client Portal sign-in PIN for a session, for practices that email a code instead of a link. Single-use.',
         annotations: toolAnnotations({ readOnly: false, idempotent: false }),
-        inputSchema: {
+        inputSchema: z.object({
             email: z.string().email().describe('The address the PIN was sent to.'),
             pin: z.string().regex(/^\d{6}$/, 'The PIN is exactly 6 digits.'),
-        },
+        }),
     }, async ({ email, pin }) => minifiedResult(await verifySignInPin(client, email, pin)));
     server.registerTool('simplepractice_sign_out', {
         description: 'Discard the stored Client Portal session from local state.',
         annotations: toolAnnotations({ readOnly: false, idempotent: true }),
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => minifiedResult({ signedOut: client.clearSession() }));
 }

package/dist/tools/billing.js

@@ -34,7 +34,7 @@ export function registerBillingTools(server, client) {
     server.registerTool('simplepractice_list_billing_items', {
         description: 'Invoices, statements, superbills, receipts, or account history from the Client Portal. An empty list is a real answer — many practices bill entirely outside the portal. Pages by cursor: pass the returned nextCursor as "before".',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {
+        inputSchema: z.object({
             kind: z
                 .enum(['invoice', 'statement', 'superbill', 'receipt', 'account-history'])
                 .default('invoice'),
@@ -44,7 +44,7 @@ export function registerBillingTools(server, client) {
                 .describe('Cursor for the next page — the nextCursor from a previous call.'),
             pageSize: z.number().int().positive().max(PAGE_SIZE_MAX).default(PAGE_SIZE_MAX),
             view: viewArg(),
-        },
+        }),
     }, 
     // `view` is destructured off, never forwarded: `client.list` turns whatever
     // it is handed into a JSON:API query string, and a stray `view=compact`
@@ -74,7 +74,7 @@ export function registerBillingTools(server, client) {
     server.registerTool('simplepractice_get_billing_overview', {
         description: 'Balance due and per-category counts for the Client Portal account. Cheaper than paging the billing collections just to find out whether anything is there.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: { view: viewArg() },
+        inputSchema: z.object({ view: viewArg() }),
     }, async ({ view }) => {
         const overview = await loadClientRelationship(client, 'clientBillingOverview');
         // Also un-projected: the overview is whatever `clientBillingOverview`
@@ -86,7 +86,7 @@ export function registerBillingTools(server, client) {
     server.registerTool('simplepractice_list_payment_methods', {
         description: 'Payment methods saved to the Client Portal — brand, last four digits, and expiry. No full card numbers.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, 
     // No `view`: the response below IS a projection, hand-written down to five
     // fields with knowledge of what a card record holds. Running the blind rung

package/dist/tools/documents.js

@@ -9,7 +9,7 @@ export function registerDocumentTools(server, client) {
     server.registerTool('simplepractice_list_document_requests', {
         description: 'Paperwork the practice has sent — consents, questionnaires, contact and insurance forms, Good Faith Estimates, shared files. Use outstandingOnly to see just what still needs the client\'s attention.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {
+        inputSchema: z.object({
             outstandingOnly: z
                 .boolean()
                 .default(false)
@@ -19,7 +19,7 @@ export function registerDocumentTools(server, client) {
                 .boolean()
                 .default(false)
                 .describe('Include the full document body/questions. Off by default — these are long.'),
-        },
+        }),
     }, 
     // No `view`: `items` below is a hand-written projection, and `includeBody`
     // is a field the caller explicitly asked for. A blind rung run over that
@@ -61,10 +61,10 @@ export function registerDocumentTools(server, client) {
     server.registerTool('simplepractice_get_document_request', {
         description: 'One document request in full, including its body or its questions and the answers already given.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {
+        inputSchema: z.object({
             id: z.string().min(1).describe('The document request id.'),
             view: viewArg(),
-        },
+        }),
     }, 
     // `view` is destructured off rather than passed on: the id is the only part
     // of this input that may reach the request path.
@@ -86,9 +86,9 @@ export function registerDocumentTools(server, client) {
     server.registerTool('simplepractice_list_documents', {
         description: 'Files the practice has shared through the Client Portal.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {
+        inputSchema: z.object({
             pageSize: z.number().int().positive().max(PAGE_SIZE_MAX).default(PAGE_SIZE_MAX),
-        },
+        }),
     }, 
     // No `view`, and this one is the exception worth stating: the PRODUCT of
     // this tool is the file references themselves. A practice that shares a
@@ -102,10 +102,10 @@ export function registerDocumentTools(server, client) {
     server.registerTool('simplepractice_list_announcements', {
         description: 'Announcements the practice has posted to the Client Portal. readAt is null on unread ones.',
         annotations: toolAnnotations({ readOnly: true }),
-        inputSchema: {
+        inputSchema: z.object({
             pageSize: z.number().int().positive().max(PAGE_SIZE_MAX).default(PAGE_SIZE_MAX),
             view: viewArg(),
-        },
+        }),
     }, async ({ pageSize, view }) => {
         const { records } = await client.list('/announcements', { page: { size: pageSize } });
         // Verbatim upstream records again. An announcement is text the practice

package/dist/version.js

@@ -2,4 +2,4 @@
  * Single source of truth for the server version. release-please rewrites the
  * literal below; every other file imports VERSION rather than repeating it.
  */
-export const VERSION = '0.4.1'; // x-release-please-version
+export const VERSION = '1.0.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simplepractice-mcp",
-  "version": "0.4.1",
+  "version": "1.0.0",
   "license": "MIT",
   "mcpName": "io.github.chrischall/simplepractice-mcp",
   "description": "SimplePractice Client Portal MCP server for Claude — developed and maintained by AI (Claude Code)",
@@ -26,7 +26,7 @@
   ],
   "scripts": {
     "build": "tsc && npm run bundle",
-    "bundle": "esbuild src/index.ts --bundle --platform=node --format=esm --external:dotenv --banner:js='import { createRequire as __createRequire } from \"module\"; const require = __createRequire(import.meta.url);' --outfile=dist/bundle.js",
+    "bundle": "esbuild src/index.ts --bundle --alias:zod/v4=./node_modules/zod/v4/index.cjs --platform=node --format=esm --external:dotenv --banner:js='import { createRequire as __createRequire } from \"module\"; const require = __createRequire(import.meta.url);' --outfile=dist/bundle.js",
     "dev": "node --env-file=.env dist/index.js",
     "typecheck": "tsc --noEmit",
     "test": "npm run typecheck && vitest run",
@@ -34,17 +34,18 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.23.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@chrischall/mcp-utils": "^0.28.0",
+    "@modelcontextprotocol/server": "^2.0.0",
     "dotenv": "^17.4.2",
-    "zod": "^4.4.3"
+    "zod": "^4.6.2"
   },
   "devDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
     "@types/node": "^26.0.0",
-    "@vitest/coverage-v8": "^4.1.7",
+    "@vitest/coverage-v8": "^5.0.0",
     "esbuild": "^0.28.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.7",
+    "vitest": "^5.0.0",
     "yaml": "^2.9.0"
   }
 }

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/simplepractice-mcp",
     "source": "github"
   },
-  "version": "0.4.1",
+  "version": "1.0.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "simplepractice-mcp",
-      "version": "0.4.1",
+      "version": "1.0.0",
       "transport": {
         "type": "stdio"
       },