@opsrev/acculynx-cli 1.9.2 → 1.11.0

package/dist/chunk-FEKZ3BED.js

@@ -0,0 +1,302 @@
+// src/config.ts
+var BASE_URL = "https://api.acculynx.com/api/v2";
+function getConfig(options) {
+  const apiKey = options.apiKey ?? process.env.ACCULYNX_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      "Missing required credential: ACCULYNX_API_KEY (set env var or pass --api-key)"
+    );
+  }
+  return {
+    baseUrl: BASE_URL,
+    apiKey
+  };
+}
+
+// src/api-client.ts
+var MAX_RETRIES = 3;
+var INITIAL_DELAY_MS = 1e3;
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function fetchWithRetry(url, init, retries = MAX_RETRIES) {
+  const response = await fetch(url, init);
+  if (response.status === 429 && retries > 0) {
+    const retryAfter = response.headers.get("Retry-After");
+    const delay = retryAfter ? parseInt(retryAfter, 10) * 1e3 : INITIAL_DELAY_MS * Math.pow(2, MAX_RETRIES - retries);
+    await sleep(delay);
+    return fetchWithRetry(url, init, retries - 1);
+  }
+  return response;
+}
+function createApiClient(config) {
+  const headers = {
+    Authorization: `Bearer ${config.apiKey}`,
+    Accept: "application/json"
+  };
+  async function doGet(path, params) {
+    let url = `${config.baseUrl}${path}`;
+    if (params && Object.keys(params).length > 0) {
+      url += `?${new URLSearchParams(params).toString()}`;
+    }
+    const response = await fetchWithRetry(url, { headers });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `API error (${response.status} ${response.statusText}): ${text}`
+      );
+    }
+    return response.json();
+  }
+  async function doPost(path, body) {
+    const url = `${config.baseUrl}${path}`;
+    const response = await fetchWithRetry(url, {
+      method: "POST",
+      headers: { ...headers, "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text2 = await response.text();
+      throw new Error(
+        `API error (${response.status} ${response.statusText}): ${text2}`
+      );
+    }
+    const text = await response.text();
+    return text ? JSON.parse(text) : { status: response.status };
+  }
+  async function doPostForm(path, body) {
+    const url = `${config.baseUrl}${path}`;
+    const { "Content-Type": _, ...formHeaders } = headers;
+    const response = await fetchWithRetry(url, {
+      method: "POST",
+      headers: formHeaders,
+      body
+    });
+    if (!response.ok) {
+      const text2 = await response.text();
+      throw new Error(
+        `API error (${response.status} ${response.statusText}): ${text2}`
+      );
+    }
+    const text = await response.text();
+    return text ? JSON.parse(text) : { status: response.status };
+  }
+  return {
+    get: doGet,
+    post: doPost,
+    postForm: doPostForm
+  };
+}
+
+// src/ops/ping.ts
+function ping(client) {
+  return client.get("/diagnostics/ping");
+}
+
+// src/api-helpers.ts
+var DEFAULT_PAGE_SIZE = 25;
+var DEFAULT_LIMIT = 25;
+async function paginate(client, path, params, limit = DEFAULT_LIMIT) {
+  const results = [];
+  let pageStartIndex = 0;
+  while (true) {
+    const pageParams = {
+      ...params,
+      pageSize: String(DEFAULT_PAGE_SIZE),
+      pageStartIndex: String(pageStartIndex)
+    };
+    const data = await client.get(path, pageParams);
+    results.push(...data.items);
+    if (limit !== Infinity && results.length >= limit) {
+      return results.slice(0, limit);
+    }
+    if (data.items.length < DEFAULT_PAGE_SIZE) {
+      break;
+    }
+    pageStartIndex += DEFAULT_PAGE_SIZE;
+  }
+  return results;
+}
+async function readStdin(stream = process.stdin) {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  const raw = Buffer.concat(chunks).toString("utf-8").trim();
+  if (!raw) {
+    throw new Error(
+      "No input provided on stdin. Pipe JSON body, e.g.: echo '{...}' | acculynx jobs create"
+    );
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error("Invalid JSON on stdin");
+  }
+}
+
+// src/ops/jobs.ts
+import { readFileSync } from "fs";
+import { basename, extname } from "path";
+var DISALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".exe",
+  ".com",
+  ".dll",
+  ".msi",
+  ".bat",
+  ".cmd",
+  ".sh",
+  ".pl",
+  ".vbs",
+  ".py",
+  ".php"
+]);
+function jobsList(client, opts = {}) {
+  const params = {};
+  if (opts.startDate) params.startDate = opts.startDate;
+  if (opts.endDate) params.endDate = opts.endDate;
+  if (opts.dateFilterType) params.dateFilterType = opts.dateFilterType;
+  if (opts.milestones) params.milestones = opts.milestones;
+  params.sortBy = opts.sortBy ?? "CreatedDate";
+  if (opts.sortOrder) params.sortOrder = opts.sortOrder;
+  if (opts.includes) params.includes = opts.includes;
+  if (opts.assignment) params.assignment = opts.assignment;
+  return paginate(client, "/jobs", params, opts.limit);
+}
+function jobGet(client, jobId) {
+  return client.get(`/jobs/${jobId}`);
+}
+function jobCreate(client, body) {
+  return client.post("/jobs", body);
+}
+function jobSearch(client, query) {
+  return client.post("/jobs/search", { SearchTerm: query });
+}
+var jobContacts = (client, jobId) => client.get(`/jobs/${jobId}/contacts`);
+var jobEstimates = (client, jobId) => client.get(`/jobs/${jobId}/estimates`);
+var jobFinancials = (client, jobId) => client.get(`/jobs/${jobId}/financials`);
+var jobInvoices = (client, jobId) => client.get(`/jobs/${jobId}/invoices`);
+var jobMilestones = (client, jobId) => client.get(`/jobs/${jobId}/milestone-history`);
+var jobPayments = (client, jobId) => client.get(`/jobs/${jobId}/payments`);
+var jobHistory = (client, jobId) => client.get(`/jobs/${jobId}/history`);
+var jobReps = (client, jobId) => client.get(`/jobs/${jobId}/representatives`);
+function jobRepsAssign(client, jobId, opts) {
+  const type = opts.type ?? "company";
+  return client.post(`/jobs/${jobId}/representatives/${type}`, { id: opts.userId });
+}
+function documentFolders(client, opts = {}) {
+  const params = {
+    recordStartIndex: opts.recordStartIndex ?? "0",
+    sortOrder: opts.sortOrder ?? "Ascending"
+  };
+  if (opts.pageSize) params.pageSize = opts.pageSize;
+  return client.get("/company-settings/job-file-settings/document-folders", params);
+}
+function jobAddExpense(client, jobId, body) {
+  return client.post(`/jobs/${jobId}/payments/expense`, body);
+}
+function jobUploadDocument(client, jobId, filePath, opts) {
+  const ext = extname(filePath).toLowerCase();
+  if (DISALLOWED_EXTENSIONS.has(ext)) {
+    throw new Error(`File type ${ext} is not allowed`);
+  }
+  const fileBuffer = readFileSync(filePath);
+  const fileName = basename(filePath);
+  const file = new File([fileBuffer], fileName);
+  const form = new FormData();
+  form.append("file", file);
+  form.append("documentFolderId", opts.folderId);
+  if (opts.description) form.append("description", opts.description);
+  if (opts.externalId) form.append("externalId", opts.externalId);
+  if (opts.externalSource) form.append("externalSource", opts.externalSource);
+  return client.postForm(`/jobs/${jobId}/documents`, form);
+}
+
+// src/ops/contacts.ts
+function contactsList(client, limit) {
+  return paginate(client, "/contacts", {}, limit);
+}
+function contactGet(client, contactId) {
+  return client.get(`/contacts/${contactId}`);
+}
+function contactCreate(client, body) {
+  return client.post("/contacts", body);
+}
+function contactsSearch(client, opts) {
+  return client.post("/contacts/search", {
+    searchTerm: opts.query,
+    startDate: opts.startDate,
+    endDate: opts.endDate,
+    sort: {
+      sortColumn: opts.sortBy ?? "lastName",
+      sortDirection: opts.sortOrder ?? "Ascending"
+    }
+  });
+}
+var contactEmails = (client, contactId) => client.get(`/contacts/${contactId}/email-addresses`);
+var contactPhones = (client, contactId) => client.get(`/contacts/${contactId}/phone-numbers`);
+function contactPhoneAdd(client, contactId, opts) {
+  return client.post(`/contacts/${contactId}/phone-numbers`, {
+    type: opts.type,
+    number: opts.number,
+    smsOptOut: Boolean(opts.smsOptOut)
+  });
+}
+
+// src/ops/estimates.ts
+function estimatesList(client, limit) {
+  return paginate(client, "/estimates", {}, limit);
+}
+var estimateGet = (client, estimateId) => client.get(`/estimates/${estimateId}`);
+var estimateSections = (client, estimateId) => client.get(`/estimates/${estimateId}/sections`);
+var estimateSection = (client, estimateId, sectionId) => client.get(`/estimates/${estimateId}/sections/${sectionId}`);
+var estimateItems = (client, estimateId, sectionId) => client.get(`/estimates/${estimateId}/sections/${sectionId}/items`);
+
+// src/ops/users.ts
+async function usersList(client, opts = {}) {
+  if (opts.search) {
+    const all = await paginate(client, "/users", {}, Infinity);
+    const term = opts.search.toLowerCase();
+    return all.filter((u) => {
+      const fields = [u.displayName, u.firstName, u.lastName, u.email];
+      return fields.some((f) => f && f.toLowerCase().includes(term));
+    });
+  }
+  return paginate(client, "/users", {}, opts.limit);
+}
+
+export {
+  getConfig,
+  createApiClient,
+  ping,
+  readStdin,
+  jobsList,
+  jobGet,
+  jobCreate,
+  jobSearch,
+  jobContacts,
+  jobEstimates,
+  jobFinancials,
+  jobInvoices,
+  jobMilestones,
+  jobPayments,
+  jobHistory,
+  jobReps,
+  jobRepsAssign,
+  documentFolders,
+  jobAddExpense,
+  jobUploadDocument,
+  contactsList,
+  contactGet,
+  contactCreate,
+  contactsSearch,
+  contactEmails,
+  contactPhones,
+  contactPhoneAdd,
+  estimatesList,
+  estimateGet,
+  estimateSections,
+  estimateSection,
+  estimateItems,
+  usersList
+};

