@sodiumhq/mcp-pm 0.1.0-beta.2599 → 0.1.0-beta.2603

package/README.md

@@ -66,6 +66,10 @@ Then ask: *"give me a summary of my practice"*.
 - **`list_proposals`** and **`list_engagement_letters`** — aliased tools for the same underlying engagement pipeline (pre-acceptance vs signed). Filter by status, client, date range.
 - **`get_proposal_summary`** and **`get_engagement_letter_summary`** — aliased drill-ins: identity + client + value breakdown + services with pricing + PDFs + email history + acceptance record
 
+**Services**
+- **`list_services`** — find and count services in the practice's catalogue by search, category, applicable client type, or archived status. Answers "what do we offer?", "list our tax services", "what do we offer limited companies?", "how many active services do we have?"
+- **`get_service_details`** — drill into one service: identity + applicable client types + HMRC agent authorisations + pricing options per billing frequency + custom tiers + professional clearance items + pricing-factor overview. Enables service-audit workflows like "is Self Assessment correctly restricted to Individual clients?"
+
 **Team**
 - **`list_users`** — find team members by name, email, role, or status — supports "who is Jane?", "list all partners", "who has been invited but not joined?"
 

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { randomUUID } from "node:crypto";
@@ -786,6 +787,38 @@ const getPracticeDetails = (options) => (options.client ?? client).get({
 	...options
 });
 /**
+* List BillableServices
+*
+* Lists all BillableServices for the given tenant.
+*/
+const listBillableServices = (options) => (options.client ?? client).get({
+	security: [{
+		name: "x-api-key",
+		type: "apiKey"
+	}, {
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/tenants/{tenant}/services",
+	...options
+});
+/**
+* Get BillableService
+*
+* Gets a BillableService for the specified tenant.
+*/
+const getBillableService = (options) => (options.client ?? client).get({
+	security: [{
+		name: "x-api-key",
+		type: "apiKey"
+	}, {
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/tenants/{tenant}/services/{code}",
+	...options
+});
+/**
 * List Notes for Task
 *
 * Lists notes for the specified task. By default only returns task-level notes. Set includeStepNotes=true to also include notes attached to workflow steps.
@@ -952,14 +985,32 @@ var SodiumApiError = class extends Error {
 		this.name = "SodiumApiError";
 	}
 };
+function sanitizeToken(value) {
+	return value.replace(/[\s()\/]+/g, "-").replace(/[^\w.\-]/g, "") || "unknown";
+}
 var SodiumApiClient = class {
-	constructor(ctx) {
+	serverVersion;
+	mcpClient = null;
+	constructor(ctx, options) {
 		this.ctx = ctx;
+		this.serverVersion = options.serverVersion;
 		client.setConfig({
 			baseUrl: ctx.baseUrl,
-			headers: { "x-api-key": ctx.apiKey }
+			headers: {
+				"x-api-key": ctx.apiKey,
+				"User-Agent": this.buildUserAgent()
+			}
 		});
 	}
+	setMcpClientInfo(info) {
+		this.mcpClient = info;
+		client.setConfig({ headers: { "User-Agent": this.buildUserAgent() } });
+	}
+	buildUserAgent() {
+		const base = `sodiumhq-mcp-pm/${this.serverVersion}`;
+		if (!this.mcpClient) return base;
+		return `${base} (client=${sanitizeToken(this.mcpClient.name)}/${sanitizeToken(this.mcpClient.version)})`;
+	}
 	async getPracticeDetails() {
 		const correlationId = randomUUID();
 		const { data, error, response } = await getPracticeDetails({
@@ -1080,6 +1131,32 @@ var SodiumApiClient = class {
 		if (error !== void 0 || !data) throw this.toError(response, error, correlationId, "list users");
 		return data;
 	}
+	async listServices(query = {}) {
+		const correlationId = randomUUID();
+		const { data, error, response } = await listBillableServices({
+			path: { tenant: this.ctx.tenant },
+			query: {
+				...query,
+				limit: query.limit ?? 10,
+				offset: query.offset ?? 0
+			},
+			headers: { "X-Correlation-Id": correlationId }
+		});
+		if (error !== void 0 || !data) throw this.toError(response, error, correlationId, "list services");
+		return data;
+	}
+	async getService(code) {
+		const correlationId = randomUUID();
+		const { data, error, response } = await getBillableService({
+			path: {
+				tenant: this.ctx.tenant,
+				code
+			},
+			headers: { "X-Correlation-Id": correlationId }
+		});
+		if (error !== void 0 || !data) throw this.toError(response, error, correlationId, `get service ${code}`);
+		return data;
+	}
 	async listTasks(query = {}) {
 		const correlationId = randomUUID();
 		const { data, error, response } = await listTaskItems({
@@ -1236,7 +1313,7 @@ async function buildInstructions(api) {
 }
 //#endregion
 //#region ../mcp-core/src/tools/get-practice-details.ts
-function format$3(tenant, practice) {
+function format$4(tenant, practice) {
 	const lines = [];
 	lines.push(`Practice: ${practice.name}`);
 	lines.push(`Tenant: ${tenant.name} (${tenant.code})`);
@@ -1270,7 +1347,7 @@ async function handleGetPracticeDetails(api) {
 		const [tenant, practice] = await Promise.all([api.getTenantDetails(), api.getPracticeDetails()]);
 		return { content: [{
 			type: "text",
-			text: format$3(tenant, practice)
+			text: format$4(tenant, practice)
 		}] };
 	} catch (error) {
 		return {
@@ -1300,7 +1377,7 @@ const typeEnum = z.enum([
 	"Charity",
 	"SoleTrader"
 ]);
-const sortByEnum$2 = z.enum(["Name", "InternalReference"]);
+const sortByEnum$3 = z.enum(["Name", "InternalReference"]);
 const ListClientsInputSchema = {
 	search: z.string().min(3, "Search must be at least 3 characters when provided").optional().describe("Free-text search across client code, name, and internal reference. Minimum 3 characters. Omit to browse by filter only."),
 	status: z.array(statusEnum$2).optional().describe("Filter by client status. Defaults to all statuses if omitted. Example: ['Active'] for active clients only."),
@@ -1310,7 +1387,7 @@ const ListClientsInputSchema = {
 	associateCode: z.array(z.string()).optional().describe("Filter by assigned associate user codes."),
 	serviceCode: z.array(z.string()).optional().describe("Filter by billable service codes that clients have assigned."),
 	savedFilter: z.string().optional().describe("Code of a user-saved filter to apply. Other filter parameters override fields from the saved filter."),
-	sortBy: sortByEnum$2.optional().describe("Field to sort by. Defaults to Name."),
+	sortBy: sortByEnum$3.optional().describe("Field to sort by. Defaults to Name."),
 	sortDesc: z.boolean().optional().describe("Sort in descending order. Defaults to ascending."),
 	limit: z.number().int().min(0).max(50).optional().describe("Maximum number of clients to return per page. Default 10, max 50. Pass 0 to return only the total count without any client data — use this for 'how many X?' questions so the API doesn't fetch a full page just to be counted."),
 	offset: z.number().int().min(0).optional().describe("Number of records to skip for pagination. Default 0.")
@@ -1328,20 +1405,20 @@ async function handleListClients(api, args) {
 		const items = result.data ?? [];
 		const total = result.totalCount ?? items.length;
 		if (args.limit === 0) {
-			const desc = describeFilters$3(args);
+			const desc = describeFilters$4(args);
 			return { content: [{
 				type: "text",
 				text: desc ? `Total: ${total} client${total === 1 ? "" : "s"} matching ${desc}.` : `Total: ${total} client${total === 1 ? "" : "s"}.`
 			}] };
 		}
 		if (items.length === 0) {
-			const desc = describeFilters$3(args);
+			const desc = describeFilters$4(args);
 			return { content: [{
 				type: "text",
 				text: desc ? `No clients match ${desc}.` : "No clients found."
 			}] };
 		}
-		const desc = describeFilters$3(args);
+		const desc = describeFilters$4(args);
 		const lines = [
 			desc ? total > items.length ? `Found ${total} clients matching ${desc} (showing ${items.length}):` : `Found ${items.length} client${items.length === 1 ? "" : "s"} matching ${desc}:` : total > items.length ? `Showing ${items.length} of ${total} clients:` : `${items.length} client${items.length === 1 ? "" : "s"}:`,
 			"",
@@ -1365,7 +1442,7 @@ async function handleListClients(api, args) {
 		};
 	}
 }
-function describeFilters$3(args) {
+function describeFilters$4(args) {
 	const parts = [];
 	if (args.search) parts.push(`search "${args.search}"`);
 	if (args.status?.length) parts.push(`status ${args.status.join("/")}`);
@@ -1411,7 +1488,7 @@ async function handleGetClientSummary(api, { code }) {
 	}
 	return { content: [{
 		type: "text",
-		text: format$2({
+		text: format$3({
 			client: clientResult.value,
 			contacts: extract(contactsResult),
 			services: extract(servicesResult),
@@ -1434,7 +1511,7 @@ function extract(result) {
 	if (result.status !== "fulfilled") return [];
 	return result.value.data ?? [];
 }
-function format$2(input) {
+function format$3(input) {
 	const { client, contacts, services, businessDetails, clientDates, overdueTasks, upcomingTasks, gaps } = input;
 	const lines = [];
 	const name = client.name ?? "(no name)";
@@ -1551,14 +1628,14 @@ async function handleGetEngagementSummary(api, { code }) {
 	const engagement = engagementResult.value;
 	return { content: [{
 		type: "text",
-		text: format$1({
+		text: format$2({
 			engagement,
 			emails: emailsResult.status === "fulfilled" ? emailsResult.value : [],
 			gaps: emailsResult.status === "rejected" ? ["email history"] : []
 		})
 	}] };
 }
-function format$1(input) {
+function format$2(input) {
 	const { engagement: e, emails, gaps } = input;
 	const lines = [];
 	const code = e.code ?? "(no code)";
@@ -1578,7 +1655,7 @@ function format$1(input) {
 	const services = e.proposalServices ?? [];
 	if (services.length > 0) {
 		lines.push("", `--- Services (${services.length}) ---`);
-		for (const s of services) lines.push(`- ${formatService(s)}`);
+		for (const s of services) lines.push(`- ${formatService$1(s)}`);
 	}
 	if (e.acceptance && e.status === "Accepted") {
 		lines.push("", "--- Acceptance ---");
@@ -1613,7 +1690,7 @@ function formatValues(e) {
 	if (e.totalValue && e.totalValue > 0) out.push(`Total contracted value: £${formatMoney$1(e.totalValue)}`);
 	return out;
 }
-function formatService(s) {
+function formatService$1(s) {
 	const name = s.billableService?.name ?? "(unnamed)";
 	const freq = s.billingFrequency ? ` ${s.billingFrequency}` : "";
 	if (s.effectivePrice !== void 0 && s.effectivePrice !== null) return `${name} — £${formatMoney$1(s.effectivePrice)}${freq}`;
@@ -1629,6 +1706,83 @@ function formatMoney$1(n) {
 	});
 }
 //#endregion
+//#region ../mcp-core/src/tools/get-service-details.ts
+const GetServiceDetailsInputSchema = { code: z.string().min(1, "Service code is required").describe("The service code (identifier). Usually discovered via list_services first.") };
+async function handleGetServiceDetails(api, { code }) {
+	try {
+		return { content: [{
+			type: "text",
+			text: format$1(await api.getService(code))
+		}] };
+	} catch (error) {
+		return {
+			content: [{
+				type: "text",
+				text: error instanceof SodiumApiError ? `Error getting service: ${error.message} (correlation: ${error.correlationId})` : `Error getting service: ${error instanceof Error ? error.message : String(error)}`
+			}],
+			isError: true
+		};
+	}
+}
+function format$1(s) {
+	const lines = [];
+	const name = s.name ?? "(no name)";
+	const code = s.code ?? "(no code)";
+	lines.push(`Service: ${name} (${code})`);
+	const meta = [];
+	if (s.category) meta.push(s.category);
+	meta.push(s.isArchived ? "Archived" : "Active");
+	if (s.vatRate) meta.push(`VAT: ${s.vatRate}`);
+	if (s.pricingMode) meta.push(`Pricing: ${s.pricingMode}`);
+	if (meta.length > 0) lines.push(meta.join(" · "));
+	if (s.accountingCode) lines.push(`Accounting code: ${s.accountingCode}`);
+	if (s.description) lines.push(`Description: ${s.description}`);
+	if (s.defaultManagedByUser) lines.push(`Default manager: ${s.defaultManagedByUser.name} (${s.defaultManagedByUser.code})`);
+	lines.push("", "--- Applicable Client Types ---");
+	if (!s.clientTypes || s.clientTypes.length === 0) lines.push("All client types (no restriction configured).");
+	else for (const ct of s.clientTypes) lines.push(`- ${ct}`);
+	lines.push("", `--- HMRC Agent Authorisations (${s.agentAuthorisations?.length ?? 0}) ---`);
+	if (!s.agentAuthorisations || s.agentAuthorisations.length === 0) lines.push("None configured.");
+	else for (const a of s.agentAuthorisations) lines.push(`- ${a}`);
+	lines.push("", `--- Pricing Options (${s.pricing?.length ?? 0}) ---`);
+	if (!s.pricing || s.pricing.length === 0) lines.push("No pricing options configured.");
+	else for (const p of s.pricing) lines.push(formatPricingOption(p));
+	if (s.pricingMode === "CustomTiers" && s.pricingTiers && s.pricingTiers.length > 0) {
+		lines.push("", `--- Custom Pricing Tiers (${s.pricingTiers.length}) ---`);
+		const tiers = [...s.pricingTiers].sort((a, b) => (a.sortOrder ?? 0) - (b.sortOrder ?? 0));
+		for (const t of tiers) lines.push(formatTier(t));
+	}
+	lines.push("", `--- Professional Clearance Items (${s.pcrItems?.length ?? 0}) ---`);
+	if (!s.pcrItems || s.pcrItems.length === 0) lines.push("None configured.");
+	else for (const item of s.pcrItems) lines.push(formatCodeAndName$1(item));
+	const factorCount = s.pricingFactors?.length ?? 0;
+	lines.push("", "--- Pricing Factors ---");
+	if (factorCount === 0) lines.push("None configured.");
+	else {
+		lines.push(`${factorCount} pricing factor${factorCount === 1 ? "" : "s"} configured.`);
+		for (const f of s.pricingFactors ?? []) if (f.description) lines.push(`- ${f.description}`);
+		lines.push("Note: exact pricing computed from factors is available via the proposal tools (get_proposal_summary / get_engagement_letter_summary) — those return effectivePrice per service.");
+	}
+	if (s.recurringTaskCount && s.recurringTaskCount > 0) lines.push("", `Recurring tasks using this service: ${s.recurringTaskCount}`);
+	return lines.join("\n");
+}
+function formatPricingOption(p) {
+	const freq = p.frequency ?? "(no frequency)";
+	const price = typeof p.price === "number" ? `£${p.price.toFixed(2)}` : "(no price)";
+	const rangeCount = p.revenueRangeOverrides?.length ?? 0;
+	const tierCount = p.tierOverrides?.length ?? 0;
+	const overrides = [];
+	if (rangeCount > 0) overrides.push(`${rangeCount} revenue-range override${rangeCount === 1 ? "" : "s"}`);
+	if (tierCount > 0) overrides.push(`${tierCount} tier override${tierCount === 1 ? "" : "s"}`);
+	return `- ${freq}: ${price}${overrides.length > 0 ? ` (+ ${overrides.join(", ")})` : ""}`;
+}
+function formatTier(t) {
+	return `- ${t.name ?? "(unnamed)"} (${t.code ?? "(no code)"})`;
+}
+function formatCodeAndName$1(item) {
+	return `- ${item.name ?? "(unnamed)"} (${item.code ?? "(no code)"})`;
+}
+//#endregion
 //#region ../mcp-core/src/tools/get-task-context.ts
 const GetTaskContextInputSchema = { code: z.string().min(1, "Task code is required").describe("The task code (identifier). Usually discovered via list_tasks first, or supplied directly by the user when they quote a task code.") };
 async function handleGetTaskContext(api, { code }) {
@@ -1826,20 +1980,20 @@ async function handleListEngagements(api, args) {
 		const items = result.data ?? [];
 		const total = result.totalCount ?? items.length;
 		if (args.limit === 0) {
-			const desc = describeFilters$2(args);
+			const desc = describeFilters$3(args);
 			return { content: [{
 				type: "text",
 				text: desc ? `Total: ${total} engagement${total === 1 ? "" : "s"} matching ${desc}.` : `Total: ${total} engagement${total === 1 ? "" : "s"}.`
 			}] };
 		}
 		if (items.length === 0) {
-			const desc = describeFilters$2(args);
+			const desc = describeFilters$3(args);
 			return { content: [{
 				type: "text",
 				text: desc ? `No engagements match ${desc}.` : "No engagements found."
 			}] };
 		}
-		const desc = describeFilters$2(args);
+		const desc = describeFilters$3(args);
 		const lines = [
 			desc ? total > items.length ? `Found ${total} engagements matching ${desc} (showing ${items.length}):` : `Found ${items.length} engagement${items.length === 1 ? "" : "s"} matching ${desc}:` : total > items.length ? `Showing ${items.length} of ${total} engagements:` : `${items.length} engagement${items.length === 1 ? "" : "s"}:`,
 			"",
@@ -1877,7 +2031,7 @@ function formatMoney(n) {
 		maximumFractionDigits: 2
 	});
 }
-function describeFilters$2(args) {
+function describeFilters$3(args) {
 	const parts = [];
 	if (args.status) parts.push(`status ${args.status}`);
 	if (args.search) parts.push(`search "${args.search}"`);
@@ -1886,6 +2040,101 @@ function describeFilters$2(args) {
 	return parts.join(", ");
 }
 //#endregion
+//#region ../mcp-core/src/tools/list-services.ts
+const categoryEnum = z.enum([
+	"Other",
+	"CoreAccounting",
+	"Tax",
+	"Payroll",
+	"CompanySecretarial",
+	"Advisory",
+	"SoftwareAndTraining"
+]);
+const clientTypeEnum = z.enum([
+	"PrivateLimitedCompany",
+	"PublicLimitedCompany",
+	"LimitedLiabilityPartnership",
+	"Partnership",
+	"Individual",
+	"Trust",
+	"Charity",
+	"SoleTrader"
+]);
+const sortByEnum$2 = z.enum([
+	"Name",
+	"Category",
+	"AccountingCode"
+]);
+const ListServicesInputSchema = {
+	search: z.string().min(3, "Search must be at least 3 characters when provided").optional().describe("Free-text search across service code and name. Minimum 3 characters. Use for 'find our VAT services' or 'does the practice have a bookkeeping service?' when the exact code isn't known."),
+	category: categoryEnum.optional().describe("Filter by service category. Use 'Tax' for 'all tax services', 'Payroll' for payroll, 'CoreAccounting' for year-end / accounts / bookkeeping, 'CompanySecretarial' for confirmation statements / registered office, 'Advisory' for consulting / planning, 'SoftwareAndTraining' for software setup / training. Single value — to see multiple categories, call once per category or omit to see all."),
+	clientType: clientTypeEnum.optional().describe("Filter by the client type the service applies to. Use for service-audit questions like 'which services do we offer to individuals?' or 'what do we offer private limited companies?'. Returns services configured for that client type plus any service with no client-type restriction (those apply to everyone)."),
+	isArchived: z.boolean().optional().describe("Filter by archived status. Omit (default) to return everything; pass false for active services only; pass true for the archive. Most practice-manager questions ('what do we offer?') want isArchived=false."),
+	sortBy: sortByEnum$2.optional().describe("Field to sort by. Defaults to Name. Use 'Category' to group the output by category, 'AccountingCode' when reconciling against a chart of accounts."),
+	sortDesc: z.boolean().optional().describe("Sort in descending order. Defaults to ascending."),
+	limit: z.number().int().min(0).max(50).optional().describe("Maximum number of services per page. Default 10, max 50. Pass 0 to return only the total count without any service data — use for 'how many services do we offer?' questions."),
+	offset: z.number().int().min(0).optional().describe("Pagination offset. Default 0.")
+};
+function formatService(s) {
+	const code = s.code ?? "(no code)";
+	const name = s.name ?? "(unnamed)";
+	const category = s.category ? ` · ${s.category}` : "";
+	const pricing = s.pricingMode ? ` · ${s.pricingMode}` : "";
+	return `- ${name} (${code})${s.isArchived ? " [ARCHIVED]" : ""}${category}${pricing}${s.accountingCode ? ` · a/c ${s.accountingCode}` : ""}${s.recurringTaskCount && s.recurringTaskCount > 0 ? ` · ${s.recurringTaskCount} recurring task${s.recurringTaskCount === 1 ? "" : "s"}` : ""}`;
+}
+async function handleListServices(api, args) {
+	try {
+		const query = args;
+		const result = await api.listServices(query);
+		const items = result.data ?? [];
+		const total = result.totalCount ?? items.length;
+		if (args.limit === 0) {
+			const desc = describeFilters$2(args);
+			return { content: [{
+				type: "text",
+				text: desc ? `Total: ${total} service${total === 1 ? "" : "s"} matching ${desc}.` : `Total: ${total} service${total === 1 ? "" : "s"}.`
+			}] };
+		}
+		if (items.length === 0) {
+			const desc = describeFilters$2(args);
+			return { content: [{
+				type: "text",
+				text: desc ? `No services match ${desc}.` : "No services found."
+			}] };
+		}
+		const desc = describeFilters$2(args);
+		const lines = [
+			desc ? total > items.length ? `Found ${total} services matching ${desc} (showing ${items.length}):` : `Found ${items.length} service${items.length === 1 ? "" : "s"} matching ${desc}:` : total > items.length ? `Showing ${items.length} of ${total} services:` : `${items.length} service${items.length === 1 ? "" : "s"}:`,
+			"",
+			...items.map(formatService)
+		];
+		if (result.hasMore) {
+			const nextOffset = (args.offset ?? 0) + items.length;
+			lines.push("", `More results available — call again with offset: ${nextOffset} to see the next page.`);
+		}
+		return { content: [{
+			type: "text",
+			text: lines.join("\n")
+		}] };
+	} catch (error) {
+		return {
+			content: [{
+				type: "text",
+				text: error instanceof SodiumApiError ? `Error listing services: ${error.message} (correlation: ${error.correlationId})` : `Error listing services: ${error instanceof Error ? error.message : String(error)}`
+			}],
+			isError: true
+		};
+	}
+}
+function describeFilters$2(args) {
+	const parts = [];
+	if (args.search) parts.push(`search "${args.search}"`);
+	if (args.category) parts.push(`category ${args.category}`);
+	if (args.clientType) parts.push(`clientType ${args.clientType}`);
+	if (args.isArchived !== void 0) parts.push(`isArchived=${args.isArchived}`);
+	return parts.join(", ");
+}
+//#endregion
 //#region ../mcp-core/src/tools/list-tasks.ts
 const statusEnum$1 = z.enum([
 	"NotStarted",
@@ -2104,7 +2353,7 @@ function describeFilters(args) {
 //#endregion
 //#region ../mcp-core/src/server.ts
 async function buildServer(config) {
-	const api = new SodiumApiClient(config.context);
+	const api = new SodiumApiClient(config.context, { serverVersion: config.serverVersion });
 	const instructions = await buildInstructions(api);
 	const server = new McpServer({
 		name: config.serverName,
@@ -2113,6 +2362,13 @@ async function buildServer(config) {
 		instructions,
 		capabilities: { tools: {} }
 	});
+	server.server.oninitialized = () => {
+		const info = server.server.getClientVersion();
+		if (info?.name && info?.version) api.setMcpClientInfo({
+			name: info.name,
+			version: info.version
+		});
+	};
 	server.registerTool("get_practice_details", {
 		title: "Get practice details",
 		description: "Get a consolidated overview of the practice including name, contact details, client/service/user counts, connections, and settings. Use this when the user asks about their practice, tenant, or wants a summary of their account.",
@@ -2203,6 +2459,26 @@ async function buildServer(config) {
 			openWorldHint: true
 		}
 	}, (args) => handleGetEngagementSummary(api, args));
+	server.registerTool("list_services", {
+		title: "List / search / filter the practice's service catalogue",
+		description: "List the practice's configured billable services with any combination of: search (3+ chars over code and name), category (Tax / Payroll / CoreAccounting / CompanySecretarial / Advisory / SoftwareAndTraining / Other — single value), clientType (PrivateLimitedCompany / PublicLimitedCompany / LimitedLiabilityPartnership / Partnership / Individual / Trust / Charity / SoleTrader — single value; matches services configured for that type plus services with no client-type restriction), isArchived (omit for all, false for active only, true for archive), sort (Name / Category / AccountingCode), and pagination. Use for: 'what services do we offer?' (no filter, isArchived=false), 'list our tax services' (category=Tax), 'what do we offer limited companies?' (clientType=PrivateLimitedCompany, isArchived=false), 'how many active services do we have?' (isArchived=false, limit=0 for count-only). Returns up to 50 per page. Follow up with get_service_details for one service's full configuration (client types, pricing options, clearance items, HMRC authorisations).",
+		inputSchema: ListServicesInputSchema,
+		annotations: {
+			readOnlyHint: true,
+			idempotentHint: true,
+			openWorldHint: true
+		}
+	}, (args) => handleListServices(api, args));
+	server.registerTool("get_service_details", {
+		title: "Get a single service's full configuration",
+		description: "Get a consolidated view of one billable service by code: identity (name, code, category, status, VAT rate, accounting code, description, default manager, pricing mode), applicable client types (explicit list, or 'all client types' if unrestricted), HMRC agent authorisations, pricing options (one per billing frequency with base price + override counts), custom pricing tiers (only when pricingMode=CustomTiers), professional clearance request items, and pricing-factor presence (count + factor questions only — exact factor band values are intentionally not dumped; computed pricing per client lives in the proposal tools). Use this AFTER list_services identifies the service, or when the user references a specific service by code. Enables service-audit workflows like 'is Self Assessment correctly restricted to Individual clients?' and 'what clearance items do we request for new bookkeeping clients?'",
+		inputSchema: GetServiceDetailsInputSchema,
+		annotations: {
+			readOnlyHint: true,
+			idempotentHint: true,
+			openWorldHint: true
+		}
+	}, (args) => handleGetServiceDetails(api, args));
 	server.registerTool("list_users", {
 		title: "List / search / filter tenant users",
 		description: "Find tenant users by name, email, role, or status. Use this when the user mentioned in a request isn't present in the startup roster (large teams have more than the top 20 active members shown there), or when filtering is needed beyond name resolution. Typical queries: 'find Jane' (search), 'list all partners' (isPartner=true), 'who's been invited but not joined yet?' (status=Invited), 'how many active users do we have?' (status=Active, limit=0). For 'how many X?' questions, pass limit=0 to get just the total count without fetching any user data.",
@@ -2231,7 +2507,7 @@ function loadContext() {
 }
 //#endregion
 //#region src/index.ts
-const VERSION = "0.0.1";
+const VERSION = createRequire(import.meta.url)("../package.json").version;
 async function main() {
 	const context = loadContext();
 	const server = await buildServer({

package/package.json

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