0nmcp 2.5.0 → 2.7.0

package/cli.js

@@ -76,6 +76,14 @@ async function main() {
     return;
   }
 
+  // ── Install (full onboarding — no login required) ─────────
+
+  if (command === 'install') {
+    const { install } = await import('./install.js');
+    await install();
+    return;
+  }
+
   // ── Auth commands (no login required) ──────────────────────
 
   if (command === 'login') {
@@ -194,7 +202,7 @@ ${c.bright}Links:${c.reset}
 
   // ── Auth Gate ──────────────────────────────────────────────
   // All commands below this point require authentication.
-  const AUTH_FREE = ['help', '--help', '-h', 'login', 'logout', 'whoami', 'version', '--version', '-v'];
+  const AUTH_FREE = ['help', '--help', '-h', 'login', 'logout', 'whoami', 'version', '--version', '-v', 'install'];
   if (!AUTH_FREE.includes(command)) {
     try {
       const { isAuthenticated } = await import('./auth.js');

package/crm/agent-studio.js

@@ -0,0 +1,114 @@
+// ============================================================
+// 0nMCP — CRM Agent Studio API Tool Definitions
+// ============================================================
+// AI agents per location with knowledge base + MCP integration.
+// Agents can call 0nMCP tools via MCP Server nodes.
+// ============================================================
+
+export default [
+  {
+    name: "crm_list_agents",
+    description: "List all Agent Studio agents for a location with pagination.",
+    method: "GET",
+    path: "/agent-studio/agent",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "query" },
+      limit: { type: "number", description: "Results per page", required: false, in: "query" },
+      offset: { type: "number", description: "Pagination offset", required: false, in: "query" },
+    },
+  },
+
+  {
+    name: "crm_create_agent",
+    description: "Create a new Agent Studio agent with a staging version. Can be connected to knowledge bases and MCP servers.",
+    method: "POST",
+    path: "/agent-studio/agent",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      name: { type: "string", description: "Agent name", required: true, in: "body" },
+      description: { type: "string", description: "Agent description", required: false, in: "body" },
+    },
+    body: ["locationId", "name", "description"],
+  },
+
+  {
+    name: "crm_get_agent",
+    description: "Get a specific Agent Studio agent by ID with all versions.",
+    method: "GET",
+    path: "/agent-studio/agent/:agentId",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+      locationId: { type: "string", description: "Location ID", required: true, in: "query" },
+    },
+  },
+
+  {
+    name: "crm_update_agent",
+    description: "Update an agent version — modify nodes, edges, variables, knowledge base connections, and MCP server nodes.",
+    method: "PUT",
+    path: "/agent-studio/agent/:agentId",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      versionId: { type: "string", description: "Version ID to update", required: true, in: "body" },
+      nodes: { type: "array", description: "Array of workflow nodes (knowledge_base, mcp_server, action, condition, etc.)", required: false, in: "body" },
+      edges: { type: "array", description: "Array of edges connecting nodes", required: false, in: "body" },
+      variables: { type: "object", description: "Agent variables/context", required: false, in: "body" },
+    },
+    body: ["locationId", "versionId", "nodes", "edges", "variables"],
+  },
+
+  {
+    name: "crm_update_agent_metadata",
+    description: "Update agent name, description, and status (active/inactive).",
+    method: "PATCH",
+    path: "/agent-studio/agent/:agentId/metadata",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      name: { type: "string", description: "Agent name", required: false, in: "body" },
+      description: { type: "string", description: "Description", required: false, in: "body" },
+      status: { type: "string", description: "Agent status (active, inactive)", required: false, in: "body" },
+    },
+    body: ["locationId", "name", "description", "status"],
+  },
+
+  {
+    name: "crm_delete_agent",
+    description: "Delete an Agent Studio agent and all its versions.",
+    method: "DELETE",
+    path: "/agent-studio/agent/:agentId",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+      locationId: { type: "string", description: "Location ID", required: true, in: "query" },
+    },
+  },
+
+  {
+    name: "crm_promote_agent",
+    description: "Promote an agent's draft/staging version to production.",
+    method: "POST",
+    path: "/agent-studio/agent/:agentId/promote",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      versionId: { type: "string", description: "Version ID to promote", required: true, in: "body" },
+    },
+    body: ["locationId", "versionId"],
+  },
+
+  {
+    name: "crm_execute_agent",
+    description: "Execute an Agent Studio agent. Send a message and get a response. Use executionId to maintain conversation sessions.",
+    method: "POST",
+    path: "/agent-studio/agent/:agentId/execute",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      message: { type: "string", description: "User message to send to the agent", required: true, in: "body" },
+      executionId: { type: "string", description: "Previous execution ID to continue a conversation session. Omit for new sessions.", required: false, in: "body" },
+      contactId: { type: "string", description: "Contact ID for context", required: false, in: "body" },
+    },
+    body: ["locationId", "message", "executionId", "contactId"],
+  },
+]

