@alfe.ai/myob-mcp 0.4.3 → 0.5.0

package/dist/server.js

@@ -94,6 +94,27 @@ var MyobClient = class {
 */
 const myobBusinessIdField = z.string().min(1).describe("MYOB Business ID — use the value from myob_list_businesses to pick which connected business this call should target.");
 const myobResourceUidField = z.string().min(1).describe("MYOB resource UID (GUID)");
+/**
+* Report date selector. MYOB report endpoints take dates as query values, so
+* keep this a plain string: `MyobClient.get` only accepts Record<string,string>
+* and the Pattern A guard classifies non-ZodString shapes as "non-string".
+* Date-only `YYYY-MM-DD` matches MYOB's own report examples and is URL-safe.
+*/
+const myobDateField = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, "date must be YYYY-MM-DD").refine((value) => {
+	const [y, m, d] = value.split("-").map(Number);
+	const date = new Date(Date.UTC(y, m - 1, d));
+	return date.getUTCFullYear() === y && date.getUTCMonth() === m - 1 && date.getUTCDate() === d;
+}, { message: "date must be a real calendar date (YYYY-MM-DD)" }).describe("Date in YYYY-MM-DD format (e.g. 2026-07-01)");
+/**
+* Boolean report option. LLMs stringify booleans as readily as numbers and the
+* MCP SDK validates the live schema before the handler, so accept "true"/"false"
+* too. NOT `z.coerce.boolean()`: `Boolean("false") === true`.
+*/
+const myobBooleanField = z.union([z.boolean(), z.enum(["true", "false"]).transform((value) => value === "true")]);
+/** Model-visible guard for an inverted report period. */
+function assertReportPeriod(startDate, endDate) {
+	if (startDate > endDate) throw new Error(`startDate (${startDate}) is after endDate (${endDate}). MYOB would silently fall back to a default period; swap the dates or narrow the range and retry.`);
+}
 function myobResourcePath(collectionPath, uid) {
 	return `${collectionPath}/${encodeURIComponent(uid)}`;
 }
@@ -115,6 +136,64 @@ const updateToolAnnotations = {
 	idempotentHint: false,
 	openWorldHint: true
 };
+/** MYOB's maximum page size; report endpoints default to 400 rows. */
+const MYOB_REPORT_PAGE_SIZE = "1000";
+function isReportPage(value) {
+	return typeof value === "object" && value !== null && Array.isArray(value.AccountsBreakdown);
+}
+/**
+* Fetch every page of a `/Report/*Summary` endpoint and return one merged
+* report. MYOB pages `AccountsBreakdown` (400 rows by default, 1,000 max) and
+* signals more rows with an absolute `NextPageLink`; the `$skip`/`$top` on
+* that link are re-issued against the same path so the client's base URL and
+* auth headers stay in charge. A report cut short by the page cap carries
+* `Incomplete: true` and the unread `NextPageLink` instead of silently
+* dropping accounts.
+*/
+async function getReportAllPages(client, path, params) {
+	const first = await client.get(path, {
+		...params,
+		$top: MYOB_REPORT_PAGE_SIZE
+	});
+	if (!isReportPage(first)) return first;
+	const merged = {
+		...first,
+		AccountsBreakdown: [...first.AccountsBreakdown]
+	};
+	let page = first;
+	let pages = 1;
+	while (page.NextPageLink !== void 0 && page.NextPageLink !== null) {
+		const incomplete = {
+			...merged,
+			Incomplete: true,
+			NextPageLink: page.NextPageLink
+		};
+		if (pages >= 20) return incomplete;
+		if (typeof page.NextPageLink !== "string" || page.NextPageLink.length === 0) return incomplete;
+		let skip;
+		try {
+			skip = new URL(page.NextPageLink).searchParams.get("$skip");
+		} catch {
+			return incomplete;
+		}
+		if (!skip) return incomplete;
+		const next = await client.get(path, {
+			...params,
+			$top: MYOB_REPORT_PAGE_SIZE,
+			$skip: skip
+		});
+		if (!isReportPage(next)) return {
+			...merged,
+			Incomplete: true,
+			NextPageLink: page.NextPageLink
+		};
+		merged.AccountsBreakdown.push(...next.AccountsBreakdown);
+		page = next;
+		pages += 1;
+	}
+	delete merged.NextPageLink;
+	return merged;
+}
 //#endregion
 //#region src/tools/contacts.ts
 function registerContactTools(server, resolveClient) {
@@ -162,7 +241,7 @@ function registerContactTools(server, resolveClient) {
 			CompanyName: z.string().optional().describe("Company name"),
 			FirstName: z.string().optional().describe("First name"),
 			LastName: z.string().optional().describe("Last name"),
-			IsIndividual: z.boolean().optional().describe("true for individual, false for company"),
+			IsIndividual: myobBooleanField.optional().describe("true for individual, false for company"),
 			DisplayID: z.string().optional().describe("Display ID (account number)"),
 			data: z.record(z.string(), z.unknown()).optional().describe("Full customer data object — overrides individual fields if provided")
 		}
@@ -238,7 +317,7 @@ function registerContactTools(server, resolveClient) {
 			CompanyName: z.string().optional().describe("Company name"),
 			FirstName: z.string().optional().describe("First name"),
 			LastName: z.string().optional().describe("Last name"),
-			IsIndividual: z.boolean().optional().describe("true for individual, false for company"),
+			IsIndividual: myobBooleanField.optional().describe("true for individual, false for company"),
 			DisplayID: z.string().optional().describe("Display ID"),
 			data: z.record(z.string(), z.unknown()).optional().describe("Full supplier data object")
 		}
@@ -538,6 +617,49 @@ function registerGeneralLedgerTools(server, resolveClient) {
 			text: JSON.stringify(result, null, 2)
 		}] };
 	});
