@kynver-app/mcp-estimator 0.1.1

package/src/tools/template-tools.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_save_template ---
+
+const saveTemplateSchema = z.object({
+  estimateId: z.string(),
+  name: z.string(),
+});
+
+export const saveTemplate = {
+  name: "estimator_save_template",
+  description: "Save an existing estimate as a reusable template. Templates capture the estimate's line items, quantities, and structure so you can quickly create similar estimates in the future. Requires the estimateId of the source estimate and a name for the template.",
+  inputSchemaZod: saveTemplateSchema,
+  execute: async (args: z.infer<typeof saveTemplateSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post("/estimator/templates", args);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_list_templates ---
+
+const listTemplatesSchema = z.object({
+  type: z.string().optional(),
+});
+
+export const listTemplates = {
+  name: "estimator_list_templates",
+  description: "List all saved estimate templates. Optionally filter by type: 'replacement' or 'repair_service'. Returns template names, types, and IDs. Use template IDs with estimator_create_from_template to create new estimates.",
+  inputSchemaZod: listTemplatesSchema,
+  execute: async (args: z.infer<typeof listTemplatesSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+
+    const params = new URLSearchParams();
+    if (args.type) params.set("type", args.type);
+
+    const q = params.toString();
+    const path = q ? `/estimator/templates?${q}` : "/estimator/templates";
+
+    const data = await client.get<unknown>(path);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_delete_template ---
+
+const deleteTemplateSchema = z.object({
+  id: z.string(),
+});
+
+export const deleteTemplate = {
+  name: "estimator_delete_template",
+  description: "Delete a saved estimate template permanently. This does not affect any estimates that were previously created from this template.",
+  inputSchemaZod: deleteTemplateSchema,
+  execute: async (args: z.infer<typeof deleteTemplateSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.del(`/estimator/templates/${args.id}`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_create_from_template ---
+
+const createFromTemplateSchema = z.object({
+  templateId: z.string(),
+  projectName: z.string(),
+  clientId: z.string().optional(),
+});
+
+export const createFromTemplate = {
+  name: "estimator_create_from_template",
+  description: "Create a new estimate from a saved template. The new estimate gets all the template's line items and structure. Requires: templateId (from estimator_list_templates), projectName. Optionally link to a clientId. The new estimate is created as a draft.",
+  inputSchemaZod: createFromTemplateSchema,
+  execute: async (args: z.infer<typeof createFromTemplateSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post("/estimator/estimates", args);
+    return JSON.stringify(data);
+  },
+};

package/src/tools/version-tools.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_list_versions ---
+
+const listVersionsSchema = z.object({
+  estimateId: z.string(),
+});
+
+export const listVersions = {
+  name: "estimator_list_versions",
+  description: "List all saved version snapshots of an estimate. Versions are created automatically when significant changes are made. Shows version numbers and timestamps. Use this to track the history of changes to an estimate.",
+  inputSchemaZod: listVersionsSchema,
+  execute: async (args: z.infer<typeof listVersionsSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.get<unknown>(`/estimator/estimates/${args.estimateId}/versions`);
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_get_version ---
+
+const getVersionSchema = z.object({
+  estimateId: z.string(),
+  versionId: z.string(),
+});
+
+export const getVersion = {
+  name: "estimator_get_version",
+  description: "Get a specific historical version of an estimate. Returns the full estimate snapshot as it existed at that point in time — all line items, totals, and metadata. Useful for comparing current vs previous versions or reverting changes.",
+  inputSchemaZod: getVersionSchema,
+  execute: async (args: z.infer<typeof getVersionSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.get<unknown>(
+      `/estimator/estimates/${args.estimateId}/versions/${args.versionId}`
+    );
+    return JSON.stringify(data);
+  },
+};

package/src/tools/vision-tools.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+// --- estimator_analyze_photos ---
+
+const analyzePhotosSchema = z.object({
+  images: z.array(z.string()),
+  prompt: z.string().optional(),
+});
+
+export const analyzePhotos = {
+  name: "estimator_analyze_photos",
+  description:
+    "Analyze roof photos using Claude's vision AI. Provide image URLs (can be multiple). The AI identifies: roofing materials, visible damage (missing shingles, cracks, moss, ponding), approximate measurements, and repair recommendations. Use the optional prompt parameter to ask specific questions about the photos. Results can inform estimate creation.",
+  inputSchemaZod: analyzePhotosSchema,
+  execute: async (args: z.infer<typeof analyzePhotosSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post("/estimator/analyze", {
+      type: "photos",
+      images: args.images,
+      prompt: args.prompt,
+    });
+    return JSON.stringify(data);
+  },
+};
+
+// --- estimator_analyze_document ---
+
+const analyzeDocumentSchema = z.object({
+  text: z.string(),
+  prompt: z.string().optional(),
+});
+
+export const analyzeDocument = {
+  name: "estimator_analyze_document",
+  description:
+    "Analyze a text document (inspection report, insurance scope of work, contractor notes) and extract structured estimating data — identified services, quantities, materials, and damage descriptions. Pass the document text in the text field. Use the optional prompt parameter to focus the analysis. Results can be used to create estimates with accurate line items.",
+  inputSchemaZod: analyzeDocumentSchema,
+  execute: async (args: z.infer<typeof analyzeDocumentSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post("/estimator/analyze", {
+      type: "document",
+      text: args.text,
+      prompt: args.prompt,
+    });
+    return JSON.stringify(data);
+  },
+};

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}