jobber-mcp-server 1.0.0

package/dist/tools/clients.js

@@ -0,0 +1,186 @@
+/**
+ * MCP tools for Jobber client/customer operations.
+ */
+import { z } from "zod";
+import { jobberRequest, SEARCH_CLIENTS, GET_CLIENT, CREATE_CLIENT, UPDATE_CLIENT, } from "../graphql/queries.js";
+import { extractUserErrors } from "../utils/errors.js";
+import { formatErrorForMCP } from "../utils/errors.js";
+export function registerClientTools(server) {
+    // ── Search Clients ───────────────────────────────────────────────
+    server.tool("jobber_search_clients", "Search for clients (customers) in Jobber by name, email, or phone number. Returns matching clients with their contact info, address, and tags. Use this to find existing clients before creating new ones.", {
+        search_term: z
+            .string()
+            .describe("The search query — can be a name, email address, or phone number. Jobber searches across all contact fields."),
+        limit: z
+            .number()
+            .min(1)
+            .max(50)
+            .default(10)
+            .describe("Maximum number of results to return. Default 10, max 50."),
+    }, async ({ search_term, limit }) => {
+        try {
+            const data = await jobberRequest(SEARCH_CLIENTS, {
+                searchTerm: search_term,
+                first: limit,
+            });
+            const clients = data.clients;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            total_count: clients.totalCount,
+                            clients: clients.nodes,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Get Client ───────────────────────────────────────────────────
+    server.tool("jobber_get_client", "Get full details for a specific Jobber client by their ID. Returns contact info, properties (service addresses), and recent job history. Use this after searching to get complete client information.", {
+        client_id: z
+            .string()
+            .describe("The Jobber client ID (encoded ID format, e.g. 'Z2lkOi8vSm9iYmVyL0NsaWVudC8xMjM='). Get this from search results."),
+    }, async ({ client_id }) => {
+        try {
+            const data = await jobberRequest(GET_CLIENT, { id: client_id });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(data.client, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Create Client ────────────────────────────────────────────────
+    server.tool("jobber_create_client", "Create a new client (customer) in Jobber. Always search for existing clients first to avoid duplicates. Returns the new client's ID and Jobber web URL.", {
+        first_name: z.string().describe("Client's first name"),
+        last_name: z.string().describe("Client's last name"),
+        email: z
+            .string()
+            .optional()
+            .describe("Client's email address. Recommended for sending quotes/invoices."),
+        phone: z
+            .string()
+            .optional()
+            .describe("Client's phone number. Include country code if applicable (e.g. '+14165551234')."),
+        company_name: z
+            .string()
+            .optional()
+            .describe("Company name if this is a commercial/business client. Sets isCompany=true."),
+        street1: z.string().optional().describe("Street address line 1"),
+        street2: z.string().optional().describe("Street address line 2 (unit, suite, etc.)"),
+        city: z.string().optional().describe("City"),
+        province: z.string().optional().describe("Province/state (2-letter code, e.g. 'ON', 'CA')"),
+        postal_code: z.string().optional().describe("Postal/ZIP code"),
+    }, async ({ first_name, last_name, email, phone, company_name, street1, street2, city, province, postal_code, }) => {
+        try {
+            const input = {
+                firstName: first_name,
+                lastName: last_name,
+            };
+            if (company_name) {
+                input.companyName = company_name;
+                input.isCompany = true;
+            }
+            if (phone) {
+                input.phones = [
+                    { number: phone, description: "MAIN", primary: true },
+                ];
+            }
+            if (email) {
+                input.emails = [
+                    { address: email, description: "MAIN", primary: true },
+                ];
+            }
+            if (street1) {
+                input.billingAddress = {
+                    street1,
+                    street2: street2 ?? "",
+                    city: city ?? "",
+                    province: province ?? "",
+                    postalCode: postal_code ?? "",
+                };
+            }
+            const data = await jobberRequest(CREATE_CLIENT, { input });
+            const result = data.clientCreate;
+            const userErr = extractUserErrors(result);
+            if (userErr) {
+                return {
+                    content: [{ type: "text", text: `Failed to create client: ${userErr}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result.client, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Update Client ────────────────────────────────────────────────
+    server.tool("jobber_update_client", "Update an existing Jobber client's information. Only provide the fields you want to change — omitted fields remain unchanged.", {
+        client_id: z.string().describe("The Jobber client ID to update"),
+        first_name: z.string().optional().describe("Updated first name"),
+        last_name: z.string().optional().describe("Updated last name"),
+        email: z.string().optional().describe("Updated email address"),
+        phone: z.string().optional().describe("Updated phone number"),
+        company_name: z.string().optional().describe("Updated company name"),
+    }, async ({ client_id, first_name, last_name, email, phone, company_name }) => {
+        try {
+            const input = {};
+            if (first_name)
+                input.firstName = first_name;
+            if (last_name)
+                input.lastName = last_name;
+            if (company_name)
+                input.companyName = company_name;
+            if (phone) {
+                input.phones = [
+                    { number: phone, description: "MAIN", primary: true },
+                ];
+            }
+            if (email) {
+                input.emails = [
+                    { address: email, description: "MAIN", primary: true },
+                ];
+            }
+            const data = await jobberRequest(UPDATE_CLIENT, {
+                clientId: client_id,
+                input,
+            });
+            const result = data.clientUpdate;
+            const userErr = extractUserErrors(result);
+            if (userErr) {
+                return {
+                    content: [{ type: "text", text: `Failed to update client: ${userErr}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result.client, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+}
+//# sourceMappingURL=clients.js.map

package/dist/tools/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/tools/clients.ts"],"names":[],"mappings":"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"}

package/dist/tools/invoices.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Jobber invoice operations.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerInvoiceTools(server: McpServer): void;
+//# sourceMappingURL=invoices.d.ts.map

package/dist/tools/invoices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0E5D"}

package/dist/tools/invoices.js

@@ -0,0 +1,64 @@
+/**
+ * MCP tools for Jobber invoice operations.
+ */
+import { z } from "zod";
+import { jobberRequest, LIST_INVOICES, GET_INVOICE, } from "../graphql/queries.js";
+import { formatErrorForMCP } from "../utils/errors.js";
+export function registerInvoiceTools(server) {
+    // ── List Invoices ────────────────────────────────────────────────
+    server.tool("jobber_list_invoices", "List invoices in Jobber. Returns invoices with status (draft, sent, paid, overdue, etc.), amounts, dates, and client info. Supports pagination.", {
+        limit: z
+            .number()
+            .min(1)
+            .max(50)
+            .default(20)
+            .describe("Maximum number of invoices to return. Default 20, max 50."),
+        after: z
+            .string()
+            .optional()
+            .describe("Pagination cursor for the next page."),
+    }, async ({ limit, after }) => {
+        try {
+            const variables = { first: limit };
+            if (after)
+                variables.after = after;
+            const data = await jobberRequest(LIST_INVOICES, variables);
+            const invoices = data.invoices;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            total_count: invoices.totalCount,
+                            invoices: invoices.nodes,
+                            page_info: invoices.pageInfo,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Get Invoice ──────────────────────────────────────────────────
+    server.tool("jobber_get_invoice", "Get full details for a specific invoice by ID. Returns line items, amounts, payment status, due date, and client contact info.", {
+        invoice_id: z.string().describe("The Jobber invoice ID"),
+    }, async ({ invoice_id }) => {
+        try {
+            const data = await jobberRequest(GET_INVOICE, { id: invoice_id });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(data.invoice, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+}
+//# sourceMappingURL=invoices.js.map

package/dist/tools/invoices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.js","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,oEAAoE;IACpE,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,iJAAiJ,EACjJ;QACE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,2DAA2D,CAAC;QACxE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sCAAsC,CAAC;KACpD,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,SAAS,GAA4B,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC5D,IAAI,KAAK;gBAAE,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;YAEnC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAIrB,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,WAAW,EAAE,QAAQ,CAAC,UAAU;4BAChC,QAAQ,EAAE,QAAQ,CAAC,KAAK;4BACxB,SAAS,EAAE,QAAQ,CAAC,QAAQ;yBAC7B,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,oEAAoE;IACpE,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,gIAAgI,EAChI;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KACzD,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/jobs.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Jobber job operations.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerJobTools(server: McpServer): void;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/tools/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoPxD"}

package/dist/tools/jobs.js

@@ -0,0 +1,205 @@
+/**
+ * MCP tools for Jobber job operations.
+ */
+import { z } from "zod";
+import { jobberRequest, LIST_JOBS, GET_JOB, CREATE_JOB, CREATE_JOB_NOTE, } from "../graphql/queries.js";
+import { extractUserErrors, formatErrorForMCP } from "../utils/errors.js";
+export function registerJobTools(server) {
+    // ── List Jobs ────────────────────────────────────────────────────
+    server.tool("jobber_list_jobs", "List jobs in Jobber with optional filters. Returns jobs with status, client, schedule, and total. Use this to find active work, check job history, or look up jobs for a specific client.", {
+        status: z
+            .array(z.enum([
+            "ACTIVE",
+            "IN_PROGRESS",
+            "COMPLETED",
+            "ARCHIVED",
+            "TODAY",
+            "UPCOMING",
+            "OVERDUE",
+            "UNSCHEDULED",
+            "LATE",
+            "ON_HOLD",
+            "ACTION_REQUIRED",
+        ]))
+            .optional()
+            .describe("Filter by job status. Common values: ACTIVE, IN_PROGRESS, COMPLETED, ARCHIVED. Can pass multiple. Omit for all statuses."),
+        start_date: z
+            .string()
+            .optional()
+            .describe("Filter jobs starting on or after this date. ISO 8601 format (YYYY-MM-DD)."),
+        end_date: z
+            .string()
+            .optional()
+            .describe("Filter jobs starting on or before this date. ISO 8601 format (YYYY-MM-DD)."),
+        limit: z
+            .number()
+            .min(1)
+            .max(50)
+            .default(20)
+            .describe("Maximum number of jobs to return. Default 20, max 50."),
+        after: z
+            .string()
+            .optional()
+            .describe("Pagination cursor for the next page."),
+    }, async ({ status, start_date, end_date, limit, after }) => {
+        try {
+            const filter = {};
+            if (status && status.length > 0) {
+                filter.status = status;
+            }
+            if (start_date || end_date) {
+                filter.startAt = {
+                    between: {
+                        start: start_date ?? "2000-01-01",
+                        end: end_date ?? "2100-01-01",
+                    },
+                };
+            }
+            const variables = {
+                first: limit,
+                filter: Object.keys(filter).length > 0 ? filter : undefined,
+            };
+            if (after)
+                variables.after = after;
+            const data = await jobberRequest(LIST_JOBS, variables);
+            const jobs = data.jobs;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            total_count: jobs.totalCount,
+                            jobs: jobs.nodes,
+                            page_info: jobs.pageInfo,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Get Job ──────────────────────────────────────────────────────
+    server.tool("jobber_get_job", "Get full details for a specific job by ID. Returns comprehensive info including line items, scheduled visits, assigned team members, client contact info, and property address.", {
+        job_id: z.string().describe("The Jobber job ID"),
+    }, async ({ job_id }) => {
+        try {
+            const data = await jobberRequest(GET_JOB, { id: job_id });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(data.job, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Create Job ───────────────────────────────────────────────────
+    server.tool("jobber_create_job", "Create a new job in Jobber. A job represents actual work to be done for a client. Provide a client ID and job details. Line items define the billable work.", {
+        client_id: z.string().describe("The Jobber client ID this job is for"),
+        title: z
+            .string()
+            .describe("Job title (e.g. 'Kitchen faucet replacement', 'Drain cleaning')"),
+        description: z
+            .string()
+            .optional()
+            .describe("Detailed job description or instructions for the technician"),
+        line_items: z
+            .array(z.object({
+            name: z.string().describe("Line item name (e.g. 'Labour', 'Parts - Kitchen Faucet')"),
+            description: z.string().optional().describe("Line item description"),
+            quantity: z.number().default(1).describe("Quantity. Default 1."),
+            unit_price: z
+                .number()
+                .describe("Unit price in dollars (e.g. 150.00)"),
+        }))
+            .optional()
+            .describe("Line items for the job. Each has a name, optional description, quantity, and unit price."),
+        property_id: z
+            .string()
+            .optional()
+            .describe("Property ID for the service location. Get from client details."),
+    }, async ({ client_id, title, description, line_items, property_id }) => {
+        try {
+            const input = {
+                clientId: client_id,
+                title,
+            };
+            if (property_id)
+                input.propertyId = property_id;
+            if (line_items && line_items.length > 0) {
+                input.lineItems = line_items.map((li) => ({
+                    name: li.name,
+                    description: li.description ?? "",
+                    qty: li.quantity,
+                    unitPrice: li.unit_price,
+                    saveToProductsAndServices: false,
+                }));
+            }
+            const data = await jobberRequest(CREATE_JOB, { input });
+            const result = data.jobCreate;
+            const userErr = extractUserErrors(result);
+            if (userErr) {
+                return {
+                    content: [{ type: "text", text: `Failed to create job: ${userErr}` }],
+                    isError: true,
+                };
+            }
+            const job = result.job;
+            // Add description as a note if provided
+            if (description && job.id) {
+                try {
+                    await jobberRequest(CREATE_JOB_NOTE, {
+                        jobId: job.id,
+                        message: description,
+                    });
+                }
+                catch {
+                    console.error("[jobber-mcp] Failed to add note to job");
+                }
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(job, null, 2) }],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Update Job Status ────────────────────────────────────────────
+    server.tool("jobber_update_job_status", "Add a note to a job in Jobber. Use this to log status updates, technician notes, or diagnostic findings. Note: Jobber's GraphQL API doesn't support direct status transitions — use the Jobber web UI for that.", {
+        job_id: z.string().describe("The Jobber job ID"),
+        note: z
+            .string()
+            .describe("Note to add to the job (e.g. 'Customer confirmed appointment', 'Parts ordered — ETA 2 days')"),
+    }, async ({ job_id, note }) => {
+        try {
+            const data = await jobberRequest(CREATE_JOB_NOTE, {
+                jobId: job_id,
+                message: note,
+            });
+            const result = data.jobNoteCreate;
+            const userErr = extractUserErrors(result);
+            if (userErr) {
+                return {
+                    content: [{ type: "text", text: `Failed to add note: ${userErr}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Note added to job ${job_id} successfully.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+}
+//# sourceMappingURL=jobs.js.map

package/dist/tools/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"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"}

package/dist/tools/quotes.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Jobber quote operations.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerQuoteTools(server: McpServer): void;
+//# sourceMappingURL=quotes.d.ts.map

package/dist/tools/quotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotes.d.ts","sourceRoot":"","sources":["../../src/tools/quotes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+H1D"}

package/dist/tools/quotes.js

@@ -0,0 +1,113 @@
+/**
+ * MCP tools for Jobber quote operations.
+ */
+import { z } from "zod";
+import { jobberRequest, CREATE_QUOTE, LIST_QUOTES, } from "../graphql/queries.js";
+import { extractUserErrors, formatErrorForMCP } from "../utils/errors.js";
+export function registerQuoteTools(server) {
+    // ── Create Quote ─────────────────────────────────────────────────
+    server.tool("jobber_create_quote", "Create a new quote (estimate) for a Jobber client. The quote is created as a draft — it won't be sent to the client automatically. Include line items with pricing to build the quote total.", {
+        client_id: z.string().describe("The Jobber client ID to create the quote for"),
+        title: z
+            .string()
+            .describe("Quote title (e.g. 'Kitchen faucet replacement estimate')"),
+        message: z
+            .string()
+            .optional()
+            .describe("Message to the client included with the quote. Supports plain text."),
+        line_items: z
+            .array(z.object({
+            name: z
+                .string()
+                .describe("Line item name (e.g. 'Labour - Faucet Installation')"),
+            description: z.string().optional().describe("Line item description"),
+            quantity: z.number().default(1).describe("Quantity. Default 1."),
+            unit_price: z
+                .number()
+                .describe("Unit price in dollars (e.g. 250.00)"),
+        }))
+            .min(1)
+            .describe("At least one line item is required for a quote."),
+        property_id: z
+            .string()
+            .optional()
+            .describe("Property ID for the service location"),
+    }, async ({ client_id, title, message, line_items, property_id }) => {
+        try {
+            const attributes = {
+                clientId: client_id,
+                title,
+                lineItems: line_items.map((li) => ({
+                    name: li.name,
+                    description: li.description ?? "",
+                    qty: li.quantity,
+                    unitPrice: li.unit_price,
+                    saveToProductsAndServices: false,
+                })),
+            };
+            if (message)
+                attributes.message = message;
+            if (property_id)
+                attributes.propertyId = property_id;
+            const data = await jobberRequest(CREATE_QUOTE, { attributes });
+            const result = data.quoteCreate;
+            const userErr = extractUserErrors(result);
+            if (userErr) {
+                return {
+                    content: [
+                        { type: "text", text: `Failed to create quote: ${userErr}` },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result.quote, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── List Quotes ──────────────────────────────────────────────────
+    server.tool("jobber_list_quotes", "List quotes in Jobber. Returns quotes with their status, total, client, and Jobber web URL. Supports pagination.", {
+        limit: z
+            .number()
+            .min(1)
+            .max(50)
+            .default(20)
+            .describe("Maximum number of quotes to return. Default 20, max 50."),
+        after: z
+            .string()
+            .optional()
+            .describe("Pagination cursor for the next page."),
+    }, async ({ limit, after }) => {
+        try {
+            const variables = { first: limit };
+            if (after)
+                variables.after = after;
+            const data = await jobberRequest(LIST_QUOTES, variables);
+            const quotes = data.quotes;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            total_count: quotes.totalCount,
+                            quotes: quotes.nodes,
+                            page_info: quotes.pageInfo,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+}
+//# sourceMappingURL=quotes.js.map

package/dist/tools/quotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotes.js","sourceRoot":"","sources":["../../src/tools/quotes.ts"],"names":[],"mappings":"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"}

package/dist/tools/requests.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Jobber service request operations.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRequestTools(server: McpServer): void;
+//# sourceMappingURL=requests.d.ts.map

package/dist/tools/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../src/tools/requests.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgJ5D"}