package/crm/funnels.js

@@ -0,0 +1,90 @@
+// ============================================================
+// 0nMCP — CRM Funnels & Forms & Surveys Tool Definitions
+// ============================================================
+
+export default [
+  // ── Funnels ────────────────────────────────────────────────
+
+  { name: "crm_list_funnels", description: "List all funnels for a location.", method: "GET", path: "/funnels/funnel/list",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, limit: { type: "number", description: "Results per page", required: false, in: "query" }, offset: { type: "number", description: "Offset", required: false, in: "query" } } },
+
+  { name: "crm_list_funnel_pages", description: "List all pages across funnels for a location.", method: "GET", path: "/funnels/page",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, funnelId: { type: "string", description: "Filter by funnel ID", required: false, in: "query" }, limit: { type: "number", description: "Results per page", required: false, in: "query" }, offset: { type: "number", description: "Offset", required: false, in: "query" } } },
+
+  { name: "crm_count_funnel_pages", description: "Get count of funnel pages for a location.", method: "GET", path: "/funnels/page/count",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, funnelId: { type: "string", description: "Filter by funnel ID", required: false, in: "query" } } },
+
+  { name: "crm_create_redirect", description: "Create a URL redirect/trigger link.", method: "POST", path: "/funnels/lookup/redirect",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "body" }, target: { type: "string", description: "Target URL", required: true, in: "body" }, domain: { type: "string", description: "Domain", required: false, in: "body" }, path: { type: "string", description: "Path slug", required: false, in: "body" } },
+    body: ["locationId", "target", "domain", "path"] },
+
+  { name: "crm_list_redirects", description: "List all redirects for a location.", method: "GET", path: "/funnels/lookup/redirect/list",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, limit: { type: "number", description: "Results", required: false, in: "query" }, offset: { type: "number", description: "Offset", required: false, in: "query" } } },
+
+  { name: "crm_update_redirect", description: "Update a redirect by ID.", method: "PATCH", path: "/funnels/lookup/redirect/:id",
+    params: { id: { type: "string", description: "Redirect ID", required: true, in: "path" }, target: { type: "string", description: "New target URL", required: false, in: "body" } },
+    body: ["target"] },
+
+  { name: "crm_delete_redirect", description: "Delete a redirect by ID.", method: "DELETE", path: "/funnels/lookup/redirect/:id",
+    params: { id: { type: "string", description: "Redirect ID", required: true, in: "path" } } },
+
+  // ── Forms ──────────────────────────────────────────────────
+
+  { name: "crm_list_forms", description: "List all forms for a location.", method: "GET", path: "/forms/",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, limit: { type: "number", description: "Results", required: false, in: "query" }, skip: { type: "number", description: "Skip", required: false, in: "query" }, type: { type: "string", description: "Form type filter", required: false, in: "query" } } },
+
+  { name: "crm_list_form_submissions", description: "List form submissions with filters.", method: "GET", path: "/forms/submissions",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, formId: { type: "string", description: "Filter by form ID", required: false, in: "query" }, startAt: { type: "string", description: "Start date ISO", required: false, in: "query" }, endAt: { type: "string", description: "End date ISO", required: false, in: "query" }, limit: { type: "number", description: "Results", required: false, in: "query" }, page: { type: "number", description: "Page", required: false, in: "query" } } },
+
+  // ── Surveys ────────────────────────────────────────────────
+
+  { name: "crm_list_surveys", description: "List all surveys for a location.", method: "GET", path: "/surveys/",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, limit: { type: "number", description: "Results", required: false, in: "query" }, skip: { type: "number", description: "Skip", required: false, in: "query" }, type: { type: "string", description: "Survey type filter", required: false, in: "query" } } },
+
+  { name: "crm_list_survey_submissions", description: "List survey submissions with filters.", method: "GET", path: "/surveys/submissions",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" }, surveyId: { type: "string", description: "Filter by survey ID", required: false, in: "query" }, startAt: { type: "string", description: "Start date ISO", required: false, in: "query" }, endAt: { type: "string", description: "End date ISO", required: false, in: "query" }, limit: { type: "number", description: "Results", required: false, in: "query" }, page: { type: "number", description: "Page", required: false, in: "query" } } },
+
+  // ── Associations ───────────────────────────────────────────
+
+  { name: "crm_list_associations", description: "List all associations for a location.", method: "GET", path: "/associations/",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "query" } } },
+
+  { name: "crm_create_association", description: "Create a new association between object types.", method: "POST", path: "/associations/",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "body" }, key: { type: "string", description: "Association key name", required: true, in: "body" }, fromObjectKey: { type: "string", description: "Source object key", required: true, in: "body" }, toObjectKey: { type: "string", description: "Target object key", required: true, in: "body" } },
+    body: ["locationId", "key", "fromObjectKey", "toObjectKey"] },
+
+  { name: "crm_get_association", description: "Get association by ID.", method: "GET", path: "/associations/:associationId",
+    params: { associationId: { type: "string", description: "Association ID", required: true, in: "path" } } },
+
+  { name: "crm_update_association", description: "Update an association.", method: "PUT", path: "/associations/:associationId",
+    params: { associationId: { type: "string", description: "Association ID", required: true, in: "path" }, key: { type: "string", description: "Association key", required: false, in: "body" } },
+    body: ["key"] },
+
+  { name: "crm_delete_association", description: "Delete an association.", method: "DELETE", path: "/associations/:associationId",
+    params: { associationId: { type: "string", description: "Association ID", required: true, in: "path" } } },
+
+  { name: "crm_create_relation", description: "Create a relation between two records.", method: "POST", path: "/associations/relations",
+    params: { locationId: { type: "string", description: "Location ID", required: true, in: "body" }, associationId: { type: "string", description: "Association ID", required: true, in: "body" }, fromRecordId: { type: "string", description: "Source record ID", required: true, in: "body" }, toRecordId: { type: "string", description: "Target record ID", required: true, in: "body" } },
+    body: ["locationId", "associationId", "fromRecordId", "toRecordId"] },
+
+  { name: "crm_list_relations", description: "Get all relations for a record.", method: "GET", path: "/associations/relations/:recordId",
+    params: { recordId: { type: "string", description: "Record ID", required: true, in: "path" } } },
+
+  { name: "crm_delete_relation", description: "Delete a relation.", method: "DELETE", path: "/associations/relations/:relationId",
+    params: { relationId: { type: "string", description: "Relation ID", required: true, in: "path" } } },
+
+  // ── Snapshots ──────────────────────────────────────────────
+
+  { name: "crm_list_snapshots", description: "List all account snapshots/templates.", method: "GET", path: "/snapshots/",
+    params: { companyId: { type: "string", description: "Company ID", required: true, in: "query" } } },
+
+  { name: "crm_create_snapshot_share_link", description: "Create a shareable link for a snapshot.", method: "POST", path: "/snapshots/share/link",
+    params: { companyId: { type: "string", description: "Company ID", required: true, in: "body" }, snapshotId: { type: "string", description: "Snapshot ID", required: true, in: "body" }, shareType: { type: "string", description: "Share type (link, permanent)", required: false, in: "body" } },
+    body: ["companyId", "snapshotId", "shareType"] },
+
+  { name: "crm_get_snapshot_push_status", description: "Get snapshot push status between dates.", method: "GET", path: "/snapshots/snapshot-status/:snapshotId",
+    params: { snapshotId: { type: "string", description: "Snapshot ID", required: true, in: "path" }, from: { type: "string", description: "From date", required: false, in: "query" }, to: { type: "string", description: "To date", required: false, in: "query" } } },
+
+  { name: "crm_get_snapshot_last_push", description: "Get last snapshot push status for a specific location.", method: "GET", path: "/snapshots/snapshot-status/:snapshotId/location/:locationId",
+    params: { snapshotId: { type: "string", description: "Snapshot ID", required: true, in: "path" }, locationId: { type: "string", description: "Location ID", required: true, in: "path" } } },
+]

