@kynver-app/mcp-estimator 0.1.1

package/dist/tools/client-tools.d.ts

@@ -0,0 +1,193 @@
+import { z } from "zod";
+declare const createClientSchema: z.ZodObject<{
+    name: z.ZodString;
+    companyId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    notes?: string | undefined;
+    companyId?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+    title?: string | undefined;
+}, {
+    name: string;
+    notes?: string | undefined;
+    companyId?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+    title?: string | undefined;
+}>;
+export declare const createClient: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        name: z.ZodString;
+        companyId: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        notes?: string | undefined;
+        companyId?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+        title?: string | undefined;
+    }, {
+        name: string;
+        notes?: string | undefined;
+        companyId?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+        title?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof createClientSchema>) => Promise<string>;
+};
+declare const listClientsSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    companyId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    companyId?: string | undefined;
+    search?: string | undefined;
+}, {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    companyId?: string | undefined;
+    search?: string | undefined;
+}>;
+export declare const listClients: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        search: z.ZodOptional<z.ZodString>;
+        companyId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        companyId?: string | undefined;
+        search?: string | undefined;
+    }, {
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        companyId?: string | undefined;
+        search?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof listClientsSchema>) => Promise<string>;
+};
+declare const getClientSchema: z.ZodObject<{
+    clientId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    clientId: string;
+}, {
+    clientId: string;
+}>;
+export declare const getClient: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        clientId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        clientId: string;
+    }, {
+        clientId: string;
+    }>;
+    execute: (args: z.infer<typeof getClientSchema>) => Promise<string>;
+};
+declare const updateClientSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    companyId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    clientId: string;
+    name?: string | undefined;
+    notes?: string | undefined;
+    companyId?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+    title?: string | undefined;
+}, {
+    clientId: string;
+    name?: string | undefined;
+    notes?: string | undefined;
+    companyId?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+    title?: string | undefined;
+}>;
+export declare const updateClient: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        clientId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        companyId: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        clientId: string;
+        name?: string | undefined;
+        notes?: string | undefined;
+        companyId?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+        title?: string | undefined;
+    }, {
+        clientId: string;
+        name?: string | undefined;
+        notes?: string | undefined;
+        companyId?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+        title?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof updateClientSchema>) => Promise<string>;
+};
+declare const deleteClientSchema: z.ZodObject<{
+    clientId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    clientId: string;
+}, {
+    clientId: string;
+}>;
+export declare const deleteClient: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        clientId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        clientId: string;
+    }, {
+        clientId: string;
+    }>;
+    execute: (args: z.infer<typeof deleteClientSchema>) => Promise<string>;
+};
+export {};

package/dist/tools/client-tools.js

@@ -0,0 +1,105 @@
+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) => {
+        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) => {
+        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(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) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.get(`/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) => {
+        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) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.del(`/estimator/clients/${args.clientId}`);
+        return JSON.stringify(data);
+    },
+};

package/dist/tools/company-tools.d.ts

@@ -0,0 +1,163 @@
+import { z } from "zod";
+declare const createCompanySchema: z.ZodObject<{
+    name: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    notes?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+}, {
+    name: string;
+    notes?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+}>;
+export declare const createCompany: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        name: z.ZodString;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        notes?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+    }, {
+        name: string;
+        notes?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof createCompanySchema>) => Promise<string>;
+};
+declare const listCompaniesSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    search?: string | undefined;
+}, {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    search?: string | undefined;
+}>;
+export declare const listCompanies: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        search: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        search?: string | undefined;
+    }, {
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        search?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof listCompaniesSchema>) => Promise<string>;
+};
+declare const getCompanySchema: z.ZodObject<{
+    companyId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    companyId: string;
+}, {
+    companyId: string;
+}>;
+export declare const getCompany: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        companyId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        companyId: string;
+    }, {
+        companyId: string;
+    }>;
+    execute: (args: z.infer<typeof getCompanySchema>) => Promise<string>;
+};
+declare const updateCompanySchema: z.ZodObject<{
+    companyId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    companyId: string;
+    name?: string | undefined;
+    notes?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+}, {
+    companyId: string;
+    name?: string | undefined;
+    notes?: string | undefined;
+    phone?: string | undefined;
+    email?: string | undefined;
+    address?: string | undefined;
+}>;
+export declare const updateCompany: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        companyId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        companyId: string;
+        name?: string | undefined;
+        notes?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+    }, {
+        companyId: string;
+        name?: string | undefined;
+        notes?: string | undefined;
+        phone?: string | undefined;
+        email?: string | undefined;
+        address?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof updateCompanySchema>) => Promise<string>;
+};
+declare const deleteCompanySchema: z.ZodObject<{
+    companyId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    companyId: string;
+}, {
+    companyId: string;
+}>;
+export declare const deleteCompany: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        companyId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        companyId: string;
+    }, {
+        companyId: string;
+    }>;
+    execute: (args: z.infer<typeof deleteCompanySchema>) => Promise<string>;
+};
+export {};

package/dist/tools/company-tools.js

@@ -0,0 +1,98 @@
+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) => {
+        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) => {
+        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(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) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.get(`/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) => {
+        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) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.del(`/estimator/companies/${args.companyId}`);
+        return JSON.stringify(data);
+    },
+};