package/dist/index.js

@@ -1,262 +1,120 @@
 #!/usr/bin/env node
+import {
+  contactCreate,
+  contactEmails,
+  contactGet,
+  contactPhoneAdd,
+  contactPhones,
+  contactsList,
+  contactsSearch,
+  createApiClient,
+  documentFolders,
+  estimateGet,
+  estimateItems,
+  estimateSection,
+  estimateSections,
+  estimatesList,
+  getConfig,
+  jobAddExpense,
+  jobContacts,
+  jobCreate,
+  jobEstimates,
+  jobFinancials,
+  jobGet,
+  jobHistory,
+  jobInvoices,
+  jobMilestones,
+  jobPayments,
+  jobReps,
+  jobRepsAssign,
+  jobSearch,
+  jobUploadDocument,
+  jobsList,
+  ping,
+  readStdin,
+  usersList
+} from "./chunk-FEKZ3BED.js";
 
 // src/index.ts
 import { createRequire } from "module";
 import { Command } from "commander";
 
-// src/config.ts
-var BASE_URL = "https://api.acculynx.com/api/v2";
-function getConfig(options) {
-  const apiKey = options.apiKey ?? process.env.ACCULYNX_API_KEY;
-  if (!apiKey) {
-    throw new Error(
-      "Missing required credential: ACCULYNX_API_KEY (set env var or pass --api-key)"
-    );
-  }
-  return {
-    baseUrl: BASE_URL,
-    apiKey
-  };
-}
-
-// src/api-client.ts
-var MAX_RETRIES = 3;
-var INITIAL_DELAY_MS = 1e3;
-async function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function fetchWithRetry(url, init, retries = MAX_RETRIES) {
-  const response = await fetch(url, init);
-  if (response.status === 429 && retries > 0) {
-    const retryAfter = response.headers.get("Retry-After");
-    const delay = retryAfter ? parseInt(retryAfter, 10) * 1e3 : INITIAL_DELAY_MS * Math.pow(2, MAX_RETRIES - retries);
-    await sleep(delay);
-    return fetchWithRetry(url, init, retries - 1);
-  }
-  return response;
-}
-function createApiClient(config) {
-  const headers = {
-    Authorization: `Bearer ${config.apiKey}`,
-    Accept: "application/json"
-  };
-  async function doGet(path, params) {
-    let url = `${config.baseUrl}${path}`;
-    if (params && Object.keys(params).length > 0) {
-      url += `?${new URLSearchParams(params).toString()}`;
-    }
-    const response = await fetchWithRetry(url, { headers });
-    if (!response.ok) {
-      const text = await response.text();
-      throw new Error(
-        `API error (${response.status} ${response.statusText}): ${text}`
-      );
-    }
-    return response.json();
-  }
-  async function doPost(path, body) {
-    const url = `${config.baseUrl}${path}`;
-    const response = await fetchWithRetry(url, {
-      method: "POST",
-      headers: { ...headers, "Content-Type": "application/json" },
-      body: JSON.stringify(body)
-    });
-    if (!response.ok) {
-      const text2 = await response.text();
-      throw new Error(
-        `API error (${response.status} ${response.statusText}): ${text2}`
-      );
-    }
-    const text = await response.text();
-    return text ? JSON.parse(text) : { status: response.status };
-  }
-  async function doPostForm(path, body) {
-    const url = `${config.baseUrl}${path}`;
-    const { "Content-Type": _, ...formHeaders } = headers;
-    const response = await fetchWithRetry(url, {
-      method: "POST",
-      headers: formHeaders,
-      body
-    });
-    if (!response.ok) {
-      const text2 = await response.text();
-      throw new Error(
-        `API error (${response.status} ${response.statusText}): ${text2}`
-      );
-    }
-    const text = await response.text();
-    return text ? JSON.parse(text) : { status: response.status };
-  }
-  return {
-    get: doGet,
-    post: doPost,
-    postForm: doPostForm
-  };
-}
-
 // src/commands/ping.ts
 function registerPingCommand(parentCmd, getClient2) {
   parentCmd.command("ping").description("Health check \u2014 verify API key and connectivity").action(async () => {
-    const result = await getClient2().get("/diagnostics/ping");
+    const result = await ping(getClient2());
     console.log(JSON.stringify(result));
   });
 }
 
 // src/commands/jobs.ts