+	register("myob_get_profit_and_loss", {
+		description: "Profit and loss summary for a connected MYOB Business over a date range. Returns one total per income/expense account (AccountsBreakdown), NOT individual transactions — use this instead of listing invoices or journal entries to answer profitability or monthly P&L questions.",
+		annotations: readOnlyToolAnnotations,
+		inputSchema: {
+			myobBusinessId: myobBusinessIdField,
+			startDate: myobDateField.describe("First day of the reporting period (YYYY-MM-DD)"),
+			endDate: myobDateField.describe("Last day of the reporting period (YYYY-MM-DD)"),
+			reportingBasis: z.enum(["Accrual", "Cash"]).optional().describe("Accrual (default) recognises income when invoiced; Cash when paid"),
+			yearEndAdjust: myobBooleanField.optional().describe("Include year-end adjustment entries. Defaults to false")
+		}
+	}, async (args) => {
+		assertReportPeriod(args.startDate, args.endDate);
+		const result = await getReportAllPages(resolveClient(args.myobBusinessId), "/Report/ProfitAndLossSummary", {
+			StartDate: args.startDate,
+			EndDate: args.endDate,
+			ReportingBasis: args.reportingBasis ?? "Accrual",
+			YearEndAdjust: String(args.yearEndAdjust ?? false)
+		});
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(result, null, 2)
+		}] };
+	});
+	register("myob_get_balance_sheet", {
+		description: "Balance sheet summary for a connected MYOB Business as at a single date. Returns one total per asset/liability/equity account (AccountsBreakdown), NOT individual transactions.",
+		annotations: readOnlyToolAnnotations,
+		inputSchema: {
+			myobBusinessId: myobBusinessIdField,
+			asOfDate: myobDateField.describe("Balance date (YYYY-MM-DD)"),
+			reportingBasis: z.enum(["Accrual", "Cash"]).optional().describe("Accrual (default) or Cash"),
+			yearEndAdjust: myobBooleanField.optional().describe("Include year-end adjustment entries. Defaults to false")
+		}
+	}, async (args) => {
+		const result = await getReportAllPages(resolveClient(args.myobBusinessId), "/Report/BalanceSheetSummary", {
+			AsOfDate: args.asOfDate,
+			ReportingBasis: args.reportingBasis ?? "Accrual",
+			YearEndAdjust: String(args.yearEndAdjust ?? false)
+		});
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(result, null, 2)
+		}] };
+	});
 	register("myob_list_tax_codes", {
 		description: "List tax codes from a connected MYOB Business (read-only for MYOB Essentials).",
 		annotations: readOnlyToolAnnotations,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/myob-mcp",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "MYOB Business MCP server — direct API integration with Alfe OAuth credentials and automatic token refresh",
   "type": "module",
   "main": "./dist/server.js",