@kynver-app/mcp-estimator 0.1.1

package/src/tools/client-tools.ts

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_create_client ---
+
+const createClientSchema = z.object({
+  name: z.string(),
+  companyId: z.string().optional(),
+  title: z.string().optional(),
+  phone: z.string().optional(),
+  email: z.string().optional(),
+  address: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const createClient = {
+  name: "estimator_create_client",
+  description: "Create a new client (individual person) in the client book. Clients can optionally belong to a company (pass companyId). Include contact details: name (required), title, phone, email, address, and notes. The client can then be linked to estimates via their clientId.",
+  inputSchemaZod: createClientSchema,
+  execute: async (args: z.infer<typeof createClientSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post("/estimator/clients", args);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_list_clients ---
+
+const listClientsSchema = z.object({
+  search: z.string().optional(),
+  companyId: z.string().optional(),
+  limit: z.number().optional(),
+  cursor: z.string().optional(),
+});
+
+export const listClients = {
+  name: "estimator_list_clients",
+  description: "Search and list clients in the client book. Use the search param to find clients by name, phone, or email. Filter by companyId to see all contacts at a specific company. Returns client details with linked company info. Always search here before creating a new client to avoid duplicates.",
+  inputSchemaZod: listClientsSchema,
+  execute: async (args: z.infer<typeof listClientsSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+
+    const params = new URLSearchParams();
+    if (args.search) params.set("search", args.search);
+    if (args.companyId) params.set("companyId", args.companyId);
+    if (args.limit != null) params.set("limit", String(args.limit));
+    if (args.cursor) params.set("cursor", args.cursor);
+
+    const q = params.toString();
+    const path = q ? `/estimator/clients?${q}` : "/estimator/clients";
+
+    const data = await client.get<unknown>(path);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_get_client ---
+
+const getClientSchema = z.object({
+  clientId: z.string(),
+});
+
+export const getClient = {
+  name: "estimator_get_client",
+  description: "Get a specific client's full details including their company info and a summary of linked estimates (recent 10). Use this to see a client's estimate history before creating new ones.",
+  inputSchemaZod: getClientSchema,
+  execute: async (args: z.infer<typeof getClientSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.get<unknown>(`/estimator/clients/${args.clientId}`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_update_client ---
+
+const updateClientSchema = z.object({
+  clientId: z.string(),
+  name: z.string().optional(),
+  companyId: z.string().optional(),
+  title: z.string().optional(),
+  phone: z.string().optional(),
+  email: z.string().optional(),
+  address: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const updateClient = {
+  name: "estimator_update_client",
+  description: "Update a client's contact details. Pass the clientId and any fields to change: name, title, phone, email, address, notes, or companyId (to move them to a different company).",
+  inputSchemaZod: updateClientSchema,
+  execute: async (args: z.infer<typeof updateClientSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { clientId, ...body } = args;
+    const data = await client.patch(`/estimator/clients/${clientId}`, body);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_delete_client ---
+
+const deleteClientSchema = z.object({
+  clientId: z.string(),
+});
+
+export const deleteClient = {
+  name: "estimator_delete_client",
+  description: "Soft-delete a client from the client book. The client's data is preserved but hidden from searches. Existing estimates linked to this client are not affected.",
+  inputSchemaZod: deleteClientSchema,
+  execute: async (args: z.infer<typeof deleteClientSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.del(`/estimator/clients/${args.clientId}`);
+    return JSON.stringify(data);
+  },
+};

package/src/tools/company-tools.ts

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_create_company ---
+
+const createCompanySchema = z.object({
+  name: z.string(),
+  phone: z.string().optional(),
+  email: z.string().optional(),
+  address: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const createCompany = {
+  name: "estimator_create_company",
+  description: "Create a new company in the client book. Companies group clients (contacts) together. Include: name (required), phone, email, address, and notes. After creating, you can add clients to the company using estimator_create_client with the companyId.",
+  inputSchemaZod: createCompanySchema,
+  execute: async (args: z.infer<typeof createCompanySchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post("/estimator/companies", args);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_list_companies ---
+
+const listCompaniesSchema = z.object({
+  search: z.string().optional(),
+  limit: z.number().optional(),
+  cursor: z.string().optional(),
+});
+
+export const listCompanies = {
+  name: "estimator_list_companies",
+  description: "Search and list companies in the client book. Use the search param to find companies by name. Returns company details with a count of contacts and estimates. Always search here before creating a new company to avoid duplicates.",
+  inputSchemaZod: listCompaniesSchema,
+  execute: async (args: z.infer<typeof listCompaniesSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+
+    const params = new URLSearchParams();
+    if (args.search) params.set("search", args.search);
+    if (args.limit != null) params.set("limit", String(args.limit));
+    if (args.cursor) params.set("cursor", args.cursor);
+
+    const q = params.toString();
+    const path = q ? `/estimator/companies?${q}` : "/estimator/companies";
+
+    const data = await client.get<unknown>(path);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_get_company ---
+
+const getCompanySchema = z.object({
+  companyId: z.string(),
+});
+
+export const getCompany = {
+  name: "estimator_get_company",
+  description: "Get a specific company's full details including all its client contacts and a summary of linked estimates.",
+  inputSchemaZod: getCompanySchema,
+  execute: async (args: z.infer<typeof getCompanySchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.get<unknown>(`/estimator/companies/${args.companyId}`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_update_company ---
+
+const updateCompanySchema = z.object({
+  companyId: z.string(),
+  name: z.string().optional(),
+  phone: z.string().optional(),
+  email: z.string().optional(),
+  address: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const updateCompany = {
+  name: "estimator_update_company",
+  description: "Update a company's details. Pass the companyId and any fields to change: name, phone, email, address, or notes.",
+  inputSchemaZod: updateCompanySchema,
+  execute: async (args: z.infer<typeof updateCompanySchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { companyId, ...body } = args;
+    const data = await client.patch(`/estimator/companies/${companyId}`, body);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_delete_company ---
+
+const deleteCompanySchema = z.object({
+  companyId: z.string(),
+});
+
+export const deleteCompany = {
+  name: "estimator_delete_company",
+  description: "Soft-delete a company from the client book. The company's data is preserved but hidden. Clients belonging to this company are NOT deleted — they become unlinked.",
+  inputSchemaZod: deleteCompanySchema,
+  execute: async (args: z.infer<typeof deleteCompanySchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.del(`/estimator/companies/${args.companyId}`);
+    return JSON.stringify(data);
+  },
+};

package/src/tools/estimate-tools.ts

@@ -0,0 +1,281 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_create_replacement ---
+
+const createReplacementSchema = z.object({
+  projectName: z.string(),
+  roofMaterial: z.string(),
+  footprintSqFt: z.number().optional(),
+  roofAreaSqFt: z.number().optional(),
+  pitch: z.string().optional(),
+  layers: z.number().optional(),
+  ridgeLengthFt: z.number(),
+  hipLengthFt: z.number().optional(),
+  valleyLengthFt: z.number().optional(),
+  eavesFt: z.number(),
+  rakeFt: z.number().optional(),
+  wastePercent: z.number().optional(),
+  clientId: z.string().optional(),
+  companyId: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const createReplacement = {
+  name: "estimator_create_replacement",
+  description:
+    "Create a full roof replacement estimate from dimensions. The system calculates line items automatically from the roof measurements using catalog prices. Requires: projectName, roofMaterial (asphalt, metal, tpo, etc.), ridgeLengthFt, eavesFt. Optional: footprintSqFt, roofAreaSqFt, pitch, layers, hipLengthFt, valleyLengthFt, rakeFt, wastePercent. PREREQUISITE: The user must have catalog items set up for the specified roofMaterial — call estimator_get_catalog first to verify.",
+  inputSchemaZod: createReplacementSchema,
+  execute: async (args: z.infer<typeof createReplacementSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { projectName, clientId, companyId, notes, ...measurements } = args;
+    const data = await client.post("/estimator/estimates", {
+      type: "replacement",
+      projectName,
+      roofMaterial: measurements.roofMaterial,
+      inputs: measurements,
+      clientId,
+      companyId,
+      notes,
+    });
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_create_repair ---
+
+const repairLineSchema = z.object({
+  serviceCode: z.string(),
+  materialType: z.string().nullable().optional(),
+  quantity: z.number(),
+  notes: z.string().optional(),
+});
+
+const createRepairSchema = z.object({
+  projectName: z.string(),
+  roofMaterial: z.string().optional(),
+  lineItems: z.array(repairLineSchema),
+  clientId: z.string().optional(),
+  companyId: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const createRepair = {
+  name: "estimator_create_repair",
+  description:
+    "Create a repair/service estimate with specific line items. Each line item needs a serviceCode that exists in the user's catalog — ALWAYS call estimator_get_catalog first to get valid service codes. Do not guess or invent codes. Pass: projectName, lineItems array (each with serviceCode, quantity, optional materialType and notes). Optionally link to a client/company via clientId/companyId.",
+  inputSchemaZod: createRepairSchema,
+  execute: async (args: z.infer<typeof createRepairSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post("/estimator/estimates", {
+      type: "repair_service",
+      projectName: args.projectName,
+      roofMaterial: args.roofMaterial,
+      lineItems: args.lineItems,
+      clientId: args.clientId,
+      companyId: args.companyId,
+      notes: args.notes,
+    });
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_get_estimate ---
+
+const getEstimateSchema = z.object({
+  id: z.string(),
+});
+
+export const getEstimate = {
+  name: "estimator_get_estimate",
+  description: "Get a specific estimate with all line items, totals (material, labor, grand total), status, client/company info, and metadata. Returns the complete estimate detail needed for viewing, editing, or reporting.",
+  inputSchemaZod: getEstimateSchema,
+  execute: async (args: z.infer<typeof getEstimateSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.get<unknown>(`/estimator/estimates/${args.id}`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_list_estimates ---
+
+const listEstimatesSchema = z.object({
+  status: z.string().optional(),
+  type: z.string().optional(),
+  clientId: z.string().optional(),
+  companyId: z.string().optional(),
+  from: z.string().optional(),
+  to: z.string().optional(),
+  limit: z.number().optional(),
+  cursor: z.string().optional(),
+});
+
+export const listEstimates = {
+  name: "estimator_list_estimates",
+  description:
+    "List the user's estimates with optional filters. Filter by: status (draft, sent, accepted, declined), type (replacement, repair_service), clientId, companyId, or date range (from/to as ISO strings like 2026-01-01). Returns summary info — use estimator_get_estimate for full details on a specific one.",
+  inputSchemaZod: listEstimatesSchema,
+  execute: async (args: z.infer<typeof listEstimatesSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+
+    const params = new URLSearchParams();
+    if (args.status) params.set("status", args.status);
+    if (args.type) params.set("type", args.type);
+    if (args.clientId) params.set("clientId", args.clientId);
+    if (args.companyId) params.set("companyId", args.companyId);
+    if (args.from) params.set("from", args.from);
+    if (args.to) params.set("to", args.to);
+    if (args.limit != null) params.set("limit", String(args.limit));
+    if (args.cursor) params.set("cursor", args.cursor);
+
+    const q = params.toString();
+    const path = q ? `/estimator/estimates?${q}` : "/estimator/estimates";
+
+    const data = await client.get<unknown>(path);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_add_line_item ---
+
+const addLineItemSchema = z.object({
+  estimateId: z.string(),
+  serviceCode: z.string(),
+  materialType: z.string().nullable().optional(),
+  quantity: z.number(),
+  notes: z.string().optional(),
+});
+
+export const addLineItem = {
+  name: "estimator_add_line_item",
+  description: "Add a line item to an existing estimate. The serviceCode must exist in the user's catalog — call estimator_get_catalog to verify. Pass: estimateId, serviceCode, quantity. Optionally add notes. The estimate totals are automatically recalculated.",
+  inputSchemaZod: addLineItemSchema,
+  execute: async (args: z.infer<typeof addLineItemSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { estimateId, ...body } = args;
+    const data = await client.post(`/estimator/estimates/${estimateId}/line-items`, body);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_remove_line_item ---
+
+const removeLineItemSchema = z.object({
+  estimateId: z.string(),
+  lineItemId: z.string(),
+});
+
+export const removeLineItem = {
+  name: "estimator_remove_line_item",
+  description: "Remove a line item from an estimate. Requires estimateId and lineItemId (get lineItemIds from estimator_get_estimate). The estimate totals are automatically recalculated.",
+  inputSchemaZod: removeLineItemSchema,
+  execute: async (args: z.infer<typeof removeLineItemSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.del(`/estimator/estimates/${args.estimateId}/line-items/${args.lineItemId}`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_update_line_item ---
+
+const updateLineItemSchema = z.object({
+  estimateId: z.string(),
+  lineItemId: z.string(),
+  quantity: z.number().optional(),
+  materialCost: z.number().optional(),
+  laborCost: z.number().optional(),
+  notes: z.string().optional(),
+});
+
+export const updateLineItem = {
+  name: "estimator_update_line_item",
+  description: "Update a line item's quantity, materialCost, laborCost, or notes on an existing estimate. Requires estimateId and lineItemId. Totals are recalculated automatically after the update.",
+  inputSchemaZod: updateLineItemSchema,
+  execute: async (args: z.infer<typeof updateLineItemSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { estimateId, lineItemId, ...body } = args;
+    const data = await client.patch(`/estimator/estimates/${estimateId}/line-items/${lineItemId}`, body);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_adjust_to_target ---
+
+const adjustToTargetSchema = z.object({
+  estimateId: z.string(),
+  targetTotal: z.number(),
+  strategy: z.enum(["uniform", "labor_only", "material_only"]).optional(),
+});
+
+export const adjustToTarget = {
+  name: "estimator_adjust_to_target",
+  description:
+    "Adjust all line items on an estimate to hit a specific target total price. Useful when a customer has a budget and you need to scale pricing to fit. Strategies: 'uniform' (default — scales all items proportionally), 'labor_only' (only adjusts labor costs), 'material_only' (only adjusts material costs). Requires estimateId and targetTotal.",
+  inputSchemaZod: adjustToTargetSchema,
+  execute: async (args: z.infer<typeof adjustToTargetSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { estimateId, ...body } = args;
+    const data = await client.post(`/estimator/estimates/${estimateId}/adjust`, body);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_update_estimate ---
+
+const updateEstimateSchema = z.object({
+  estimateId: z.string(),
+  projectName: z.string().optional(),
+  status: z.string().optional(),
+  clientId: z.string().optional(),
+  companyId: z.string().optional(),
+  notes: z.string().optional(),
+  siteAddress: z.string().optional(),
+});
+
+export const updateEstimate = {
+  name: "estimator_update_estimate",
+  description: "Update an estimate's metadata — project name, status (draft/sent/accepted/declined), site address, client/company linking, or notes. Does NOT modify line items (use add/remove/update line item tools for that). Pass estimateId and any fields to change.",
+  inputSchemaZod: updateEstimateSchema,
+  execute: async (args: z.infer<typeof updateEstimateSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { estimateId, ...body } = args;
+    const data = await client.patch(`/estimator/estimates/${estimateId}`, body);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_delete_estimate ---
+
+const deleteEstimateSchema = z.object({
+  estimateId: z.string(),
+});
+
+export const deleteEstimate = {
+  name: "estimator_delete_estimate",
+  description: "Soft-delete an estimate. The estimate data is preserved but hidden from list views. This cannot be easily undone.",
+  inputSchemaZod: deleteEstimateSchema,
+  execute: async (args: z.infer<typeof deleteEstimateSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.del(`/estimator/estimates/${args.estimateId}`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_duplicate_estimate ---
+
+const duplicateEstimateSchema = z.object({
+  estimateId: z.string(),
+  projectName: z.string().optional(),
+});
+
+export const duplicateEstimate = {
+  name: "estimator_duplicate_estimate",
+  description: "Create a copy of an existing estimate with all its line items, pricing, and configuration. Optionally give the copy a new projectName. Useful for creating similar estimates for different clients or properties.",
+  inputSchemaZod: duplicateEstimateSchema,
+  execute: async (args: z.infer<typeof duplicateEstimateSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { estimateId, ...body } = args;
+    const data = await client.post(`/estimator/estimates/${estimateId}/duplicate`, body);
+    return JSON.stringify(data);
+  },
+};

package/src/tools/photo-tools.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_upload_photo ---
+
+const uploadPhotoSchema = z.object({
+  estimateId: z.string(),
+  imageUrl: z.string(),
+  caption: z.string().optional(),
+});
+
+export const uploadPhoto = {
+  name: "estimator_upload_photo",
+  description:
+    "Attach a photo to an estimate by URL. The photo is downloaded and stored. Include a caption to describe what the photo shows (e.g., 'North-facing roof slope showing damaged shingles'). Photos can be included in PDF exports and analyzed with estimator_analyze_photos.",
+  inputSchemaZod: uploadPhotoSchema,
+  execute: async (args: z.infer<typeof uploadPhotoSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { estimateId, ...body } = args;
+    const data = await client.post(`/estimator/estimates/${estimateId}/photos`, body);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_list_photos ---
+
+const listPhotosSchema = z.object({
+  estimateId: z.string(),
+});
+
+export const listPhotos = {
+  name: "estimator_list_photos",
+  description: "List all photos attached to an estimate. Returns photo IDs, URLs, captions, and sort order. Use photo IDs when deleting photos or configuring PDF output.",
+  inputSchemaZod: listPhotosSchema,
+  execute: async (args: z.infer<typeof listPhotosSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.get<unknown>(`/estimator/estimates/${args.estimateId}/photos`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_delete_photo ---
+
+const deletePhotoSchema = z.object({
+  estimateId: z.string(),
+  photoId: z.string(),
+});
+
+export const deletePhoto = {
+  name: "estimator_delete_photo",
+  description: "Remove a photo from an estimate. Requires estimateId and photoId (get IDs from estimator_list_photos).",
+  inputSchemaZod: deletePhotoSchema,
+  execute: async (args: z.infer<typeof deletePhotoSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.del(
+      `/estimator/estimates/${args.estimateId}/photos/${args.photoId}`
+    );
+    return JSON.stringify(data);
+  },
+};

package/src/tools/stats-pdf-tools.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_get_stats ---
+
+const getStatsSchema = z.object({
+  from: z.string().optional(),
+  to: z.string().optional(),
+});
+
+export const getStats = {
+  name: "estimator_get_stats",
+  description: "Get aggregate statistics for the user's estimating business. Returns: total estimates count, estimates by status, total revenue (accepted estimates), average estimate value, estimates by type (replacement vs repair). Optionally filter by date range (from/to as ISO strings). Use this for dashboard data and business reporting.",
+  inputSchemaZod: getStatsSchema,
+  execute: async (args: z.infer<typeof getStatsSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+
+    const params = new URLSearchParams();
+    if (args.from) params.set("from", args.from);
+    if (args.to) params.set("to", args.to);
+
+    const q = params.toString();
+    const path = q ? `/estimator/stats?${q}` : "/estimator/stats";
+
+    const data = await client.get<unknown>(path);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_export_pdf ---
+
+const exportPdfSchema = z.object({
+  estimateId: z.string(),
+});
+
+export const exportPdf = {
+  name: "estimator_export_pdf",
+  description:
+    "Generate a PDF document for an estimate. Returns a download URL (not the binary file). The PDF layout is controlled by the estimate's output config — use estimator_update_output_config to customize which columns, sections, and details appear. The PDF includes company branding from estimator config.",
+  inputSchemaZod: exportPdfSchema,
+  execute: async (args: z.infer<typeof exportPdfSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    // Trigger PDF generation on the server side
+    try {
+      await client.get<unknown>(`/estimator/estimates/${args.estimateId}/pdf`);
+    } catch {
+      // Even if the binary response fails to parse, the PDF was generated
+    }
+    return JSON.stringify({
+      message: "PDF generated successfully.",
+      downloadUrl: `/api/estimator/estimates/${args.estimateId}/pdf`,
+    });
+  },
+};
+
+// --- estimator_update_output_config ---
+
+const updateOutputConfigSchema = z.object({
+  estimateId: z.string(),
+  showMaterialCost: z.boolean().optional(),
+  showLaborCost: z.boolean().optional(),
+  showUnitPrice: z.boolean().optional(),
+  showQuantity: z.boolean().optional(),
+  showNotes: z.boolean().optional(),
+  headerText: z.string().optional(),
+  footerText: z.string().optional(),
+  template: z.string().optional(),
+});
+
+export const updateOutputConfig = {
+  name: "estimator_update_output_config",
+  description: "Configure what appears in an estimate's PDF output. Toggle visibility of: material costs, labor costs, unit prices, quantities, line item notes. Set custom header/footer text. Choose a template style. This controls the presentation layer — the underlying estimate data is not changed.",
+  inputSchemaZod: updateOutputConfigSchema,
+  execute: async (args: z.infer<typeof updateOutputConfigSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const { estimateId, ...body } = args;
+    const data = await client.patch(`/estimator/estimates/${estimateId}/output-config`, body);
+    return JSON.stringify(data);
+  },
+};