@opsrev/acculynx-cli 1.12.0 → 1.13.1

package/README.md

@@ -1,104 +1,140 @@
-# @opsrev/acculynx-cli
+# AccuLynx MCP Server & CLI
 
-[![CI](https://github.com/opsrev/acculynx-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/opsrev/acculynx-cli/actions/workflows/ci.yml)
-
-CLI for the AccuLynx roofing CRM API. Designed for AI agent consumption -- all output is JSON.
-
-## Installation
+> npm: [`acculynx-mcp`](https://www.npmjs.com/package/acculynx-mcp) (MCP server) · [`@opsrev/acculynx-cli`](https://www.npmjs.com/package/@opsrev/acculynx-cli) (CLI + MCP)
 
-```bash
-npm install -g @opsrev/acculynx-cli
-```
-
-## Configuration
-
-Copy the example env file and fill in your credentials:
+[![CI](https://github.com/opsrev/acculynx-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/opsrev/acculynx-cli/actions/workflows/ci.yml)
 
-```bash
-cp .env.example .env
+An **MCP server** for the [AccuLynx](https://www.acculynx.com/) roofing CRM —
+bring jobs, contacts, and estimates into Claude Desktop, Cursor, or any MCP
+client. Every tool is exposed with an enforced JSON Schema, so an AI agent can't
+invent a parameter or call a command that doesn't exist.
+
+- **30 tools** across jobs, contacts, estimates, and users.
+- **`acculynx-mcp`** — the MCP server, for Claude Desktop / Cursor / any MCP client.
+- **`@opsrev/acculynx-cli`** — the same data as a JSON CLI (and it also ships the `acculynx-mcp` server bin).
+
+## Use in Claude Desktop
+
+1. Get an AccuLynx API key (your AccuLynx account administrator creates it under
+   **Account Settings → API**).
+2. Open your Claude Desktop config file:
+   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+3. Add the server (zero-install via `npx`):
+
+```jsonc
+{
+  "mcpServers": {
+    "acculynx": {
+      "command": "npx",
+      "args": ["-y", "acculynx-mcp"],
+      "env": { "ACCULYNX_API_KEY": "your-api-key" }
+    }
+  }
+}
 ```
 
-Your `.env` is gitignored and will never be committed.
+Prefer a global install? Run `npm i -g acculynx-mcp`, then use
+`"command": "acculynx-mcp"` with no `args`.
 
-| Env Var | Flag | Description |
-|---------|------|-------------|
-| `ACCULYNX_API_KEY` | `--api-key` | AccuLynx API key (required) |
+4. Restart Claude Desktop. Open a new chat and ask *"List my 5 most recent
+   AccuLynx jobs"* — you should see the `acculynx_*` tools available.
 
-API keys are created by your AccuLynx account administrator under Account Settings.
+## Use in Cursor / other MCP clients
 
-## Commands
+Any client that speaks MCP over stdio works. Point it at `npx -y acculynx-mcp`
+(or a global `acculynx-mcp`) and set `ACCULYNX_API_KEY` in the environment.
+Example (Cursor `~/.cursor/mcp.json`):
 
+```json
+{
+  "mcpServers": {
+    "acculynx": {
+      "command": "npx",
+      "args": ["-y", "acculynx-mcp"],
+      "env": { "ACCULYNX_API_KEY": "your-api-key" }
+    }
+  }
+}
 ```
-acculynx ping                                  # Health check / verify API key
-acculynx jobs list [--limit <n>] [--all]         # List jobs (default: 25 results)
-acculynx jobs get <jobId>                       # Get job details
-acculynx jobs create                            # Create a job (JSON from stdin)
-acculynx jobs search --query <text>             # Search jobs
-acculynx jobs contacts <jobId>                  # List job contacts
-acculynx jobs estimates <jobId>                 # List job estimates
-acculynx jobs financials <jobId>                # Get job financials
-acculynx jobs invoices <jobId>                  # List job invoices
-acculynx jobs milestones <jobId>                # List job milestone history
-acculynx jobs payments <jobId>                  # List job payments
-acculynx jobs history <jobId>                   # Get job change history
-acculynx contacts list [--limit <n>] [--all]    # List contacts (default: 25 results)
-acculynx contacts get <contactId>               # Get contact details
-acculynx contacts create                        # Create a contact (JSON from stdin)
-acculynx contacts search --query <text>         # Search contacts
-acculynx contacts emails <contactId>            # List contact email addresses
-acculynx contacts phones <contactId>            # List contact phone numbers
-acculynx estimates list [--limit <n>] [--all]   # List estimates (default: 25 results)
-acculynx estimates get <estimateId>             # Get estimate details
-acculynx estimates sections <estimateId>        # List sections for an estimate
-acculynx estimates section <estimateId> <secId> # Get section details
-acculynx estimates items <estimateId> <secId>   # List items in a section
-```
-
-### Pagination
 
-All list commands default to **25 results**. Use `--limit <n>` for a custom count or `--all` to fetch everything:
+## MCP tools
+
+All tools are prefixed `acculynx_` and return JSON.
+
+| Tool | Description |
+|------|-------------|
+| `acculynx_ping` | Health check — verify the API key and connectivity |
+| `acculynx_jobs_list` | List jobs (paginated, filterable) |
+| `acculynx_jobs_get` | Get one job by id |
+| `acculynx_jobs_create` | Create a job |
+| `acculynx_jobs_search` | Search jobs by free-text term |
+| `acculynx_jobs_contacts` | List a job's contacts |
+| `acculynx_jobs_estimates` | List a job's estimates |
+| `acculynx_jobs_financials` | Get a job's financials |
+| `acculynx_jobs_invoices` | List a job's invoices |
+| `acculynx_jobs_milestones` | List a job's milestone history |
+| `acculynx_jobs_payments` | List a job's payments |
+| `acculynx_jobs_history` | Get a job's change history |
+| `acculynx_jobs_reps` | List a job's representatives |
+| `acculynx_jobs_reps_assign` | Assign a representative to a job |
+| `acculynx_jobs_work_types` | List the company's active work types (id + name) |
+| `acculynx_jobs_trade_types` | List the company's active trade types (id + name) |
+| `acculynx_jobs_set_work_type` | Set a job's work type — by `workType` name or `workTypeId` |
+| `acculynx_jobs_set_trade_types` | Set a job's trade types — by `tradeTypes` names or `tradeTypeIds` (empty array unassigns all) |
+| `acculynx_jobs_document_folders` | List the company's document folders |
+| `acculynx_jobs_add_expense` | Record an additional expense on a job |
+| `acculynx_jobs_upload_document` | Upload a local file to a job |
+| `acculynx_contacts_list` | List contacts (paginated) |
+| `acculynx_contacts_get` | Get one contact by id |
+| `acculynx_contacts_create` | Create a contact |
+| `acculynx_contacts_search` | Search contacts within a date range |
+| `acculynx_contacts_emails` | List a contact's email addresses |
+| `acculynx_contacts_phones` | List a contact's phone numbers |
+| `acculynx_contacts_phone_add` | Add a phone number to a contact |
+| `acculynx_estimates_list` | List estimates (paginated) |
+| `acculynx_estimates_get` | Get one estimate by id |
+| `acculynx_estimates_sections` | List an estimate's sections |
+| `acculynx_estimates_section` | Get one estimate section |
+| `acculynx_estimates_items` | List items in an estimate section |
+| `acculynx_users_list` | List users (paginated, optional name/email search) |
 
-```bash
-acculynx jobs list                  # 25 results (default)
-acculynx jobs list --limit 100      # 100 results
-acculynx jobs list --all            # all results
-```
+## Configuration
 
-### Jobs list filters
+| Env Var | Flag | Required | Description |
+|---------|------|----------|-------------|
+| `ACCULYNX_API_KEY` | `--api-key` | Yes | AccuLynx official API key (Account Settings → API) |
+| `ACCULYNX_EMAIL` | — | No | Login email; only for tools that use AccuLynx's web API |
+| `ACCULYNX_PASSWORD` | — | No | Login password; only for web-API tools |
+| `ACCULYNX_COMPANY_ID` | — | No | Company GUID; only for web-API tools |
 
-- `--start-date <YYYY-MM-DD>` -- filter by start date
-- `--end-date <YYYY-MM-DD>` -- filter by end date
-- `--date-filter-type <type>` -- date field to filter on (default: CreatedDate)
-- `--milestones <milestones>` -- filter by milestones
-- `--sort-by <field>` -- CreatedDate, MilestoneDate, or ModifiedDate
-- `--sort-order <order>` -- Ascending or Descending
-- `--includes <fields>` -- contact, initialAppointment
+## Also a CLI
 
-### Search
+`@opsrev/acculynx-cli` exposes the same data as a JSON CLI (and bundles the
+`acculynx-mcp` server bin). All output is JSON to stdout; errors are
+`{"error": "..."}` to stderr with exit code 1.
 
 ```bash
+npm install -g @opsrev/acculynx-cli
+
+acculynx ping                              # verify API key
+acculynx jobs list --limit 5               # 25 results by default; --all to fetch everything
+acculynx jobs get <jobId>
 acculynx jobs search --query "smith"
-acculynx contacts search --query "smith"
-acculynx contacts search --query "smith" --sort-by LastName --sort-order Descending
+acculynx contacts list --limit 10
+acculynx estimates get <estimateId>
 ```
 
-### Stdin commands
-
-Commands that create resources accept JSON piped via stdin:
+List commands default to **25 results**; use `--limit <n>` or `--all`. Commands
+that create resources read a JSON body from stdin:
 
 ```bash
 echo '{"name": "New Job"}' | acculynx jobs create
 ```
 
-## Output
-
-All output is JSON to stdout. Errors are `{"error": "..."}` to stderr with exit code 1.
+Pipe to `jq` for scripting:
 
 ```bash
-# Pipe to jq for pretty-printing
-acculynx jobs list --limit 5 | jq .
-
-# Use in scripts
 JOB_ID=$(acculynx jobs list --limit 1 | jq -r '.[0].id')
 acculynx jobs get "$JOB_ID" | jq .
 ```
@@ -106,15 +142,14 @@ acculynx jobs get "$JOB_ID" | jq .
 ## Development
 
 ```bash
-cp .env.example .env  # fill in your credentials
+cp .env.example .env   # fill in your credentials
 npm install
-npm test              # run unit tests
-npm run dev -- --help # run in dev mode (auto-loads .env)
-npm run build         # build to dist/
-./test-integration.sh # run integration tests (requires ACCULYNX_API_KEY)
+npm test               # run unit tests (mocked fetch)
+npm run dev -- --help  # run the CLI in dev mode (auto-loads .env)
+npm run build          # build both bins to dist/
 ```
 
-The `npm run dev` script automatically loads your `.env` file via Node's `--env-file` flag (Node 20.6+). Examples:
+`npm run dev` auto-loads `.env` via Node's `--env-file`:
 
 ```bash
 npm run dev -- jobs list --limit 5

package/dist/{chunk-GAJNPAO3.js → chunk-AKUPC2EI.js}

@@ -113,6 +113,22 @@ function createApiClient(config) {
     const text = await response.text();
     return text ? JSON.parse(text) : { status: response.status };
   }
+  async function doPut(path, body) {
+    const url = `${config.baseUrl}${path}`;
+    const response = await fetchWithRetry(url, {
+      method: "PUT",
+      headers: { ...headers, "Content-Type": "application/json" },
+      body: JSON.stringify(sanitizeDeep(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;
@@ -133,6 +149,7 @@ function createApiClient(config) {
   return {
     get: doGet,
     post: doPost,
+    put: doPut,
     postForm: doPostForm
   };
 }
@@ -233,6 +250,55 @@ function jobRepsAssign(client, jobId, opts) {
   const type = opts.type ?? "company";
   return client.post(`/jobs/${jobId}/representatives/${type}`, { id: opts.userId });
 }
+function jobSetWorkType(client, jobId, workTypeId) {
+  return client.put(`/jobs/${jobId}/work-type`, { workTypeId });
+}
+function jobSetTradeTypes(client, jobId, tradeTypeIds) {
+  return client.put(`/jobs/${jobId}/trade-types`, { tradeTypeIds });
+}
+function companyWorkTypes(client) {
+  return paginate(client, "/company-settings/job-file-settings/work-types", {}, Infinity);
+}
+function companyTradeTypes(client) {
+  return paginate(client, "/company-settings/job-file-settings/trade-types", {}, Infinity);
+}
+function resolveNamed(items, value, opts) {
+  const v = value.trim();
+  const idOf = (item) => item[opts.idKey];
+  const nameOf = (item) => String(item.name ?? "");
+  if (opts.idIsNumeric) {
+    if (/^\d+$/.test(v)) {
+      const hit = items.find((item) => Number(idOf(item)) === Number(v));
+      if (hit) return idOf(hit);
+    }
+  } else {
+    const hit = items.find((item) => String(idOf(item)) === v);
+    if (hit) return idOf(hit);
+  }
+  const lower = v.toLowerCase();
+  const exact = items.filter((item) => nameOf(item).toLowerCase() === lower);
+  if (exact.length === 1) return idOf(exact[0]);
+  const partial = items.filter((item) => nameOf(item).toLowerCase().includes(lower));
+  if (partial.length === 1) return idOf(partial[0]);
+  if (partial.length > 1) {
+    throw new Error(
+      `"${value}" matches multiple ${opts.label}s: ${partial.map(nameOf).join(", ")}. Be more specific.`
+    );
+  }
+  throw new Error(
+    `No ${opts.label} matches "${value}". Available ${opts.label}s: ${items.map(nameOf).join(", ")}`
+  );
+}
+async function resolveWorkTypeId(client, value) {
+  const items = await companyWorkTypes(client);
+  return resolveNamed(items, value, { label: "work type", idKey: "id", idIsNumeric: true });
+}
+async function resolveTradeTypeIds(client, values) {
+  const items = await companyTradeTypes(client);
+  return values.map(
+    (value) => resolveNamed(items, value, { label: "trade type", idKey: "id", idIsNumeric: false })
+  );
+}
 function documentFolders(client, opts = {}) {
   const params = {
     recordStartIndex: opts.recordStartIndex ?? "0",
@@ -332,6 +398,12 @@ export {
   jobHistory,
   jobReps,
   jobRepsAssign,
+  jobSetWorkType,
+  jobSetTradeTypes,
+  companyWorkTypes,
+  companyTradeTypes,
+  resolveWorkTypeId,
+  resolveTradeTypeIds,
   documentFolders,
   jobAddExpense,
   jobUploadDocument,

package/dist/index.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import {
+  companyTradeTypes,
+  companyWorkTypes,
   contactCreate,
   contactEmails,
   contactGet,
@@ -28,12 +30,16 @@ import {
   jobReps,
   jobRepsAssign,
   jobSearch,
+  jobSetTradeTypes,
+  jobSetWorkType,
   jobUploadDocument,
   jobsList,
   ping,
   readStdin,
+  resolveTradeTypeIds,
+  resolveWorkTypeId,
   usersList
-} from "./chunk-GAJNPAO3.js";
+} from "./chunk-AKUPC2EI.js";
 
 // src/index.ts
 import { createRequire } from "module";
@@ -48,6 +54,9 @@ function registerPingCommand(parentCmd, getClient2) {
 }
 
 // src/commands/jobs.ts
+function collect(value, previous) {
+  return [...previous, value];
+}
 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) => {
@@ -96,6 +105,56 @@ function registerJobsCommands(parentCmd, getClient2) {
     const result = await jobRepsAssign(getClient2(), jobId, { userId: opts.userId, type: opts.type });
     console.log(JSON.stringify(result));
   });
+  jobs.command("work-types").description("List the company's active work types (id + name)").action(async () => {
+    console.log(JSON.stringify(await companyWorkTypes(getClient2())));
+  });
+  jobs.command("trade-types").description("List the company's active trade types (id + name)").action(async () => {
+    console.log(JSON.stringify(await companyTradeTypes(getClient2())));
+  });
+  jobs.command("set-work-type").argument("<jobId>", "Job ID").description("Set the work type for a job (by name or id)").option("--work-type <name>", "Work type name (resolved against the company's work types)").option("--work-type-id <id>", "Work type ID (integer)").action(async (jobId, opts) => {
+    const nameGiven = opts.workType !== void 0;
+    const idGiven = opts.workTypeId !== void 0;
+    if (nameGiven && idGiven) {
+      throw new Error("Use either --work-type or --work-type-id, not both");
+    }
+    if (!nameGiven && !idGiven) {
+      throw new Error("Provide --work-type <name> or --work-type-id <id>");
+    }
+    const client = getClient2();
+    let workTypeId;
+    if (idGiven) {
+      workTypeId = Number(opts.workTypeId);
+      if (!Number.isInteger(workTypeId)) {
+        throw new Error("--work-type-id must be an integer");
+      }
+    } else {
+      workTypeId = await resolveWorkTypeId(client, opts.workType);
+    }
+    const result = await jobSetWorkType(client, jobId, workTypeId);
+    console.log(JSON.stringify(result));
+  });
+  jobs.command("set-trade-types").argument("<jobId>", "Job ID").description(
+    "Set trade types for a job (by name or id), replacing existing ones. Use --clear to unassign all."
+  ).option("--trade-type <name>", "Trade type name, resolved against the company's trade types (repeatable)", collect, []).option("--trade-type-id <uuid>", "Trade type ID (repeatable)", collect, []).option("--clear", "Unassign all trade types").action(async (jobId, opts) => {
+    const names = opts.tradeType;
+    const ids = opts.tradeTypeId;
+    const sources = [names.length > 0, ids.length > 0, Boolean(opts.clear)].filter(Boolean).length;
+    if (opts.clear && (names.length > 0 || ids.length > 0)) {
+      throw new Error("Cannot combine --clear with --trade-type or --trade-type-id");
+    }
+    if (names.length > 0 && ids.length > 0) {
+      throw new Error("Use either --trade-type or --trade-type-id, not both");
+    }
+    if (sources === 0) {
+      throw new Error(
+        "Provide --trade-type <name>, --trade-type-id <uuid>, or --clear to unassign all trade types"
+      );
+    }
+    const client = getClient2();
+    const resolved = names.length > 0 ? await resolveTradeTypeIds(client, names) : ids;
+    const result = await jobSetTradeTypes(client, jobId, resolved);
+    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 result = await documentFolders(getClient2(), {
       pageSize: opts.pageSize,

package/dist/mcp.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import {
+  companyTradeTypes,
+  companyWorkTypes,
   contactCreate,
   contactEmails,
   contactGet,
@@ -28,11 +30,15 @@ import {
   jobReps,
   jobRepsAssign,
   jobSearch,
+  jobSetTradeTypes,
+  jobSetWorkType,
   jobUploadDocument,
   jobsList,
   ping,
+  resolveTradeTypeIds,
+  resolveWorkTypeId,
   usersList
-} from "./chunk-GAJNPAO3.js";
+} from "./chunk-AKUPC2EI.js";
 
 // src/mcp.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -59,6 +65,7 @@ var num = (v) => {
   return Number.isNaN(n) ? void 0 : n;
 };
 var boolOf = (v) => typeof v === "boolean" ? v : void 0;
+var strArray = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
 var resolveLimit = (args) => boolOf(args.all) ? Infinity : num(args.limit);
 function defaultClient() {
   return createApiClient(getConfig({}));
@@ -94,6 +101,18 @@ function buildTools() {
       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_work_types", description: "List the company's active work types (id + name). Useful for resolving a work type name to its id.", inputSchema: { type: "object", properties: {}, required: [] } },
+    { name: "acculynx_jobs_trade_types", description: "List the company's active trade types (id + name). Useful for resolving a trade type name to its id.", inputSchema: { type: "object", properties: {}, required: [] } },
+    { name: "acculynx_jobs_set_work_type", description: "Set a job's work type, replacing the current one. Provide exactly one of workType (a name, resolved against the company's work types) or workTypeId.", inputSchema: { type: "object", properties: {
+      jobId: { type: "string", description: "Job id." },
+      workType: { type: "string", description: "Work type name (e.g. 'Insurance'). Resolved against the company's work types; case-insensitive, unique-substring match." },
+      workTypeId: { type: "integer", description: "Work type id (integer), if already known." }
+    }, required: ["jobId"] } },
+    { name: "acculynx_jobs_set_trade_types", description: "Set a job's trade types, replacing any existing ones. Provide exactly one of tradeTypes (names, resolved against the company's trade types) or tradeTypeIds (uuids). An empty array unassigns all trade types.", inputSchema: { type: "object", properties: {
+      jobId: { type: "string", description: "Job id." },
+      tradeTypes: { type: "array", items: { type: "string" }, description: "Trade type names (e.g. ['Windows','Roofing']). Each is resolved against the company's trade types. An empty array unassigns all." },
+      tradeTypeIds: { type: "array", items: { type: "string" }, description: "Trade type ids (uuids), if already known. An empty array unassigns all." }
+    }, required: ["jobId"] } },
     { 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)." },
@@ -177,6 +196,27 @@ async function handleToolCall(call, makeClient = defaultClient) {
         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_work_types":
+        return ok(await companyWorkTypes(client));
+      case "acculynx_jobs_trade_types":
+        return ok(await companyTradeTypes(client));
+      case "acculynx_jobs_set_work_type": {
+        const nameGiven = args.workType !== void 0;
+        const idGiven = args.workTypeId !== void 0;
+        if (nameGiven && idGiven) throw new Error("Provide either workType or workTypeId, not both");
+        if (!nameGiven && !idGiven) throw new Error("Provide workType (name) or workTypeId");
+        const workTypeId = nameGiven ? await resolveWorkTypeId(client, str(args.workType) ?? "") : num(args.workTypeId) ?? 0;
+        return ok(await jobSetWorkType(client, str(args.jobId) ?? "", workTypeId));
+      }
+      case "acculynx_jobs_set_trade_types": {
+        const namesGiven = args.tradeTypes !== void 0;
+        const idsGiven = args.tradeTypeIds !== void 0;
+        if (namesGiven && idsGiven) throw new Error("Provide either tradeTypes or tradeTypeIds, not both");
+        if (!namesGiven && !idsGiven) throw new Error("Provide tradeTypes (names) or tradeTypeIds (an empty array unassigns all)");
+        const names = strArray(args.tradeTypes);
+        const ids = namesGiven ? names.length > 0 ? await resolveTradeTypeIds(client, names) : [] : strArray(args.tradeTypeIds);
+        return ok(await jobSetTradeTypes(client, str(args.jobId) ?? "", ids));
+      }
       case "acculynx_jobs_document_folders":
         return ok(await documentFolders(client, {
           pageSize: args.pageSize !== void 0 ? String(num(args.pageSize)) : void 0,

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@opsrev/acculynx-cli",
-  "version": "1.12.0",
-  "description": "CLI for the AccuLynx roofing CRM API",
+  "version": "1.13.1",
+  "description": "AccuLynx MCP server & CLI — use the AccuLynx roofing CRM in Claude Desktop, Cursor, and any MCP client. Also a JSON CLI for scripts and AI agents.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opsrev/acculynx-cli.git"
+  },
+  "homepage": "https://github.com/opsrev/acculynx-cli#readme",
+  "bugs": {
+    "url": "https://github.com/opsrev/acculynx-cli/issues"
+  },
+  "mcpName": "io.github.opsrev/acculynx",
   "type": "module",
   "bin": {
     "acculynx": "./dist/index.js",
@@ -16,9 +25,18 @@
   },
   "keywords": [
     "acculynx",
-    "cli",
+    "acculynx-mcp",
+    "mcp",
+    "model-context-protocol",
+    "modelcontextprotocol",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "ai-agents",
     "roofing",
+    "roofing-crm",
     "crm",
+    "cli",
     "api"
   ],
   "license": "MIT",