package/crm/index.js

@@ -26,6 +26,11 @@ import locations from "./locations.js";
 import social from "./social.js";
 import users from "./users.js";
 import objects from "./objects.js";
+import knowledgeBase from "./knowledge-base.js";
+import voiceAi from "./voice-ai.js";
+import saas from "./saas.js";
+import funnels from "./funnels.js"; // includes forms, surveys, associations, snapshots
+import agentStudio from "./agent-studio.js";
 
 // Re-export definitions + helpers for external consumers (e.g. CRM bridges)
 export {
@@ -40,6 +45,11 @@ export {
   social,
   users,
   objects,
+  knowledgeBase,
+  voiceAi,
+  saas,
+  funnels,
+  agentStudio,
   crmHeaders,
   CRM_API_BASE,
   API_VERSION,
@@ -69,6 +79,11 @@ export function registerCrmTools(server, z, proxy) {
     { name: "Social & Blogs", defs: social },
     { name: "Users & Forms", defs: users },
     { name: "Objects & Misc", defs: objects },
+    { name: "Knowledge Base", defs: knowledgeBase },
+    { name: "Voice AI", defs: voiceAi },
+    { name: "SaaS & Billing", defs: saas },
+    { name: "Funnels, Forms, Surveys & More", defs: funnels },
+    { name: "Agent Studio", defs: agentStudio },
   ];
 
   let totalTools = 5; // auth tools count

package/crm/knowledge-base.js

@@ -0,0 +1,69 @@
+// ============================================================
+// 0nMCP — CRM Knowledge Base API Tool Definitions
+// ============================================================
+// Personal AI knowledge bases per location. Each user gets up to
+// 15 knowledge bases trained on their business data. Powers
+// Voice AI, chat bots, and Agent Studio agents.
+// ============================================================
+
+export default [
+  // ── Knowledge Base CRUD ────────────────────────────────────
+
+  {
+    name: "crm_list_knowledge_bases",
+    description: "List all knowledge bases for a location (paginated). Each location can have up to 15 knowledge bases.",
+    method: "GET",
+    path: "/knowledge-bases/",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "query" },
+      limit: { type: "number", description: "Number of results per page", required: false, in: "query" },
+      offset: { type: "number", description: "Pagination offset", required: false, in: "query" },
+    },
+  },
+
+  {
+    name: "crm_create_knowledge_base",
+    description: "Create a new knowledge base for a location. Max 15 per location. This becomes the user's personal AI trained on their business data.",
+    method: "POST",
+    path: "/knowledge-bases/",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      name: { type: "string", description: "Name of the knowledge base (e.g., 'Company FAQ', 'Product Catalog', 'Sales Playbook')", required: true, in: "body" },
+      description: { type: "string", description: "Description of what this knowledge base contains", required: false, in: "body" },
+    },
+    body: ["locationId", "name", "description"],
+  },
+
+  {
+    name: "crm_get_knowledge_base",
+    description: "Get a specific knowledge base by ID including its configuration and source count.",
+    method: "GET",
+    path: "/knowledge-bases/:knowledgeBaseId",
+    params: {
+      knowledgeBaseId: { type: "string", description: "Knowledge base ID", required: true, in: "path" },
+    },
+  },
+
+  {
+    name: "crm_update_knowledge_base",
+    description: "Update a knowledge base's name or description.",
+    method: "PUT",
+    path: "/knowledge-bases/:knowledgeBaseId",
+    params: {
+      knowledgeBaseId: { type: "string", description: "Knowledge base ID", required: true, in: "path" },
+      name: { type: "string", description: "Updated name", required: false, in: "body" },
+      description: { type: "string", description: "Updated description", required: false, in: "body" },
+    },
+    body: ["name", "description"],
+  },
+
+  {
+    name: "crm_delete_knowledge_base",
+    description: "Delete a knowledge base and all its sources/content.",
+    method: "DELETE",
+    path: "/knowledge-bases/:knowledgeBaseId",
+    params: {
+      knowledgeBaseId: { type: "string", description: "Knowledge base ID", required: true, in: "path" },
+    },
+  },
+]