-import { readFileSync } from "fs";
-import { basename, extname } from "path";
-
-// src/api-helpers.ts
-var DEFAULT_PAGE_SIZE = 25;
-var DEFAULT_LIMIT = 25;
-async function paginate(client, path, params, limit = DEFAULT_LIMIT) {
-  const results = [];
-  let pageStartIndex = 0;
-  while (true) {
-    const pageParams = {
-      ...params,
-      pageSize: String(DEFAULT_PAGE_SIZE),
-      pageStartIndex: String(pageStartIndex)
-    };
-    const data = await client.get(path, pageParams);
-    results.push(...data.items);
-    if (limit !== Infinity && results.length >= limit) {
-      return results.slice(0, limit);
-    }
-    if (data.items.length < DEFAULT_PAGE_SIZE) {
-      break;
-    }
-    pageStartIndex += DEFAULT_PAGE_SIZE;
-  }
-  return results;
-}
-async function readStdin(stream = process.stdin) {
-  const chunks = [];
-  for await (const chunk of stream) {
-    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-  }
-  const raw = Buffer.concat(chunks).toString("utf-8").trim();
-  if (!raw) {
-    throw new Error(
-      "No input provided on stdin. Pipe JSON body, e.g.: echo '{...}' | acculynx jobs create"
-    );
-  }
-  try {
-    return JSON.parse(raw);
-  } catch {
-    throw new Error("Invalid JSON on stdin");
-  }
-}
-
-// src/commands/jobs.ts
-var DISALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([
-  ".exe",
-  ".com",
-  ".dll",
-  ".msi",
-  ".bat",
-  ".cmd",
-  ".sh",
-  ".pl",
-  ".vbs",
-  ".py",
-  ".php"
-]);
 function registerJobsCommands(parentCmd, getClient2) {
   const jobs = parentCmd.command("jobs").description("Job operations");
   jobs.command("list").description("List jobs (paginated)").option("--start-date <date>", "Start date (YYYY-MM-DD)").option("--end-date <date>", "End date (YYYY-MM-DD)").option("--date-filter-type <type>", "Date field to filter on").option("--milestones <milestones>", "Filter by milestones").option("--sort-by <field>", "Sort by: CreatedDate, MilestoneDate, ModifiedDate").option("--sort-order <order>", "Ascending or Descending").option("--includes <fields>", "Include: contact, initialAppointment").option("--assignment <type>", "Filter by assignment: assigned, unassigned").option("--limit <n>", "Max total results (default: 25)").option("--all", "Fetch all results (no limit)").action(async (opts) => {
-    const params = {};
-    if (opts.startDate) params.startDate = opts.startDate;
-    if (opts.endDate) params.endDate = opts.endDate;
-    if (opts.dateFilterType) params.dateFilterType = opts.dateFilterType;
-    if (opts.milestones) params.milestones = opts.milestones;
-    params.sortBy = opts.sortBy ?? "CreatedDate";
-    if (opts.sortOrder) params.sortOrder = opts.sortOrder;
-    if (opts.includes) params.includes = opts.includes;
-    if (opts.assignment) params.assignment = opts.assignment;
     const limit = opts.all ? Infinity : opts.limit ? parseInt(opts.limit, 10) : void 0;
-    const result = await paginate(getClient2(), "/jobs", params, limit);
+    const result = await jobsList(getClient2(), {
+      startDate: opts.startDate,
+      endDate: opts.endDate,
+      dateFilterType: opts.dateFilterType,
+      milestones: opts.milestones,
+      sortBy: opts.sortBy,
+      sortOrder: opts.sortOrder,
+      includes: opts.includes,
+      assignment: opts.assignment,
+      limit
+    });
     console.log(JSON.stringify(result));
   });
   jobs.command("get").argument("<jobId>", "Job ID").description("Get job details").action(async (jobId) => {
-    const result = await getClient2().get(`/jobs/${jobId}`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await jobGet(getClient2(), jobId)));
   });
   jobs.command("create").description("Create a job (pipe JSON body to stdin)").action(async () => {
     const body = await readStdin();
-    const result = await getClient2().post("/jobs", body);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await jobCreate(getClient2(), body)));
   });
   jobs.command("search").description("Search jobs").requiredOption("--query <text>", "Search term (required)").action(async (opts) => {
-    const result = await getClient2().post("/jobs/search", {
-      SearchTerm: opts.query
-    });
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await jobSearch(getClient2(), opts.query)));
   });
   const subResources = [
-    { name: "contacts", path: "contacts", desc: "List job contacts" },
-    { name: "estimates", path: "estimates", desc: "List job estimates" },
-    { name: "financials", path: "financials", desc: "Get job financials" },
-    { name: "invoices", path: "invoices", desc: "List job invoices" },
-    { name: "milestones", path: "milestone-history", desc: "List job milestone history" },
-    { name: "payments", path: "payments", desc: "List job payments" },
-    { name: "history", path: "history", desc: "Get job history" }
+    { name: "contacts", fn: jobContacts, desc: "List job contacts" },
+    { name: "estimates", fn: jobEstimates, desc: "List job estimates" },
+    { name: "financials", fn: jobFinancials, desc: "Get job financials" },
+    { name: "invoices", fn: jobInvoices, desc: "List job invoices" },
+    { name: "milestones", fn: jobMilestones, desc: "List job milestone history" },
+    { name: "payments", fn: jobPayments, desc: "List job payments" },
+    { name: "history", fn: jobHistory, desc: "Get job history" }
   ];
   for (const sub of subResources) {
     jobs.command(sub.name).argument("<jobId>", "Job ID").description(sub.desc).action(async (jobId) => {
-      const result = await getClient2().get(`/jobs/${jobId}/${sub.path}`);
-      console.log(JSON.stringify(result));
+      console.log(JSON.stringify(await sub.fn(getClient2(), jobId)));
     });
   }
   jobs.command("reps").argument("<jobId>", "Job ID").description("List all representatives for a job").action(async (jobId) => {
-    const result = await getClient2().get(`/jobs/${jobId}/representatives`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await jobReps(getClient2(), jobId)));
   });
   jobs.command("reps-assign").argument("<jobId>", "Job ID").description("Assign a representative to a job").requiredOption("--user-id <id>", "User ID to assign").option("--type <type>", "Rep type: company, sales-owner, ar-owner", "company").action(async (jobId, opts) => {
-    const result = await getClient2().post(
-      `/jobs/${jobId}/representatives/${opts.type}`,
-      { id: opts.userId }
-    );
+    const result = await jobRepsAssign(getClient2(), jobId, { userId: opts.userId, type: opts.type });
     console.log(JSON.stringify(result));
   });
   jobs.command("document-folders").description("List document folders for the company").option("--page-size <n>", "Number of items per page").option("--record-start-index <n>", "Index of first element to return", "0").option("--sort-order <order>", "Ascending or Descending", "Ascending").action(async (opts) => {
-    const params = {
+    const result = await documentFolders(getClient2(), {
+      pageSize: opts.pageSize,
       recordStartIndex: opts.recordStartIndex,
       sortOrder: opts.sortOrder
-    };
-    if (opts.pageSize) params.pageSize = opts.pageSize;
-    const result = await getClient2().get(
-      "/company-settings/job-file-settings/document-folders",
-      params
-    );
+    });
     console.log(JSON.stringify(result));
   });
   jobs.command("add-expense").argument("<jobId>", "Job ID").description("Record an additional expense on a job (pipe JSON body to stdin)").action(async (jobId) => {
     const body = await readStdin();
-    const result = await getClient2().post(
-      `/jobs/${jobId}/payments/expense`,
-      body
-    );
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await jobAddExpense(getClient2(), jobId, body)));
   });
   jobs.command("upload-document").argument("<jobId>", "Job ID").argument("<filePath>", "Path to the file to upload").requiredOption("--folder-id <id>", "Document folder ID (required)").option("--description <text>", "Brief description of the file").option("--external-id <id>", "External reference identifier").option("--external-source <source>", "External reference source").description("Upload a document to a job").action(async (jobId, filePath, opts) => {
-    const ext = extname(filePath).toLowerCase();
-    if (DISALLOWED_EXTENSIONS.has(ext)) {
-      throw new Error(`File type ${ext} is not allowed`);
-    }
-    const fileBuffer = readFileSync(filePath);
-    const fileName = basename(filePath);
-    const file = new File([fileBuffer], fileName);
-    const form = new FormData();
-    form.append("file", file);
-    form.append("documentFolderId", opts.folderId);
-    if (opts.description) form.append("description", opts.description);
-    if (opts.externalId) form.append("externalId", opts.externalId);
-    if (opts.externalSource) form.append("externalSource", opts.externalSource);
-    const result = await getClient2().postForm(
-      `/jobs/${jobId}/documents`,
-      form
-    );
+    const result = await jobUploadDocument(getClient2(), jobId, filePath, {
+      folderId: opts.folderId,
+      description: opts.description,
+      externalId: opts.externalId,
+      externalSource: opts.externalSource
+    });
     console.log(JSON.stringify(result));
   });
 }
