@procurementexpress.com/mcp 1.0.0 → 2.0.0

package/dist/tools/purchase-orders.js

@@ -1,81 +1,188 @@
 import { z } from "zod";
 import { jsonResponse, textResponse, withErrorHandling } from "../tool-helpers.js";
+const customFieldValueSchema = z.object({
+    id: z.number().int().optional().describe("Custom field value ID (for updates)"),
+    value: z.string().describe("Custom field value"),
+    custom_field_id: z.number().int().describe("Custom field ID"),
+});
 const lineItemSchema = z.object({
+    id: z.number().int().optional().describe("Line item ID (for updates)"),
     description: z.string().describe("Item description"),
     quantity: z.number().describe("Quantity"),
     unit_price: z.number().describe("Unit price"),
     budget_id: z.number().int().optional().describe("Budget ID"),
-    vat: z.number().optional().describe("VAT amount"),
-    item_number: z.string().optional().describe("Item number"),
-    sequence_no: z.number().int().optional().describe("Sequence number"),
+    vat: z.number().optional().describe("VAT/tax percentage"),
     tax_rate_id: z.number().int().optional().describe("Tax rate ID"),
+    item_number: z.string().optional().describe("Item number"),
+    sequence_no: z.number().int().optional().describe("Sequence number for ordering"),
+    department_id: z.number().int().optional().describe("Department ID for the line item"),
+    product_id: z.number().int().optional().describe("Product ID"),
+    chart_of_account_id: z.number().int().optional().describe("Chart of account ID (GL code)"),
+    qbo_customer_id: z.number().int().optional().describe("QuickBooks customer ID"),
+    quickbooks_class_id: z.number().int().optional().describe("QuickBooks class ID"),
+    qbo_line_description: z.string().optional().describe("QuickBooks line description override"),
+    archived: z.boolean().optional().describe("Whether the line item is archived"),
+    _destroy: z.boolean().optional().describe("Set true to remove this line item on update"),
+    custom_field_values_attributes: z.array(customFieldValueSchema).optional().describe("Custom field values for this line item"),
 });
 export function registerPurchaseOrderTools(server, apiClient) {
     server.registerTool("list_purchase_orders", {
-        description: "List purchase orders with pagination and search",
+        description: "List purchase orders with pagination, search, and filters. Returns paginated results with meta info (current_page, next_page, prev_page, total_pages, total_count).",
         inputSchema: {
-            orders_page: z.number().int().positive().optional().describe("Page number (default: 1)"),
-            search: z.string().optional().describe("Search term"),
-            requests: z.boolean().optional().describe("Set to true to list pending approval requests"),
-            sort: z.string().optional().describe("Sort field"),
-            direction: z.enum(["asc", "desc"]).optional().describe("Sort direction"),
+            page: z.number().int().positive().optional().describe("Page number (default: 1). Use 'orders_page' as alias."),
+            search: z.string().optional().describe("Search term — matches PO number, supplier name, notes, line item descriptions"),
+            status: z
+                .enum(["draft", "pending", "approved", "rejected", "cancelled", "paid"])
+                .optional()
+                .describe("Filter by PO status"),
+            delivery_status: z
+                .enum(["not_delivered", "partially_delivered", "complete_delivered"])
+                .optional()
+                .describe("Filter by delivery status"),
+            payment_status: z
+                .enum(["unpaid", "partially_paid", "paid", "invoice_received"])
+                .optional()
+                .describe("Filter by payment status"),
+            supplier_id: z.number().int().optional().describe("Filter by supplier ID"),
+            requester_id: z.number().int().optional().describe("Filter by creator/requester user ID"),
+            budget_id: z.number().int().optional().describe("Filter by budget ID"),
+            filter_dept_id: z.number().int().optional().describe("Filter by department ID"),
+            approver_id: z.number().int().optional().describe("Filter by approver user ID"),
+            archived: z.boolean().optional().describe("Filter archived POs (default: false)"),
+            date_filter: z
+                .enum(["current_month", "current_year", "last_month", "last_year"])
+                .optional()
+                .describe("Predefined date range filter"),
+            from: z.string().optional().describe("Custom date range start (format depends on company date_format setting)"),
+            to: z.string().optional().describe("Custom date range end"),
+            updated_after: z.string().optional().describe("ISO datetime — only return POs updated after this timestamp (includes line item and custom field changes)"),
+            sort: z.string().optional().describe("Sort column (e.g. 'submitted_on', 'total_gross_amount', 'suppliers.name')"),
+            direction: z.enum(["asc", "desc"]).optional().describe("Sort direction (default: desc)"),
+            requests: z.boolean().optional().describe("Set true to include pending approval requests"),
+            bell: z.boolean().optional().describe("Set true with requests=true to show only bell notification items"),
         },
     }, withErrorHandling(async (args) => {
         const params = new URLSearchParams();
-        if (args.orders_page)
-            params.set("orders_page", String(args.orders_page));
+        if (args.page)
+            params.set("orders_page", String(args.page));
         if (args.search)
             params.set("search", args.search);
-        if (args.requests)
-            params.set("requests", "true");
+        if (args.status)
+            params.set("status", args.status);
+        if (args.delivery_status)
+            params.set("delivery_status", args.delivery_status);
+        if (args.payment_status)
+            params.set("payment_status", args.payment_status);
+        if (args.supplier_id)
+            params.set("supplier_id", String(args.supplier_id));
+        if (args.requester_id)
+            params.set("requester_id", String(args.requester_id));
+        if (args.budget_id)
+            params.set("budget_id", String(args.budget_id));
+        if (args.filter_dept_id)
+            params.set("filter_dept_id", String(args.filter_dept_id));
+        if (args.approver_id)
+            params.set("approver_id", String(args.approver_id));
+        if (args.archived !== undefined)
+            params.set("archived", String(args.archived));
+        if (args.date_filter)
+            params.set("date_filter", args.date_filter);
+        if (args.from)
+            params.set("from", args.from);
+        if (args.to)
+            params.set("to", args.to);
+        if (args.updated_after)
+            params.set("updated_after", args.updated_after);
         if (args.sort)
             params.set("sort", args.sort);
         if (args.direction)
             params.set("direction", args.direction);
+        if (args.requests)
+            params.set("requests", "true");
+        if (args.bell)
+            params.set("bell", "true");
         const query = params.toString();
         const path = `${apiClient.buildPath("/purchase_orders")}${query ? `?${query}` : ""}`;
         const result = await apiClient.get(path);
         return jsonResponse(result);
     }));
     server.registerTool("get_purchase_order", {
-        description: "Get purchase order details including line items, comments, approvals, and status flags",
+        description: "Get purchase order details including line items, comments, approvals, and status flags. The ID parameter accepts a numeric ID, approval-key, or slug.",
         inputSchema: {
-            id: z.number().int().positive().describe("Purchase Order ID"),
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
         },
     }, withErrorHandling(async (args) => {
         const po = await apiClient.get(apiClient.buildPath(`/purchase_orders/${args.id}`));
         return jsonResponse(po);
     }));
     server.registerTool("create_purchase_order", {
-        description: "Create a new purchase order. Use commit='Send' to submit or 'Draft' to save as draft",
+        description: "Create a new purchase order. Use commit='Send' to submit for approval or 'Draft' to save as draft. At least one line item is required.",
         inputSchema: {
             commit: z.enum(["Send", "Draft"]).describe("'Send' to submit for approval, 'Draft' to save as draft"),
             department_id: z.number().int().optional().describe("Department ID"),
             creator_id: z.number().int().describe("Creator user ID"),
-            supplier_id: z.number().int().optional().describe("Supplier ID"),
-            supplier_name: z.string().optional().describe("Supplier name (for new suppliers)"),
-            currency_id: z.number().int().describe("Currency ID"),
-            notes: z.string().optional().describe("PO notes"),
+            supplier_id: z.number().int().optional().describe("Existing supplier ID"),
+            supplier_name: z.string().optional().describe("Supplier name (used when supplier_id is not provided)"),
+            new_supplier_name: z.string().optional().describe("Create a new supplier with this name"),
+            currency_id: z.number().int().optional().describe("Currency ID (defaults to company/user currency)"),
+            iso_code: z.string().optional().describe("Currency ISO code (e.g. 'USD') — alternative to currency_id"),
+            notes: z.string().optional().describe("PO notes/description"),
+            submitted_on: z.string().optional().describe("Submission date (format depends on company date_format)"),
+            on_behalf_of: z.number().int().optional().describe("Create PO on behalf of this user ID (companyadmin only, user must be active employee)"),
             line_items: z.array(lineItemSchema).min(1).describe("Line items (at least one required)"),
-            approver_list: z.array(z.number().int()).optional().describe("Approver IDs"),
+            approver_list: z.array(z.number().int()).optional().describe("Approver user IDs"),
+            custom_field_values_attributes: z.array(customFieldValueSchema).optional().describe("PO-level custom field values"),
         },
     }, withErrorHandling(async (args) => {
-        const { commit, line_items, approver_list, ...poData } = args;
+        const { commit, line_items, approver_list, iso_code, on_behalf_of, custom_field_values_attributes, ...poData } = args;
         const body = {
             commit,
             purchase_order: {
                 ...poData,
+                ...(iso_code ? { iso_code } : {}),
+                ...(on_behalf_of ? { on_behalf_of } : {}),
                 purchase_order_items_attributes: line_items,
                 ...(approver_list ? { approver_list } : {}),
+                ...(custom_field_values_attributes ? { custom_field_values_attributes } : {}),
             },
         };
         const po = await apiClient.post(apiClient.buildPath("/purchase_orders"), body);
         return jsonResponse(po);
     }));
+    server.registerTool("update_purchase_order", {
+        description: "Update an existing purchase order. Use commit='Send' to submit a draft for approval. The ID accepts numeric ID, approval-key, or slug.",
+        inputSchema: {
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
+            commit: z.enum(["Send", "Draft"]).optional().describe("'Send' to submit draft for approval"),
+            department_id: z.number().int().optional().describe("Department ID"),
+            supplier_id: z.number().int().optional().describe("Supplier ID"),
+            supplier_name: z.string().optional().describe("Supplier name"),
+            new_supplier_name: z.string().optional().describe("Create a new supplier with this name"),
+            currency_id: z.number().int().optional().describe("Currency ID"),
+            notes: z.string().optional().describe("PO notes"),
+            submitted_on: z.string().optional().describe("Submission date"),
+            line_items: z.array(lineItemSchema).optional().describe("Line items (include id to update existing, _destroy to remove)"),
+            approver_list: z.array(z.number().int()).optional().describe("Approver user IDs"),
+            custom_field_values_attributes: z.array(customFieldValueSchema).optional().describe("PO-level custom field values"),
+        },
+    }, withErrorHandling(async (args) => {
+        const { id, commit, line_items, approver_list, custom_field_values_attributes, ...poData } = args;
+        const body = {
+            ...(commit ? { commit } : {}),
+            purchase_order: {
+                ...poData,
+                ...(line_items ? { purchase_order_items_attributes: line_items } : {}),
+                ...(approver_list ? { approver_list } : {}),
+                ...(custom_field_values_attributes ? { custom_field_values_attributes } : {}),
+            },
+        };
+        const po = await apiClient.put(apiClient.buildPath(`/purchase_orders/${id}`), body);
+        return jsonResponse(po);
+    }));
     server.registerTool("approve_purchase_order", {
         description: "Approve a purchase order using the accept token from the approver request",
         inputSchema: {
-            id: z.number().int().positive().describe("Purchase Order ID"),
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
             token: z.string().describe("Accept token from the approver request"),
         },
     }, withErrorHandling(async (args) => {
@@ -85,7 +192,7 @@ export function registerPurchaseOrderTools(server, apiClient) {
     server.registerTool("reject_purchase_order", {
         description: "Reject a purchase order using the reject token from the approver request",
         inputSchema: {
-            id: z.number().int().positive().describe("Purchase Order ID"),
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
             token: z.string().describe("Reject token from the approver request"),
         },
     }, withErrorHandling(async (args) => {
@@ -93,50 +200,68 @@ export function registerPurchaseOrderTools(server, apiClient) {
         return jsonResponse(result);
     }));
     server.registerTool("override_and_approve_purchase_order", {
-        description: "Override and approve a purchase order (finance users only, no token required)",
+        description: "Override and approve a purchase order (finance role required, no token needed)",
         inputSchema: {
-            id: z.number().int().positive().describe("Purchase Order ID"),
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
         },
     }, withErrorHandling(async (args) => {
         const result = await apiClient.get(apiClient.buildPath(`/purchase_orders/${args.id}/override_and_approve`));
         return jsonResponse(result);
     }));
     server.registerTool("cancel_purchase_order", {
-        description: "Cancel a purchase order",
+        description: "Cancel a purchase order (requires cancel permission)",
         inputSchema: {
-            id: z.number().int().positive().describe("Purchase Order ID"),
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
         },
     }, withErrorHandling(async (args) => {
         const result = await apiClient.post(apiClient.buildPath(`/purchase_orders/${args.id}/cancel`));
         return jsonResponse(result);
     }));
     server.registerTool("archive_purchase_order", {
-        description: "Archive a purchase order",
+        description: "Toggle archive status of a purchase order (finance role required). Calling again will dearchive.",
         inputSchema: {
-            id: z.number().int().positive().describe("Purchase Order ID"),
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
         },
     }, withErrorHandling(async (args) => {
         const result = await apiClient.post(apiClient.buildPath(`/purchase_orders/${args.id}/archive`));
         return jsonResponse(result);
     }));
+    server.registerTool("delete_purchase_order", {
+        description: "Permanently delete a purchase order (requires destroy permission)",
+        inputSchema: {
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
+        },
+    }, withErrorHandling(async (args) => {
+        const result = await apiClient.delete(apiClient.buildPath(`/purchase_orders/${args.id}/delete`));
+        return jsonResponse(result);
+    }));
+    server.registerTool("generate_purchase_order_pdf", {
+        description: "Generate a PDF for a purchase order and return a download link",
+        inputSchema: {
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
+        },
+    }, withErrorHandling(async (args) => {
+        const result = await apiClient.get(apiClient.buildPath(`/purchase_orders/${args.id}/generate_pdf`));
+        return jsonResponse(result);
+    }));
     server.registerTool("get_pending_request_count", {
-        description: "Get the count of pending approval requests",
+        description: "Get the count of pending approval requests for the current user",
         inputSchema: {},
     }, withErrorHandling(async () => {
         const result = await apiClient.get(apiClient.buildPath("/purchase_orders/pending_request_count"));
         return textResponse(`Pending requests: ${result.total_pending_request}`);
     }));
     server.registerTool("receive_purchase_order_items", {
-        description: "Mark items as received for a purchase order",
+        description: "Mark line items as received (partial or full delivery) for a purchase order",
         inputSchema: {
-            id: z.number().int().positive().describe("Purchase Order ID"),
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
             items: z
                 .array(z.object({
-                id: z.number().int().describe("PO item ID"),
+                id: z.number().int().describe("PO line item ID"),
                 quantity: z.number().describe("Quantity received"),
             }))
                 .describe("Items with received quantities"),
-            delivered_on: z.string().describe("Delivery date"),
+            delivered_on: z.string().describe("Delivery date (format depends on company date_format)"),
             notes: z.string().optional().describe("Delivery notes"),
         },
     }, withErrorHandling(async (args) => {
@@ -149,4 +274,22 @@ export function registerPurchaseOrderTools(server, apiClient) {
         });
         return jsonResponse(result);
     }));
+    server.registerTool("cancel_receiving_items", {
+        description: "Cancel all received deliveries for a purchase order, reverting to not delivered status",
+        inputSchema: {
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
+        },
+    }, withErrorHandling(async (args) => {
+        const result = await apiClient.post(apiClient.buildPath(`/purchase_orders/${args.id}/cancel_receiving_items`));
+        return jsonResponse(result);
+    }));
+    server.registerTool("complete_purchase_order_delivery", {
+        description: "Mark a purchase order as fully delivered",
+        inputSchema: {
+            id: z.string().describe("Purchase Order ID, approval-key, or slug"),
+        },
+    }, withErrorHandling(async (args) => {
+        const result = await apiClient.post(apiClient.buildPath(`/purchase_orders/${args.id}/complete_delivery`));
+        return jsonResponse(result);
+    }));
 }

package/dist/tools/supplementary.js

@@ -2,47 +2,92 @@ import { z } from "zod";
 import { jsonResponse, withErrorHandling } from "../tool-helpers.js";
 export function registerSupplementaryTools(server, apiClient) {
     server.registerTool("list_chart_of_accounts", {
-        description: "List chart of accounts with optional search",
+        description: "List chart of accounts (GL codes) with pagination and optional search",
         inputSchema: {
-            search: z.string().optional().describe("Search term"),
+            search: z.string().optional().describe("Search by account name or code"),
+            page: z.number().int().positive().optional().describe("Page number (default: 1)"),
+            per_page: z.number().int().positive().optional().describe("Results per page (default: company setting)"),
         },
     }, withErrorHandling(async (args) => {
         const params = new URLSearchParams();
         if (args.search)
             params.set("search", args.search);
+        if (args.page)
+            params.set("page", String(args.page));
+        if (args.per_page)
+            params.set("per_page", String(args.per_page));
         const query = params.toString();
         const path = `${apiClient.buildPath("/chart_of_accounts")}${query ? `?${query}` : ""}`;
         const result = await apiClient.get(path);
         return jsonResponse(result);
     }));
+    server.registerTool("get_chart_of_account", {
+        description: "Get a specific chart of account by ID",
+        inputSchema: {
+            id: z.number().int().positive().describe("Chart of Account ID"),
+        },
+    }, withErrorHandling(async (args) => {
+        const result = await apiClient.get(apiClient.buildPath(`/chart_of_accounts/${args.id}`));
+        return jsonResponse(result);
+    }));
     server.registerTool("list_qbo_customers", {
-        description: "List QuickBooks customers with optional search",
+        description: "List QuickBooks customers with pagination and optional search",
         inputSchema: {
-            search: z.string().optional().describe("Search term"),
+            search: z.string().optional().describe("Search by customer name"),
+            page: z.number().int().positive().optional().describe("Page number (default: 1)"),
+            per_page: z.number().int().positive().optional().describe("Results per page"),
         },
     }, withErrorHandling(async (args) => {
         const params = new URLSearchParams();
         if (args.search)
             params.set("search", args.search);
+        if (args.page)
+            params.set("page", String(args.page));
+        if (args.per_page)
+            params.set("per_page", String(args.per_page));
         const query = params.toString();
         const path = `${apiClient.buildPath("/qbo_customers")}${query ? `?${query}` : ""}`;
         const result = await apiClient.get(path);
         return jsonResponse(result);
     }));
+    server.registerTool("get_qbo_customer", {
+        description: "Get a specific QuickBooks customer by ID",
+        inputSchema: {
+            id: z.number().int().positive().describe("QBO Customer ID"),
+        },
+    }, withErrorHandling(async (args) => {
+        const result = await apiClient.get(apiClient.buildPath(`/qbo_customers/${args.id}`));
+        return jsonResponse(result);
+    }));
     server.registerTool("list_qbo_classes", {
-        description: "List QuickBooks classes with optional search",
+        description: "List QuickBooks classes with pagination and optional search",
         inputSchema: {
-            search: z.string().optional().describe("Search term"),
+            search: z.string().optional().describe("Search by class name"),
+            page: z.number().int().positive().optional().describe("Page number (default: 1)"),
+            per_page: z.number().int().positive().optional().describe("Results per page"),
         },
     }, withErrorHandling(async (args) => {
         const params = new URLSearchParams();
         if (args.search)
             params.set("search", args.search);
+        if (args.page)
+            params.set("page", String(args.page));
+        if (args.per_page)
+            params.set("per_page", String(args.per_page));
         const query = params.toString();
         const path = `${apiClient.buildPath("/qbo_classes")}${query ? `?${query}` : ""}`;
         const result = await apiClient.get(path);
         return jsonResponse(result);
     }));
+    server.registerTool("get_qbo_class", {
+        description: "Get a specific QuickBooks class by ID",
+        inputSchema: {
+            id: z.number().int().positive().describe("QuickBooks Class ID"),
+        },
+    }, withErrorHandling(async (args) => {
+        const result = await apiClient.get(apiClient.buildPath(`/qbo_classes/${args.id}`));
+        return jsonResponse(result);
+    }));
     server.registerTool("list_send_to_supplier_templates", {
         description: "List email templates for sending POs to suppliers",
         inputSchema: {},
@@ -51,16 +96,14 @@ export function registerSupplementaryTools(server, apiClient) {
         return jsonResponse(templates);
     }));
     server.registerTool("forward_purchase_order", {
-        description: "Forward a purchase order to supplier(s) via email",
+        description: "Forward a purchase order to supplier(s) via email. The PO PDF is attached automatically.",
         inputSchema: {
             purchase_order_id: z.number().int().positive().describe("Purchase Order ID"),
-            emails: z.array(z.string().email()).describe("Recipient email addresses"),
-            cc: z.string().email().optional().describe("CC email address"),
-            notes: z.string().optional().describe("Email body / template text"),
-            email_subject: z.string().optional().describe("Email subject"),
-            template_label: z.string().optional().describe("Template label"),
-            save_template: z.boolean().optional().describe("Save as new template"),
-            is_default: z.boolean().optional().describe("Mark as default template"),
+            emails: z.string().describe("Comma-separated recipient email addresses"),
+            cc: z.string().optional().describe("CC email address (defaults to PO creator's email)"),
+            note: z.string().optional().describe("Email body / note text"),
+            email_subject: z.string().optional().describe("Email subject line"),
+            uploads: z.array(z.number().int()).optional().describe("Upload IDs to attach (must belong to this PO)"),
         },
     }, withErrorHandling(async (args) => {
         const { purchase_order_id, ...data } = args;

package/dist/tools/suppliers.js

@@ -2,27 +2,45 @@ import { z } from "zod";
 import { jsonResponse, withErrorHandling } from "../tool-helpers.js";
 export function registerSupplierTools(server, apiClient) {
     server.registerTool("list_suppliers", {
-        description: "List suppliers with pagination and filters",
+        description: "List suppliers. When page param is provided, returns paginated response with meta (20 per page). Without page param, returns all suppliers as an array. Supports search by name and filtering by department/archived status.",
         inputSchema: {
-            page: z.number().int().positive().optional().describe("Page number"),
-            department_id: z.number().int().optional().describe("Filter by department ID"),
-            archived: z.boolean().optional().describe("Filter by archived status"),
-            top: z.number().int().positive().optional().describe("Limit to top N suppliers"),
+            page: z.number().int().positive().optional().describe("Page number — enables pagination (20 per page)"),
+            search: z.string().optional().describe("Search suppliers by name"),
+            department_id: z.number().int().optional().describe("Filter by department ID (includes suppliers without departments)"),
+            archived: z.boolean().optional().describe("Filter by archived status (default: false)"),
+            show_mappings: z.boolean().optional().describe("Include third-party ID mappings in response"),
         },
     }, withErrorHandling(async (args) => {
         const params = new URLSearchParams();
         if (args.page)
             params.set("page", String(args.page));
+        if (args.search)
+            params.set("search", args.search);
         if (args.department_id)
             params.set("department_id", String(args.department_id));
         if (args.archived !== undefined)
             params.set("archived", String(args.archived));
+        if (args.show_mappings)
+            params.set("show_mappings", "true");
+        const query = params.toString();
+        const path = `${apiClient.buildPath("/suppliers")}${query ? `?${query}` : ""}`;
+        const result = await apiClient.get(path);
+        return jsonResponse(result);
+    }));
+    server.registerTool("get_top_suppliers", {
+        description: "Get the user's most frequently used suppliers",
+        inputSchema: {
+            top: z.number().int().positive().optional().describe("Number of top suppliers to return (default: 5)"),
+            archived: z.boolean().optional().describe("Include archived suppliers"),
+        },
+    }, withErrorHandling(async (args) => {
+        const params = new URLSearchParams();
         if (args.top)
             params.set("top", String(args.top));
+        if (args.archived !== undefined)
+            params.set("archived", String(args.archived));
         const query = params.toString();
-        const path = args.top
-            ? `${apiClient.buildPath("/suppliers/top")}?${query}`
-            : `${apiClient.buildPath("/suppliers")}${query ? `?${query}` : ""}`;
+        const path = `${apiClient.buildPath("/suppliers/top")}${query ? `?${query}` : ""}`;
         const result = await apiClient.get(path);
         return jsonResponse(result);
     }));
@@ -36,24 +54,22 @@ export function registerSupplierTools(server, apiClient) {
         return jsonResponse(supplier);
     }));
     server.registerTool("create_supplier", {
-        description: "Create a new supplier (name must be unique)",
+        description: "Create a new supplier (name must be unique within the company). If company has supplier approval enabled, creates a pending approval request instead.",
         inputSchema: {
             name: z.string().describe("Supplier name (must be unique)"),
-            email: z.string().email().optional().describe("Supplier email"),
+            email: z.string().optional().describe("Supplier email"),
             address: z.string().optional().describe("Address"),
             notes: z.string().optional().describe("Notes"),
-            payment_details: z.string().optional().describe("Payment details"),
+            payment_details: z.string().optional().describe("Payment details/bank info"),
             phone_number: z.string().optional().describe("Phone number"),
             tax_number: z.string().optional().describe("Tax number"),
-            contact_person: z.string().optional().describe("Contact person"),
-            department_ids: z.array(z.number().int()).optional().describe("Department IDs"),
+            contact_person: z.string().optional().describe("Contact person name"),
+            uei: z.string().optional().describe("Unique Entity Identifier (UEI) for SAM.gov"),
+            cage_code: z.string().optional().describe("CAGE code for government contracting"),
+            department_ids: z.array(z.number().int()).optional().describe("Department IDs to restrict supplier to"),
         },
     }, withErrorHandling(async (args) => {
-        const { department_ids, ...supplierData } = args;
-        const body = { supplier: supplierData };
-        if (department_ids)
-            body.department_ids = department_ids;
-        const supplier = await apiClient.post(apiClient.buildPath("/suppliers"), body);
+        const supplier = await apiClient.post(apiClient.buildPath("/suppliers"), { supplier: args });
         return jsonResponse(supplier);
     }));
     server.registerTool("update_supplier", {
@@ -61,7 +77,7 @@ export function registerSupplierTools(server, apiClient) {
         inputSchema: {
             id: z.number().int().positive().describe("Supplier ID"),
             name: z.string().optional().describe("Supplier name"),
-            email: z.string().email().optional().describe("Email"),
+            email: z.string().optional().describe("Email"),
             address: z.string().optional().describe("Address"),
             notes: z.string().optional().describe("Notes"),
             payment_details: z.string().optional().describe("Payment details"),
@@ -69,6 +85,9 @@ export function registerSupplierTools(server, apiClient) {
             archived: z.boolean().optional().describe("Archive status"),
             tax_number: z.string().optional().describe("Tax number"),
             contact_person: z.string().optional().describe("Contact person"),
+            uei: z.string().optional().describe("Unique Entity Identifier (UEI)"),
+            cage_code: z.string().optional().describe("CAGE code"),
+            department_ids: z.array(z.number().int()).optional().describe("Department IDs"),
         },
     }, withErrorHandling(async (args) => {
         const { id, ...data } = args;

package/dist/tools/tax-rates.js

@@ -2,10 +2,17 @@ import { z } from "zod";
 import { jsonResponse, withErrorHandling } from "../tool-helpers.js";
 export function registerTaxRateTools(server, apiClient) {
     server.registerTool("list_tax_rates", {
-        description: "List all tax rates (single and combined types)",
-        inputSchema: {},
-    }, withErrorHandling(async () => {
-        const taxRates = await apiClient.get(apiClient.buildPath("/tax_rates"));
+        description: "List tax rates for the current company, filtered by archived status",
+        inputSchema: {
+            archived: z.boolean().optional().describe("Filter by archived status (default: false)"),
+        },
+    }, withErrorHandling(async (args) => {
+        const params = new URLSearchParams();
+        if (args.archived !== undefined)
+            params.set("archived", String(args.archived));
+        const query = params.toString();
+        const path = `${apiClient.buildPath("/tax_rates")}${query ? `?${query}` : ""}`;
+        const taxRates = await apiClient.get(path);
         return jsonResponse(taxRates);
     }));
     server.registerTool("get_tax_rate", {
@@ -18,11 +25,10 @@ export function registerTaxRateTools(server, apiClient) {
         return jsonResponse(taxRate);
     }));
     server.registerTool("create_tax_rate", {
-        description: "Create a new tax rate",
+        description: "Create a new tax rate for the current company",
         inputSchema: {
-            name: z.string().describe("Tax rate name"),
-            value: z.number().describe("Tax rate value (percentage)"),
-            company_id: z.number().int().describe("Company ID"),
+            name: z.string().describe("Tax rate name (e.g. 'VAT 20%')"),
+            value: z.number().describe("Tax rate percentage value (e.g. 20 for 20%)"),
         },
     }, withErrorHandling(async (args) => {
         const taxRate = await apiClient.post(apiClient.buildPath("/tax_rates"), { tax_rate: args });
@@ -33,7 +39,7 @@ export function registerTaxRateTools(server, apiClient) {
         inputSchema: {
             id: z.number().int().positive().describe("Tax Rate ID"),
             name: z.string().optional().describe("Tax rate name"),
-            value: z.number().optional().describe("Tax rate value"),
+            value: z.number().optional().describe("Tax rate percentage value"),
             archived: z.boolean().optional().describe("Archive status"),
         },
     }, withErrorHandling(async (args) => {

package/dist/tools/users.js

@@ -9,26 +9,29 @@ export function registerUserTools(server, apiClient) {
         return jsonResponse(user);
     }));
     server.registerTool("update_current_user", {
-        description: "Update the current user's profile (email, name, phone number, password)",
+        description: "Update the current user's profile. Include password_confirmation when changing password.",
         inputSchema: {
             email: z.string().email().optional().describe("New email address"),
-            name: z.string().optional().describe("New name"),
-            phone_number: z.string().optional().describe("New phone number"),
+            name: z.string().optional().describe("Full name"),
+            first_name: z.string().optional().describe("First name"),
+            last_name: z.string().optional().describe("Last name"),
+            phone_number: z.string().optional().describe("Phone number"),
             password: z.string().optional().describe("New password"),
+            password_confirmation: z.string().optional().describe("Password confirmation (required when changing password)"),
         },
     }, withErrorHandling(async (args) => {
         const user = await apiClient.put(apiClient.buildPath("/currentuser"), args);
         return jsonResponse(user);
     }));
     server.registerTool("list_currencies", {
-        description: "List enabled currencies for the current company",
+        description: "List currencies enabled for the current company (company default currency listed first)",
         inputSchema: {},
     }, withErrorHandling(async () => {
         const currencies = await apiClient.get(apiClient.buildPath("/currencies"));
         return jsonResponse(currencies);
     }));
     server.registerTool("list_all_currencies", {
-        description: "List all available currencies globally",
+        description: "List all available currencies globally, sorted by name (or by most popular if company ID is set)",
         inputSchema: {},
     }, withErrorHandling(async () => {
         const currencies = await apiClient.get(apiClient.buildPath("/all_currencies"));