package/crm/objects.js

@@ -155,36 +155,8 @@ export default [
 
   // ── Associations ────────────────────────────────────────────
 
-  {
-    name: "crm_list_associations",
-    description: "List all association definitions for a custom object schema in a CRM location.",
-    method: "GET",
-    path: "/associations/",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "query" },
-      schemaKey: { type: "string", description: "Custom object schema key to list associations for", required: true, in: "query" },
-    },
-    query: ["locationId", "schemaKey"],
-    body: [],
-  },
-
-  {
-    name: "crm_create_association",
-    description: "Create a new association definition between two custom object schemas.",
-    method: "POST",
-    path: "/associations/",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "body" },
-      name: { type: "string", description: "Display name for the association", required: true, in: "body" },
-      key: { type: "string", description: "Unique key for the association (lowercase, no spaces)", required: true, in: "body" },
-      fromSchemaKey: { type: "string", description: "Schema key of the source object", required: true, in: "body" },
-      toSchemaKey: { type: "string", description: "Schema key of the target object", required: true, in: "body" },
-      fromDisplayField: { type: "string", description: "Field key shown when viewing from the source side", required: false, in: "body" },
-      toDisplayField: { type: "string", description: "Field key shown when viewing from the target side", required: false, in: "body" },
-    },
-    query: [],
-    body: ["locationId", "name", "key", "fromSchemaKey", "toSchemaKey", "fromDisplayField", "toDisplayField"],
-  },
+  // crm_list_associations — defined in funnels.js
+  // crm_create_association — defined in funnels.js
 
   // ── Email Builder ───────────────────────────────────────────
 