@@ -266,36 +124,37 @@ function registerContactsCommands(parentCmd, getClient2) {
   const contacts = parentCmd.command("contacts").description("Contact operations");
   contacts.command("list").description("List contacts (paginated)").option("--limit <n>", "Max total results (default: 25)").option("--all", "Fetch all results (no limit)").action(async (opts) => {
     const limit = opts.all ? Infinity : opts.limit ? parseInt(opts.limit, 10) : void 0;
-    const result = await paginate(getClient2(), "/contacts", {}, limit);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await contactsList(getClient2(), limit)));
   });
   contacts.command("get").argument("<contactId>", "Contact ID").description("Get contact details").action(async (contactId) => {
-    const result = await getClient2().get(`/contacts/${contactId}`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await contactGet(getClient2(), contactId)));
   });
   contacts.command("create").description("Create a contact (pipe JSON body to stdin)").action(async () => {
     const body = await readStdin();
-    const result = await getClient2().post("/contacts", body);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await contactCreate(getClient2(), body)));
   });
   contacts.command("search").description("Search contacts").requiredOption("--query <text>", "Search term (required)").requiredOption("--start-date <date>", "Start date (YYYY-MM-DD, required)").requiredOption("--end-date <date>", "End date (YYYY-MM-DD, required)").option("--sort-by <field>", "Sort by: CreatedDate, firstName, lastName", "lastName").option("--sort-order <order>", "Ascending or Descending", "Ascending").action(async (opts) => {
-    const result = await getClient2().post("/contacts/search", {
-      searchTerm: opts.query,
+    const result = await contactsSearch(getClient2(), {
+      query: opts.query,
       startDate: opts.startDate,
       endDate: opts.endDate,
-      sort: {
-        sortColumn: opts.sortBy,
-        sortDirection: opts.sortOrder
-      }
+      sortBy: opts.sortBy,
+      sortOrder: opts.sortOrder
     });
     console.log(JSON.stringify(result));
   });
   contacts.command("emails").argument("<contactId>", "Contact ID").description("List contact email addresses").action(async (contactId) => {
-    const result = await getClient2().get(`/contacts/${contactId}/email-addresses`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await contactEmails(getClient2(), contactId)));
   });
   contacts.command("phones").argument("<contactId>", "Contact ID").description("List contact phone numbers").action(async (contactId) => {
-    const result = await getClient2().get(`/contacts/${contactId}/phone-numbers`);
+    console.log(JSON.stringify(await contactPhones(getClient2(), contactId)));
+  });
+  contacts.command("phone-add").argument("<contactId>", "Contact ID").description("Add a phone number to a contact (omit --sms-opt-out to opt in to SMS)").requiredOption("--type <type>", "Phone type: Mobile, Home, Work").requiredOption("--number <number>", "Phone number").option("--sms-opt-out", "Opt this number out of SMS").action(async (contactId, opts) => {
+    const result = await contactPhoneAdd(getClient2(), contactId, {
+      type: opts.type,
+      number: opts.number,
+      smsOptOut: Boolean(opts.smsOptOut)
+    });
     console.log(JSON.stringify(result));
   });
 }