package/dist/tools/create-estimate.d.ts

@@ -0,0 +1,107 @@
+import { z } from "zod";
+declare const inputSchema: z.ZodObject<{
+    type: z.ZodEnum<["replacement", "repair_service"]>;
+    projectName: z.ZodString;
+    roofMaterial: z.ZodOptional<z.ZodString>;
+    footprintSqFt: z.ZodOptional<z.ZodNumber>;
+    pitch: z.ZodOptional<z.ZodString>;
+    layers: z.ZodOptional<z.ZodNumber>;
+    ridgeLengthFt: z.ZodOptional<z.ZodNumber>;
+    eavesFt: z.ZodOptional<z.ZodNumber>;
+    lineItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        serviceCode: z.ZodString;
+        materialType: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }, {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "replacement" | "repair_service";
+    projectName: string;
+    roofMaterial?: string | undefined;
+    footprintSqFt?: number | undefined;
+    pitch?: string | undefined;
+    layers?: number | undefined;
+    ridgeLengthFt?: number | undefined;
+    eavesFt?: number | undefined;
+    lineItems?: {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }[] | undefined;
+}, {
+    type: "replacement" | "repair_service";
+    projectName: string;
+    roofMaterial?: string | undefined;
+    footprintSqFt?: number | undefined;
+    pitch?: string | undefined;
+    layers?: number | undefined;
+    ridgeLengthFt?: number | undefined;
+    eavesFt?: number | undefined;
+    lineItems?: {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }[] | undefined;
+}>;
+export declare const name = "estimator_create_estimate";
+export declare const description = "Create a roofing estimate. For replacement: provide dimensions and material. For repair: provide service items with quantities.";
+export declare const inputSchemaZod: z.ZodObject<{
+    type: z.ZodEnum<["replacement", "repair_service"]>;
+    projectName: z.ZodString;
+    roofMaterial: z.ZodOptional<z.ZodString>;
+    footprintSqFt: z.ZodOptional<z.ZodNumber>;
+    pitch: z.ZodOptional<z.ZodString>;
+    layers: z.ZodOptional<z.ZodNumber>;
+    ridgeLengthFt: z.ZodOptional<z.ZodNumber>;
+    eavesFt: z.ZodOptional<z.ZodNumber>;
+    lineItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        serviceCode: z.ZodString;
+        materialType: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }, {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "replacement" | "repair_service";
+    projectName: string;
+    roofMaterial?: string | undefined;
+    footprintSqFt?: number | undefined;
+    pitch?: string | undefined;
+    layers?: number | undefined;
+    ridgeLengthFt?: number | undefined;
+    eavesFt?: number | undefined;
+    lineItems?: {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }[] | undefined;
+}, {
+    type: "replacement" | "repair_service";
+    projectName: string;
+    roofMaterial?: string | undefined;
+    footprintSqFt?: number | undefined;
+    pitch?: string | undefined;
+    layers?: number | undefined;
+    ridgeLengthFt?: number | undefined;
+    eavesFt?: number | undefined;
+    lineItems?: {
+        serviceCode: string;
+        quantity: number;
+        materialType?: string | undefined;
+    }[] | undefined;
+}>;
+export declare function execute(args: z.infer<typeof inputSchema>): Promise<string>;
+export {};