@@ -310,45 +282,9 @@ export default [
 
   // ── Snapshots ───────────────────────────────────────────────
 
-  {
-    name: "crm_list_snapshots",
-    description: "List all snapshots available for a CRM company.",
-    method: "GET",
-    path: "/snapshots/",
-    params: {
-      companyId: { type: "string", description: "Company / agency ID", required: true, in: "query" },
-    },
-    query: ["companyId"],
-    body: [],
-  },
-
-  {
-    name: "crm_create_snapshot_share_link",
-    description: "Create a shareable link for a snapshot so it can be pushed to other locations.",
-    method: "POST",
-    path: "/snapshots/share/link",
-    params: {
-      companyId: { type: "string", description: "Company / agency ID", required: true, in: "body" },
-      snapshotId: { type: "string", description: "Snapshot ID to share", required: true, in: "body" },
-      shareType: { type: "string", description: "Type of share (e.g. link, permanent)", required: true, in: "body" },
-      relationshipNumber: { type: "string", description: "Relationship number for the share link", required: false, in: "body" },
-    },
-    query: [],
-    body: ["companyId", "snapshotId", "shareType", "relationshipNumber"],
-  },
-
-  {
-    name: "crm_get_snapshot_push_status",
-    description: "Get the push status between a snapshot and a specific location.",
-    method: "GET",
-    path: "/snapshots/snapshot-status/:snapshotId/:locationId",
-    params: {
-      snapshotId: { type: "string", description: "Snapshot ID to check", required: true, in: "path" },
-      locationId: { type: "string", description: "Location / sub-account ID to check status against", required: true, in: "path" },
-    },
-    query: [],
-    body: [],
-  },
+  // crm_list_snapshots — defined in funnels.js
+  // crm_create_snapshot_share_link — defined in funnels.js
+  // crm_get_snapshot_push_status — defined in funnels.js
 
   // ── Trigger Links ───────────────────────────────────────────
 

package/crm/saas.js

@@ -0,0 +1,147 @@
+// ============================================================
+// 0nMCP — CRM SaaS API Tool Definitions
+// ============================================================
+// Manage SaaS subscriptions, plans, rebilling, and sub-account
+// provisioning. This is how 0nMCP sells products on the
+// CRM marketplace — enable SaaS per location, manage plans,
+// handle billing through Stripe integration.
+// ============================================================
+
+export default [
+  // ── Plans ──────────────────────────────────────────────────
+
+  {
+    name: "crm_get_saas_agency_plans",
+    description: "Get all SaaS plans for an agency/company. These are the subscription tiers offered to sub-accounts.",
+    method: "GET",
+    path: "/saas-api/public-api/agency-plans/:companyId",
+    params: {
+      companyId: { type: "string", description: "Agency/company ID", required: true, in: "path" },
+    },
+  },
+
+  {
+    name: "crm_get_saas_plan",
+    description: "Get details of a specific SaaS plan by ID.",
+    method: "GET",
+    path: "/saas-api/public-api/saas-plan/:planId",
+    params: {
+      planId: { type: "string", description: "SaaS plan ID", required: true, in: "path" },
+    },
+  },
+
+  // ── Enable/Disable SaaS ────────────────────────────────────
+
+  {
+    name: "crm_enable_saas_location",
+    description: "Enable SaaS for a sub-account/location. This activates billing and plan management for that location.",
+    method: "POST",
+    path: "/saas-api/public-api/enable-saas/:locationId",
+    params: {
+      locationId: { type: "string", description: "Location/sub-account ID to enable SaaS for", required: true, in: "path" },
+      planId: { type: "string", description: "SaaS plan ID to assign", required: true, in: "body" },
+      stripeCustomerId: { type: "string", description: "Stripe customer ID for billing", required: false, in: "body" },
+    },
+    body: ["planId", "stripeCustomerId"],
+  },
+
+  {
+    name: "crm_bulk_enable_saas",
+    description: "Enable SaaS for multiple locations at once.",
+    method: "POST",
+    path: "/saas-api/public-api/bulk-enable-saas/:companyId",
+    params: {
+      companyId: { type: "string", description: "Agency/company ID", required: true, in: "path" },
+      locationIds: { type: "array", description: "Array of location IDs to enable", required: true, in: "body" },
+      planId: { type: "string", description: "SaaS plan ID to assign to all", required: true, in: "body" },
+    },
+    body: ["locationIds", "planId"],
+  },
+
+  {
+    name: "crm_bulk_disable_saas",
+    description: "Disable SaaS for multiple locations.",
+    method: "POST",
+    path: "/saas-api/public-api/bulk-disable-saas/:companyId",
+    params: {
+      companyId: { type: "string", description: "Agency/company ID", required: true, in: "path" },
+      locationIds: { type: "array", description: "Array of location IDs to disable", required: true, in: "body" },
+    },
+    body: ["locationIds"],
+  },
+
+  // ── Subscriptions ──────────────────────────────────────────
+
+  {
+    name: "crm_get_saas_subscription",
+    description: "Get SaaS subscription details for a location including plan, status, and billing info.",
+    method: "GET",
+    path: "/saas-api/public-api/get-saas-subscription/:locationId",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "path" },
+    },
+  },
+
+  {
+    name: "crm_update_saas_subscription",
+    description: "Update a location's SaaS subscription — change plan, update billing, modify features.",
+    method: "PUT",
+    path: "/saas-api/public-api/update-saas-subscription/:locationId",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "path" },
+      planId: { type: "string", description: "New plan ID", required: false, in: "body" },
+      status: { type: "string", description: "Subscription status", required: false, in: "body" },
+    },
+    body: ["planId", "status"],
+  },
+
+  // ── Location Management ────────────────────────────────────
+
+  {
+    name: "crm_list_saas_locations",
+    description: "List all SaaS-enabled locations for a company with their subscription status.",
+    method: "GET",
+    path: "/saas-api/public-api/saas-locations/:companyId",
+    params: {
+      companyId: { type: "string", description: "Agency/company ID", required: true, in: "path" },
+    },
+  },
+
+  {
+    name: "crm_get_saas_locations_by_stripe",
+    description: "Get locations by Stripe customer ID with company ID.",
+    method: "GET",
+    path: "/saas-api/public-api/locations",
+    params: {
+      companyId: { type: "string", description: "Agency/company ID", required: true, in: "query" },
+      stripeCustomerId: { type: "string", description: "Stripe customer ID", required: false, in: "query" },
+    },
+  },
+
+  {
+    name: "crm_pause_saas_location",
+    description: "Pause a SaaS location — temporarily suspend billing and access.",
+    method: "POST",
+    path: "/saas-api/public-api/pause/:locationId",
+    params: {
+      locationId: { type: "string", description: "Location ID to pause", required: true, in: "path" },
+      paused: { type: "boolean", description: "Whether to pause (true) or unpause (false)", required: true, in: "body" },
+    },
+    body: ["paused"],
+  },
+
+  // ── Rebilling ──────────────────────────────────────────────
+
+  {
+    name: "crm_update_saas_rebilling",
+    description: "Update rebilling configuration for an agency — controls how sub-accounts are charged.",
+    method: "POST",
+    path: "/saas-api/public-api/update-rebilling/:companyId",
+    params: {
+      companyId: { type: "string", description: "Agency/company ID", required: true, in: "path" },
+      enabled: { type: "boolean", description: "Enable/disable rebilling", required: false, in: "body" },
+      markup: { type: "number", description: "Markup percentage on costs", required: false, in: "body" },
+    },
+    body: ["enabled", "markup"],
+  },
+]