@@ -305,24 +164,19 @@ function registerEstimatesCommands(parentCmd, getClient2) {
   const estimates = parentCmd.command("estimates").description("Estimate operations");
   estimates.command("list").description("List estimates (paginated)").option("--limit <n>", "Max total results (default: 25)").option("--all", "Fetch all results (no limit)").action(async (opts) => {
     const limit = opts.all ? Infinity : opts.limit ? parseInt(opts.limit, 10) : void 0;
-    const result = await paginate(getClient2(), "/estimates", {}, limit);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await estimatesList(getClient2(), limit)));
   });
   estimates.command("get").argument("<estimateId>", "Estimate ID").description("Get estimate details").action(async (estimateId) => {
-    const result = await getClient2().get(`/estimates/${estimateId}`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await estimateGet(getClient2(), estimateId)));
   });
   estimates.command("sections").argument("<estimateId>", "Estimate ID").description("List sections for an estimate").action(async (estimateId) => {
-    const result = await getClient2().get(`/estimates/${estimateId}/sections`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await estimateSections(getClient2(), estimateId)));
   });
   estimates.command("section").argument("<estimateId>", "Estimate ID").argument("<sectionId>", "Section ID").description("Get estimate section details").action(async (estimateId, sectionId) => {
-    const result = await getClient2().get(`/estimates/${estimateId}/sections/${sectionId}`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await estimateSection(getClient2(), estimateId, sectionId)));
   });
   estimates.command("items").argument("<estimateId>", "Estimate ID").argument("<sectionId>", "Section ID").description("List items in an estimate section").action(async (estimateId, sectionId) => {
-    const result = await getClient2().get(`/estimates/${estimateId}/sections/${sectionId}/items`);
-    console.log(JSON.stringify(result));
+    console.log(JSON.stringify(await estimateItems(getClient2(), estimateId, sectionId)));
   });
 }
 
