@sodiumhq/mcp-pm 0.1.0-beta.2771 → 0.1.0-beta.2772

package/dist/index.js

@@ -2971,6 +2971,49 @@ async function handleCreateClient(api, args) {
 	}
 }
 //#endregion
+//#region ../mcp-core/src/tools/get-contact.ts
+const GetContactInputSchema = { contactCode: z.string().min(1, "Contact code is required").describe("The contact code (identifier). Discoverable via list_contacts or the contacts section of get_client_summary.") };
+async function handleGetContact(api, args) {
+	try {
+		const c = await api.getContact(args.contactCode);
+		const lines = [];
+		const name = [
+			c.title,
+			c.firstName,
+			c.middleName,
+			c.lastName
+		].filter(Boolean).join(" ") || "(no name)";
+		lines.push(`Contact: ${name} (${c.code ?? args.contactCode})`);
+		if (c.email) lines.push(`Email: ${c.email}`);
+		if (c.phone) lines.push(`Phone: ${c.phone}`);
+		if (c.mobile) lines.push(`Mobile: ${c.mobile}`);
+		if (c.address) lines.push(`Address: ${c.address}`);
+		if (c.dateOfBirth) lines.push(`Date of birth: ${c.dateOfBirth}`);
+		if (c.nationality) lines.push(`Nationality: ${c.nationality}`);
+		if (c.maritalStatus) lines.push(`Marital status: ${c.maritalStatus}`);
+		if (c.utr) lines.push(`UTR: ${c.utr}`);
+		if (c.niNumber) lines.push(`NI number: ${c.niNumber}`);
+		if (c.personalCode) lines.push(`Companies House person code: ${c.personalCode}`);
+		if (c.isDeceased) lines.push(`Deceased: yes${c.deceasedDate ? ` (${c.deceasedDate})` : ""}`);
+		if (c.clientCount !== void 0) lines.push(`Linked to ${c.clientCount} client(s)`);
+		if (c.client) lines.push(`Primary client: ${c.client.name} (${c.client.code})`);
+		if (c.individualClient) lines.push(`Individual client record: ${c.individualClient.name} (${c.individualClient.code})`);
+		if (c.portalUser) lines.push(`Portal user: ${c.portalUser.name} (${c.portalUser.code})`);
+		return { content: [{
+			type: "text",
+			text: lines.join("\n")
+		}] };
+	} catch (error) {
+		return {
+			content: [{
+				type: "text",
+				text: error instanceof SodiumApiError ? `Error getting contact: ${error.message} (correlation: ${error.correlationId})` : `Error getting contact: ${error instanceof Error ? error.message : String(error)}`
+			}],
+			isError: true
+		};
+	}
+}
+//#endregion
 //#region ../mcp-core/src/tools/list-client-notes.ts
 const sortFieldEnum$1 = z.enum(["Date", "UpdatedDate"]);
 const ListClientNotesInputSchema = {
@@ -3350,6 +3393,16 @@ async function buildServer(config) {
 			openWorldHint: true
 		}
 	}, (args) => handleListContacts(api, args));
+	server.registerTool("get_contact", {
+		title: "Get full details of a contact",
+		description: "Get all fields for a single contact by code: name, title, email, phone, mobile, address, date of birth, nationality, marital status, UTR, NI number, Companies House person code, deceased status, linked clients, and portal user. Use after list_contacts identifies the contact of interest, or when the user asks for details about a specific contact. Also useful before update_contact to see current values.",
+		inputSchema: GetContactInputSchema,
+		annotations: {
+			readOnlyHint: true,
+			idempotentHint: true,
+			openWorldHint: true
+		}
+	}, (args) => handleGetContact(api, args));
 	registerWriteTool(server, config.context, "add_task_note", {
 		title: "Add a note to a task",
 		description: "Create a new note on a task. Additive — does not modify or delete existing notes. The note is attributed to the authenticated API user (the current practice member) and timestamped to 'now'. Use this when the user asks you to capture something on a task: 'add a note on the Greggs year-end task that we're waiting on the rental schedule', 'log on the task that I called John today and got voicemail'. Notes can be pinned; only pin when the user explicitly asks for it. The user can always edit or delete notes in the Sodium UI if the wording isn't right.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sodiumhq/mcp-pm",
-  "version": "0.1.0-beta.2771",
+  "version": "0.1.0-beta.2772",
   "description": "Sodium Practice Management MCP server — lets AI assistants interact with your Sodium tenant",
   "type": "module",
   "bin": {