@@ -330,18 +184,8 @@ function registerEstimatesCommands(parentCmd, getClient2) {
 function registerUsersCommands(parentCmd, getClient2) {
   const users = parentCmd.command("users").description("User operations");
   users.command("list").description("List users (paginated)").option("--limit <n>", "Max total results (default: 25)").option("--all", "Fetch all results (no limit)").option("--search <text>", "Filter users by name or email (client-side)").action(async (opts) => {
-    if (opts.search) {
-      const all = await paginate(getClient2(), "/users", {}, Infinity);
-      const term = opts.search.toLowerCase();
-      const filtered = all.filter((u) => {
-        const fields = [u.displayName, u.firstName, u.lastName, u.email];
-        return fields.some((f) => f && f.toLowerCase().includes(term));
-      });
-      console.log(JSON.stringify(filtered));
-      return;
-    }
     const limit = opts.all ? Infinity : opts.limit ? parseInt(opts.limit, 10) : void 0;
-    const result = await paginate(getClient2(), "/users", {}, limit);
+    const result = await usersList(getClient2(), { limit, search: opts.search });
     console.log(JSON.stringify(result));
   });
 }

package/dist/mcp.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+interface AccuLynxConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+
+/**
+ * Fail fast at boot if the API key is missing/unresolvable (getConfig throws).
+ * Exported with injectable deps so it can be unit-tested without booting the server.
+ */
+declare function bootSelfCheck(getCfg?: () => AccuLynxConfig, logFn?: (msg: string) => void, exit?: (code: number) => never): Promise<void>;
+
+export { bootSelfCheck };

package/dist/mcp.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+import {
+  contactCreate,
+  contactEmails,
+  contactGet,
+  contactPhoneAdd,
+  contactPhones,
+  contactsList,
+  contactsSearch,
+  createApiClient,
+  documentFolders,
+  estimateGet,
+  estimateItems,
+  estimateSection,
+  estimateSections,
+  estimatesList,
+  getConfig,
+  jobAddExpense,
+  jobContacts,
+  jobCreate,
+  jobEstimates,
+  jobFinancials,
+  jobGet,
+  jobHistory,
+  jobInvoices,
+  jobMilestones,
+  jobPayments,
+  jobReps,
+  jobRepsAssign,
+  jobSearch,
+  jobUploadDocument,
+  jobsList,
+  ping,
+  usersList
+} from "./chunk-FEKZ3BED.js";
+
+// src/mcp.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { createRequire } from "module";
+
+// src/mcp/tools.ts
+var LIMIT = { type: "number", description: "Max total results (default 25). Omit and set all=true to fetch everything." };
+var ALL = { type: "boolean", description: "Fetch all results (ignores limit)." };
+var DATE = { type: "string", description: "Date in YYYY-MM-DD format.", pattern: "^\\d{4}-\\d{2}-\\d{2}$" };
+var BODY = { type: "object", description: "The full JSON request body for this resource.", additionalProperties: true };
+var SORT_ORDER = { type: "string", enum: ["Ascending", "Descending"], description: "Sort direction." };
+function ok(value) {
+  return { content: [{ type: "text", text: JSON.stringify(value) }] };
+}
+function fail(payload) {
+  return { content: [{ type: "text", text: JSON.stringify(payload) }], isError: true };
+}
+var str = (v) => typeof v === "string" ? v : void 0;
+var num = (v) => {
+  if (v === void 0 || v === null) return void 0;
+  const n = Number(v);
+  return Number.isNaN(n) ? void 0 : n;
+};
+var boolOf = (v) => typeof v === "boolean" ? v : void 0;
+var resolveLimit = (args) => boolOf(args.all) ? Infinity : num(args.limit);
+function defaultClient() {
+  return createApiClient(getConfig({}));
+}
+function buildTools() {
+  return [
+    { name: "acculynx_ping", description: "Health check \u2014 verify the API key and connectivity.", inputSchema: { type: "object", properties: {}, required: [] } },
+    { name: "acculynx_jobs_list", description: "List jobs (paginated). All filters optional.", inputSchema: { type: "object", properties: {
+      startDate: DATE,
+      endDate: DATE,
+      dateFilterType: { type: "string", description: "Date field to filter on." },
+      milestones: { type: "string", description: "Filter by milestones." },
+      sortBy: { type: "string", enum: ["CreatedDate", "MilestoneDate", "ModifiedDate"], description: "Sort field (default CreatedDate)." },
+      sortOrder: SORT_ORDER,
+      includes: { type: "string", enum: ["contact", "initialAppointment"], description: "Related data to include." },
+      assignment: { type: "string", enum: ["assigned", "unassigned"], description: "Filter by assignment status." },
+      limit: LIMIT,
+      all: ALL
+    }, required: [] } },
+    { name: "acculynx_jobs_get", description: "Get one job by id.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_create", description: "Create a job from a JSON body.", inputSchema: { type: "object", properties: { body: BODY }, required: ["body"] } },
+    { name: "acculynx_jobs_search", description: "Search jobs by a free-text term.", inputSchema: { type: "object", properties: { query: { type: "string", description: "Search term." } }, required: ["query"] } },
+    { name: "acculynx_jobs_contacts", description: "List a job's contacts.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_estimates", description: "List a job's estimates.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_financials", description: "Get a job's financials.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_invoices", description: "List a job's invoices.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_milestones", description: "List a job's milestone history.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_payments", description: "List a job's payments.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_history", description: "Get a job's history.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_reps", description: "List a job's representatives.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." } }, required: ["jobId"] } },
+    { name: "acculynx_jobs_reps_assign", description: "Assign a representative to a job.", inputSchema: { type: "object", properties: {
+      jobId: { type: "string", description: "Job id." },
+      userId: { type: "string", description: "User id to assign." },
+      type: { type: "string", enum: ["company", "sales-owner", "ar-owner"], description: "Rep type (default company)." }
+    }, required: ["jobId", "userId"] } },
+    { name: "acculynx_jobs_document_folders", description: "List the company's document folders.", inputSchema: { type: "object", properties: {
+      pageSize: { type: "number", description: "Items per page." },
+      recordStartIndex: { type: "number", description: "0-based start index (default 0)." },
+      sortOrder: SORT_ORDER
+    }, required: [] } },
+    { name: "acculynx_jobs_add_expense", description: "Record an additional expense on a job from a JSON body.", inputSchema: { type: "object", properties: { jobId: { type: "string", description: "Job id." }, body: BODY }, required: ["jobId", "body"] } },
+    { name: "acculynx_jobs_upload_document", description: "Upload a local file to a job. Blocked extensions: .exe .com .dll .msi .bat .cmd .sh .pl .vbs .py .php.", inputSchema: { type: "object", properties: {
+      jobId: { type: "string", description: "Job id." },
+      filePath: { type: "string", description: "Absolute path to a local file the server can read." },
+      folderId: { type: "string", description: "Destination document folder id (from acculynx_jobs_document_folders)." },
+      description: { type: "string", description: "Brief file description." },
+      externalId: { type: "string", description: "External reference id." },
+      externalSource: { type: "string", description: "External reference source." }
+    }, required: ["jobId", "filePath", "folderId"] } },
+    { name: "acculynx_contacts_list", description: "List contacts (paginated).", inputSchema: { type: "object", properties: { limit: LIMIT, all: ALL }, required: [] } },
+    { name: "acculynx_contacts_get", description: "Get one contact by id.", inputSchema: { type: "object", properties: { contactId: { type: "string", description: "Contact id." } }, required: ["contactId"] } },
+    { name: "acculynx_contacts_create", description: "Create a contact from a JSON body.", inputSchema: { type: "object", properties: { body: BODY }, required: ["body"] } },
+    { name: "acculynx_contacts_search", description: "Search contacts within a date range.", inputSchema: { type: "object", properties: {
+      query: { type: "string", description: "Search term." },
+      startDate: DATE,
+      endDate: DATE,
+      sortBy: { type: "string", enum: ["CreatedDate", "firstName", "lastName"], description: "Sort field (default lastName)." },
+      sortOrder: SORT_ORDER
+    }, required: ["query", "startDate", "endDate"] } },
+    { name: "acculynx_contacts_emails", description: "List a contact's email addresses.", inputSchema: { type: "object", properties: { contactId: { type: "string", description: "Contact id." } }, required: ["contactId"] } },
+    { name: "acculynx_contacts_phones", description: "List a contact's phone numbers.", inputSchema: { type: "object", properties: { contactId: { type: "string", description: "Contact id." } }, required: ["contactId"] } },
+    { name: "acculynx_contacts_phone_add", description: "Add a phone number to a contact. Omit smsOptOut to opt in to SMS.", inputSchema: { type: "object", properties: {
+      contactId: { type: "string", description: "Contact id." },
+      type: { type: "string", enum: ["Mobile", "Home", "Work"], description: "Phone type." },
+      number: { type: "string", description: "Phone number." },
+      smsOptOut: { type: "boolean", description: "Opt this number OUT of SMS (default false = opted in)." }
+    }, required: ["contactId", "type", "number"] } },
+    { name: "acculynx_estimates_list", description: "List estimates (paginated).", inputSchema: { type: "object", properties: { limit: LIMIT, all: ALL }, required: [] } },
+    { name: "acculynx_estimates_get", description: "Get one estimate by id.", inputSchema: { type: "object", properties: { estimateId: { type: "string", description: "Estimate id." } }, required: ["estimateId"] } },
+    { name: "acculynx_estimates_sections", description: "List an estimate's sections.", inputSchema: { type: "object", properties: { estimateId: { type: "string", description: "Estimate id." } }, required: ["estimateId"] } },
+    { name: "acculynx_estimates_section", description: "Get one estimate section.", inputSchema: { type: "object", properties: { estimateId: { type: "string", description: "Estimate id." }, sectionId: { type: "string", description: "Section id." } }, required: ["estimateId", "sectionId"] } },
+    { name: "acculynx_estimates_items", description: "List items in an estimate section.", inputSchema: { type: "object", properties: { estimateId: { type: "string", description: "Estimate id." }, sectionId: { type: "string", description: "Section id." } }, required: ["estimateId", "sectionId"] } },
+    { name: "acculynx_users_list", description: "List users (paginated). Optional client-side search by name/email.", inputSchema: { type: "object", properties: { limit: LIMIT, all: ALL, search: { type: "string", description: "Filter users by name or email (case-insensitive substring)." } }, required: [] } }
+  ];
+}
+async function handleToolCall(call, makeClient = defaultClient) {
+  const args = call.args ?? {};
+  try {
+    const client = makeClient();
+    switch (call.name) {
+      case "acculynx_ping":
+        return ok(await ping(client));
+      case "acculynx_jobs_list":
+        return ok(await jobsList(client, {
+          startDate: str(args.startDate),
+          endDate: str(args.endDate),
+          dateFilterType: str(args.dateFilterType),
+          milestones: str(args.milestones),
+          sortBy: str(args.sortBy),
+          sortOrder: str(args.sortOrder),
+          includes: str(args.includes),
+          assignment: str(args.assignment),
+          limit: resolveLimit(args)
+        }));
+      case "acculynx_jobs_get":
+        return ok(await jobGet(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_create":
+        return ok(await jobCreate(client, args.body));
+      case "acculynx_jobs_search":
+        return ok(await jobSearch(client, str(args.query) ?? ""));
+      case "acculynx_jobs_contacts":
+        return ok(await jobContacts(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_estimates":
+        return ok(await jobEstimates(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_financials":
+        return ok(await jobFinancials(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_invoices":
+        return ok(await jobInvoices(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_milestones":
+        return ok(await jobMilestones(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_payments":
+        return ok(await jobPayments(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_history":
+        return ok(await jobHistory(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_reps":
+        return ok(await jobReps(client, str(args.jobId) ?? ""));
+      case "acculynx_jobs_reps_assign":
+        return ok(await jobRepsAssign(client, str(args.jobId) ?? "", { userId: str(args.userId) ?? "", type: str(args.type) }));
+      case "acculynx_jobs_document_folders":
+        return ok(await documentFolders(client, {
+          pageSize: args.pageSize !== void 0 ? String(num(args.pageSize)) : void 0,
+          recordStartIndex: args.recordStartIndex !== void 0 ? String(num(args.recordStartIndex)) : void 0,
+          sortOrder: str(args.sortOrder)
+        }));
+      case "acculynx_jobs_add_expense":
+        return ok(await jobAddExpense(client, str(args.jobId) ?? "", args.body));
+      case "acculynx_jobs_upload_document":
+        return ok(await jobUploadDocument(client, str(args.jobId) ?? "", str(args.filePath) ?? "", {
+          folderId: str(args.folderId) ?? "",
+          description: str(args.description),
+          externalId: str(args.externalId),
+          externalSource: str(args.externalSource)
+        }));
+      case "acculynx_contacts_list":
+        return ok(await contactsList(client, resolveLimit(args)));
+      case "acculynx_contacts_get":
+        return ok(await contactGet(client, str(args.contactId) ?? ""));
+      case "acculynx_contacts_create":
+        return ok(await contactCreate(client, args.body));
+      case "acculynx_contacts_search":
+        return ok(await contactsSearch(client, {
+          query: str(args.query) ?? "",
+          startDate: str(args.startDate) ?? "",
+          endDate: str(args.endDate) ?? "",
+          sortBy: str(args.sortBy),
+          sortOrder: str(args.sortOrder)
+        }));
+      case "acculynx_contacts_emails":
+        return ok(await contactEmails(client, str(args.contactId) ?? ""));
+      case "acculynx_contacts_phones":
+        return ok(await contactPhones(client, str(args.contactId) ?? ""));
+      case "acculynx_contacts_phone_add":
+        return ok(await contactPhoneAdd(client, str(args.contactId) ?? "", {
+          type: str(args.type) ?? "",
+          number: str(args.number) ?? "",
+          smsOptOut: boolOf(args.smsOptOut)
+        }));
+      case "acculynx_estimates_list":
+        return ok(await estimatesList(client, resolveLimit(args)));
+      case "acculynx_estimates_get":
+        return ok(await estimateGet(client, str(args.estimateId) ?? ""));
+      case "acculynx_estimates_sections":
+        return ok(await estimateSections(client, str(args.estimateId) ?? ""));
+      case "acculynx_estimates_section":
+        return ok(await estimateSection(client, str(args.estimateId) ?? "", str(args.sectionId) ?? ""));
+      case "acculynx_estimates_items":
+        return ok(await estimateItems(client, str(args.estimateId) ?? "", str(args.sectionId) ?? ""));
+      case "acculynx_users_list":
+        return ok(await usersList(client, { limit: resolveLimit(args), search: str(args.search) }));
+      default:
+        return fail({ error: "unknown_tool", message: `Unknown tool: ${call.name}` });
+    }
+  } catch (e) {
+    return fail({ error: "acculynx_error", message: e instanceof Error ? e.message : String(e) });
+  }
+}
+
+// src/mcp.ts
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
+function log(msg) {
+  process.stderr.write(`[acculynx-mcp] ${msg}
+`);
+}
+async function bootSelfCheck(getCfg = () => getConfig({}), logFn = log, exit = process.exit) {
+  try {
+    getCfg();
+  } catch (e) {
+    logFn(`fatal: ${e instanceof Error ? e.message : String(e)}`);
+    exit(1);
+  }
+}
+async function main() {
+  await bootSelfCheck();
+  let extendedTools = [];
+  let handleExtended = null;
+  try {
+    const resolved = require2.resolve("@opsrev/acculynx-cli-unofficial");
+    const mod = await import(resolved);
+    if (typeof mod.extendedTools === "function" && typeof mod.handleExtendedToolCall === "function") {
+      extendedTools = mod.extendedTools();
+      handleExtended = mod.handleExtendedToolCall;
+    }
+  } catch {
+  }
+  const publicNames = new Set(buildTools().map((t) => t.name));
+  const server = new Server({ name: "acculynx", version }, { capabilities: { tools: {} } });
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [...buildTools(), ...extendedTools] }));
+  server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const call = { name: req.params.name, args: req.params.arguments };
+    if (publicNames.has(call.name) || !handleExtended) {
+      return await handleToolCall(call);
+    }
+    return await handleExtended(call);
+  });
+  await server.connect(new StdioServerTransport());
+  log("connected (stdio)");
+}
+if (process.env.VITEST === void 0) {
+  main().catch((e) => {
+    log(`fatal: ${e instanceof Error ? e.stack ?? e.message : String(e)}`);
+    process.exit(1);
+  });
+}
+export {
+  bootSelfCheck
+};

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@opsrev/acculynx-cli",
-  "version": "1.9.2",
+  "version": "1.11.0",
   "description": "CLI for the AccuLynx roofing CRM API",
   "type": "module",
   "bin": {
-    "acculynx": "./dist/index.js"
+    "acculynx": "./dist/index.js",
+    "acculynx-mcp": "./dist/mcp.js"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/mcp.ts --format esm --dts --clean",
     "dev": "tsx --env-file=.env src/index.ts",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -28,6 +29,7 @@
     "dist"
   ],
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^14.0.3"
   },
   "devDependencies": {