0nmcp 3.2.1 → 4.0.0

package/README.md

@@ -2,19 +2,20 @@
 
 # 0nMCP
 
-### 1,554 Tools. 96 Services. One MCP Server.
+### 14,500+ Tools. 867 Services. 96 Categories. One MCP Server.
 
-**The most comprehensive MCP server available.**<br>
-Connect any AI to any API. Natural language. Zero configuration. $0.01/run.<br>
-5 patents filed. LinkedIn certifications. Daily patent monitoring via 0nDefender.
+**The most comprehensive MCP server ever built.**<br>
+Connect any AI to any API. Natural language. Zero configuration.<br>
+Now with: 0nAI Engine, Agent Bridge, HIPAA Scanner, Blog-to-Social Workflows, Security Trust Engine, Voice AI, Snapshot Deployment.<br>
+5 patents filed. CRM Marketplace App. 0nCore.com AI Business Operating System.
 
 [![npm version](https://img.shields.io/npm/v/0nmcp.svg?style=flat-square)](https://www.npmjs.com/package/0nmcp)
 [![npm downloads](https://img.shields.io/npm/dm/0nmcp.svg?style=flat-square)](https://www.npmjs.com/package/0nmcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square)](https://nodejs.org)
 [![MCP](https://img.shields.io/badge/MCP-Compatible-blueviolet?style=flat-square)](https://modelcontextprotocol.io)
-[![Tools](https://img.shields.io/badge/tools-1554-orange?style=flat-square)](#tool-count-breakdown)
-[![Services](https://img.shields.io/badge/services-96-blue?style=flat-square)](#all-96-services)
+[![Tools](https://img.shields.io/badge/tools-14500%2B-orange?style=flat-square)](#tool-count-breakdown)
+[![Services](https://img.shields.io/badge/services-867-blue?style=flat-square)](#all-96-services)
 [![Patents](https://img.shields.io/badge/patents-5%20filed-blueviolet?style=flat-square)](#patents)
 
 [Website](https://0nmcp.com) &middot; [Quick Start](#quick-start) &middot; [All 96 Services](#all-96-services) &middot; [MCP Config](#mcp-configuration) &middot; [Certifications](https://0nmcp.com/learn) &middot; [Community](https://0nmcp.com/community)
@@ -57,6 +58,59 @@ That's it. Your AI can now use 1,554 tools across 96 services.
 
 ---
 
+## MCP Configuration
+
+**No API key required.** Just paste this config into your AI platform:
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "0nMCP": {
+      "command": "npx",
+      "args": ["-y", "0nmcp"]
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+
+Add to `.cursor/mcp.json` or `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "0nMCP": {
+      "command": "npx",
+      "args": ["-y", "0nmcp"]
+    }
+  }
+}
+```
+
+### VS Code (Copilot MCP)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "0nMCP": {
+      "command": "npx",
+      "args": ["-y", "0nmcp"]
+    }
+  }
+}
+```
+
+> **Note:** No `ANTHROPIC_API_KEY` or any other API key is needed in the config. 0nMCP provides the tools — your AI platform (Claude, Cursor, etc.) provides the intelligence. API keys for individual services (Stripe, Slack, etc.) can be added later via `0nmcp engine import`.
+
+---
+
 ## Tool Count Breakdown
 
 | Module | Tools | Description |

package/crm/addons.js

@@ -0,0 +1,319 @@
+// ============================================================
+// 0nMCP — Add-on Product Definitions
+// ============================================================
+// Each add-on maps to specific SDK modules + CRM capabilities.
+// User buys key → capabilities unlock → 0nMCP can execute.
+// ============================================================
+
+export const ADDONS = [
+  {
+    slug: "ai-course-builder",
+    name: "AI Course Builder",
+    description: "Generate full courses with AI — lessons, categories, materials. Auto-imported into CRM.",
+    priceCents: 4900,
+    sdkModules: ["courses"],
+    scopes: ["courses.readonly", "courses.write"],
+    capabilities: ["course_create", "course_import", "course_list", "lesson_generate"],
+  },
+  {
+    slug: "voice-ai-agent",
+    name: "Voice AI Agent",
+    description: "Deploy AI phone agents with knowledge bases, actions, and call routing.",
+    priceCents: 9900,
+    sdkModules: ["voiceAi"],
+    scopes: ["voice-ai-agents.readonly", "voice-ai-agents.write", "voice-ai-agent-goals.readonly", "voice-ai-agent-goals.write"],
+    capabilities: ["voice_agent_create", "voice_agent_configure", "voice_action_create", "voice_call_logs"],
+  },
+  {
+    slug: "conversation-ai",
+    name: "Conversation AI",
+    description: "Configure AI chatbots for messaging channels with custom personas and knowledge.",
+    priceCents: 4900,
+    sdkModules: ["conversations"],
+    scopes: ["conversation-ai.readonly", "conversation-ai.write", "conversations.readonly", "conversations.write"],
+    capabilities: ["convo_ai_configure", "convo_ai_manage", "convo_message_send"],
+  },
+  {
+    slug: "social-planner",
+    name: "Social Media Planner",
+    description: "Schedule and publish to all social channels. AI-generated content with approval flow.",
+    priceCents: 2900,
+    sdkModules: ["socialMediaPosting"],
+    scopes: ["socialplanner/post.readonly", "socialplanner/post.write", "socialplanner/account.readonly"],
+    capabilities: ["social_post_create", "social_post_schedule", "social_account_list"],
+  },
+  {
+    slug: "blog-engine",
+    name: "Blog Engine",
+    description: "AI-generated blog posts published directly to CRM blog. SEO-optimized with categories.",
+    priceCents: 1900,
+    sdkModules: ["blogs"],
+    scopes: ["blogs/post.write", "blogs/post-update.write", "blogs/posts.readonly", "blogs/category.readonly"],
+    capabilities: ["blog_post_create", "blog_post_update", "blog_list"],
+  },
+  {
+    slug: "snapshot-manager",
+    name: "Snapshot Manager",
+    description: "Generate, deploy, and clone CRM snapshots between locations. Full configuration backup.",
+    priceCents: 9900,
+    sdkModules: ["snapshots"],
+    scopes: ["snapshots.readonly", "snapshots.write"],
+    capabilities: ["snapshot_create", "snapshot_deploy", "snapshot_list"],
+  },
+  {
+    slug: "affiliate-manager",
+    name: "Affiliate Manager",
+    description: "Create and manage affiliate programs with tracking, campaigns, and commission management.",
+    priceCents: 4900,
+    sdkModules: ["affiliates"],
+    scopes: [],
+    capabilities: ["affiliate_create", "affiliate_campaign", "affiliate_commission"],
+  },
+  {
+    slug: "invoice-automation",
+    name: "Invoice Automation",
+    description: "AI-generated invoices, estimates, and recurring billing. Auto-send on triggers.",
+    priceCents: 2900,
+    sdkModules: ["invoices"],
+    scopes: ["invoices.readonly", "invoices.write", "invoices/schedule.readonly", "invoices/schedule.write"],
+    capabilities: ["invoice_create", "invoice_send", "invoice_schedule", "estimate_create"],
+  },
+  {
+    slug: "email-builder",
+    name: "Email Builder",
+    description: "AI-generated email campaigns and templates. Schedule and send from CRM.",
+    priceCents: 1900,
+    sdkModules: ["emails"],
+    scopes: ["emails/builder.write", "emails/builder.readonly", "emails/schedule.readonly", "emails/schedule.write"],
+    capabilities: ["email_template_create", "email_schedule", "email_send"],
+  },
+  {
+    slug: "knowledge-base",
+    name: "Knowledge Base Manager",
+    description: "Create and manage AI knowledge bases. Feed data to agents, bots, and voice AI.",
+    priceCents: 2900,
+    sdkModules: ["knowledgeBases"],
+    scopes: ["knowledge-bases.write", "knowledge-bases.readonly"],
+    capabilities: ["kb_create", "kb_update", "kb_source_add", "kb_list"],
+  },
+  {
+    slug: "workflow-reader",
+    name: "Workflow Intelligence",
+    description: "Read and analyze workflow definitions. Generate .0n SWITCH files from existing automations.",
+    priceCents: 1900,
+    sdkModules: ["workflows"],
+    scopes: ["workflows.readonly"],
+    capabilities: ["workflow_list", "workflow_read", "workflow_export_0n"],
+  },
+  {
+    slug: "agent-studio",
+    name: "Agent Studio Pro",
+    description: "Build, deploy, and manage AI agents with MCP tool access and knowledge base connections.",
+    priceCents: 9900,
+    sdkModules: ["agentStudio"],
+    scopes: ["agent-studio.readonly", "agent-studio.write"],
+    capabilities: ["agent_create", "agent_execute", "agent_promote", "agent_configure_kb", "agent_configure_mcp"],
+  },
+  {
+    slug: "phone-system",
+    name: "Phone System",
+    description: "Purchase phone numbers, manage active lines, configure forwarding, call recording, and number pools.",
+    priceCents: 4900,
+    sdkModules: ["phoneSystem"],
+    scopes: ["phonenumbers.read", "phonenumbers.write", "numberpools.read"],
+    capabilities: ["phone_purchase", "phone_search", "phone_list", "phone_release", "phone_update", "phone_pools"],
+  },
+  {
+    slug: "calendar-booking",
+    name: "Calendar & Booking",
+    description: "Create calendars, manage events, booking links, appointment types, and resource scheduling.",
+    priceCents: 2900,
+    sdkModules: ["calendars"],
+    scopes: ["calendars.readonly", "calendars.write", "calendars/events.readonly", "calendars/events.write", "calendars/groups.readonly", "calendars/groups.write", "calendars/resources.readonly", "calendars/resources.write"],
+    capabilities: ["calendar_create", "calendar_events", "booking_link", "resource_schedule", "appointment_types"],
+  },
+  {
+    slug: "contact-manager",
+    name: "Contact Manager",
+    description: "Full contact CRUD, tagging, notes, tasks, bulk operations, and workflow enrollment.",
+    priceCents: 1900,
+    sdkModules: ["contacts"],
+    scopes: ["contacts.readonly", "contacts.write"],
+    capabilities: ["contact_create", "contact_update", "contact_search", "contact_tag", "contact_note", "contact_task", "contact_bulk"],
+  },
+  {
+    slug: "opportunity-pipeline",
+    name: "Opportunity Pipeline",
+    description: "Manage sales pipelines, stages, deals, and opportunity tracking with custom fields.",
+    priceCents: 2900,
+    sdkModules: ["opportunities"],
+    scopes: ["opportunities.readonly", "opportunities.write"],
+    capabilities: ["pipeline_create", "pipeline_stages", "opportunity_create", "opportunity_update", "opportunity_search"],
+  },
+  {
+    slug: "payment-processing",
+    name: "Payment Processing",
+    description: "Process payments, manage orders, subscriptions, coupons, and transaction history.",
+    priceCents: 4900,
+    sdkModules: ["payments"],
+    scopes: ["payments/orders.readonly", "payments/orders.write", "payments/orders.collectPayment", "payments/transactions.readonly", "payments/subscriptions.readonly", "payments/coupons.readonly", "payments/coupons.write"],
+    capabilities: ["payment_collect", "order_create", "subscription_manage", "coupon_create", "transaction_list"],
+  },
+  {
+    slug: "product-catalog",
+    name: "Product Catalog",
+    description: "Manage products, pricing, collections, and inventory for your store.",
+    priceCents: 1900,
+    sdkModules: ["products"],
+    scopes: ["products.readonly", "products.write", "products/prices.readonly", "products/prices.write", "products/collection.readonly", "products/collection.write"],
+    capabilities: ["product_create", "product_price", "collection_manage", "inventory_update"],
+  },
+  {
+    slug: "form-builder",
+    name: "Form Builder",
+    description: "Create and manage forms, surveys, and data collection with submission tracking.",
+    priceCents: 1900,
+    sdkModules: ["forms", "surveys"],
+    scopes: ["forms.readonly", "forms.write", "surveys.readonly"],
+    capabilities: ["form_create", "form_submissions", "survey_list", "survey_results"],
+  },
+  {
+    slug: "funnel-builder",
+    name: "Funnel & Website Builder",
+    description: "Manage funnels, pages, redirects, and website content programmatically.",
+    priceCents: 2900,
+    sdkModules: ["funnels"],
+    scopes: ["funnels/funnel.readonly", "funnels/page.readonly", "funnels/redirect.readonly", "funnels/redirect.write"],
+    capabilities: ["funnel_list", "funnel_pages", "redirect_manage", "page_content"],
+  },
+  {
+    slug: "media-manager",
+    name: "Media Manager",
+    description: "Upload, organize, and manage files and media assets in the CRM.",
+    priceCents: 900,
+    sdkModules: ["medias"],
+    scopes: ["medias.readonly", "medias.write"],
+    capabilities: ["media_upload", "media_list", "media_delete", "media_organize"],
+  },
+  {
+    slug: "custom-objects",
+    name: "Custom Objects",
+    description: "Create custom object schemas, records, and associations for any data model.",
+    priceCents: 4900,
+    sdkModules: ["objects", "associations"],
+    scopes: ["objects/schema.readonly", "objects/schema.write", "objects/record.readonly", "objects/record.write", "associations.readonly", "associations.write"],
+    capabilities: ["object_schema_create", "object_record_crud", "association_create", "association_query"],
+  },
+  {
+    slug: "campaign-manager",
+    name: "Campaign Manager",
+    description: "View and manage email and SMS campaigns with audience targeting.",
+    priceCents: 2900,
+    sdkModules: ["campaigns"],
+    scopes: ["campaigns.readonly"],
+    capabilities: ["campaign_list", "campaign_stats", "campaign_audience"],
+  },
+  {
+    slug: "document-contracts",
+    name: "Documents & Contracts",
+    description: "Send contracts, proposals, and documents for e-signature.",
+    priceCents: 2900,
+    sdkModules: ["proposals"],
+    scopes: ["documents_contracts/list.readonly", "documents_contracts/sendLink.write", "documents_contracts_template/sendLink.write", "documents_contracts_template/list.readonly"],
+    capabilities: ["contract_send", "contract_list", "template_send", "proposal_create"],
+  },
+  {
+    slug: "ecommerce-store",
+    name: "E-Commerce Store",
+    description: "Manage online store settings, shipping, and order fulfillment.",
+    priceCents: 4900,
+    sdkModules: ["store"],
+    scopes: ["store/shipping.readonly", "store/shipping.write", "store/setting.readonly", "store/setting.write"],
+    capabilities: ["store_settings", "shipping_config", "order_fulfill", "store_manage"],
+  },
+  {
+    slug: "link-triggers",
+    name: "Link Triggers",
+    description: "Create and manage trigger links for workflow automation.",
+    priceCents: 900,
+    sdkModules: ["links"],
+    scopes: ["links.readonly", "links.write"],
+    capabilities: ["link_create", "link_list", "link_trigger"],
+  },
+  {
+    slug: "user-management",
+    name: "User Management",
+    description: "Manage team members, roles, permissions, and user accounts.",
+    priceCents: 1900,
+    sdkModules: ["users"],
+    scopes: ["users.readonly", "users.write"],
+    capabilities: ["user_list", "user_create", "user_update", "user_permissions"],
+  },
+  {
+    slug: "wordpress-manager",
+    name: "WordPress Manager",
+    description: "Manage WordPress sites connected to your CRM location.",
+    priceCents: 1900,
+    sdkModules: ["wordpress"],
+    scopes: ["wordpress.site.readonly"],
+    capabilities: ["wp_site_list", "wp_site_status"],
+  },
+  {
+    slug: "saas-manager",
+    name: "SaaS & White-Label",
+    description: "Manage SaaS locations, company settings, and white-label configuration.",
+    priceCents: 9900,
+    sdkModules: ["saasApi", "companies"],
+    scopes: ["saas/company.read", "saas/company.write", "saas/location.read", "saas/location.write", "companies.readonly"],
+    capabilities: ["saas_location_manage", "company_settings", "whitelabel_config", "location_provision"],
+  },
+  {
+    slug: "location-settings",
+    name: "Location Settings",
+    description: "Manage location configuration, custom fields, custom values, tags, and templates.",
+    priceCents: 1900,
+    sdkModules: ["locations", "customFields", "customMenus"],
+    scopes: ["locations.readonly", "locations.write", "locations/customFields.readonly", "locations/customFields.write", "locations/customValues.readonly", "locations/customValues.write", "locations/tags.readonly", "locations/tags.write", "locations/templates.readonly"],
+    capabilities: ["location_settings", "custom_field_crud", "custom_value_crud", "tag_manage", "template_list"],
+  },
+  {
+    slug: "brand-board",
+    name: "Brand Board",
+    description: "Manage brand design kits — colors, fonts, logos, and brand assets.",
+    priceCents: 900,
+    sdkModules: ["brandBoards"],
+    scopes: ["brand-boards/design-kit.readonly", "brand-boards/design-kit.write"],
+    capabilities: ["brand_kit_read", "brand_kit_update"],
+  },
+];
+
+/**
+ * Get an add-on by slug.
+ */
+export function getAddon(slug) {
+  return ADDONS.find((a) => a.slug === slug) || null;
+}
+
+/**
+ * Check if a user has a specific capability unlocked.
+ * @param {Array} userKeys - Array of product_keys rows for this user
+ * @param {string} capability - e.g. "course_create"
+ */
+export function hasCapability(userKeys, capability) {
+  return userKeys.some(
+    (k) => k.status === "active" && k.capabilities?.includes(capability)
+  );
+}
+
+/**
+ * Get all capabilities for a user based on their purchased keys.
+ */
+export function getUserCapabilities(userKeys) {
+  const caps = new Set();
+  for (const k of userKeys) {
+    if (k.status === "active" && k.capabilities) {
+      for (const c of k.capabilities) caps.add(c);
+    }
+  }
+  return [...caps];
+}

package/crm/agent-builder.js

@@ -0,0 +1,223 @@
+// ============================================================
+// 0nMCP — AI Agent Builder (SDK-powered)
+// ============================================================
+// Dynamically generate CRM Agent Studio agents from descriptions.
+// Agents = "AI Workflows" — K-layer powered, MCP-connected,
+// knowledge-base trained. The core product of the 0n platform.
+//
+// Architecture:
+//   User describes what they want
+//   → AI generates agent config (nodes, edges, KB, MCP)
+//   → SDK creates agent in CRM
+//   → Agent promoted to production
+//   → Available as an "AI Workflow" in the dashboard
+//   → K-layers feed learning data back into KB
+// ============================================================
+
+import getSDK from "./sdk.js";
+import { crmHeaders, CRM_API_BASE } from "./helpers.js";
+
+/**
+ * Register AI agent builder MCP tools.
+ */
+export function registerAgentBuilderTools(server, z) {
+
+  server.tool(
+    "crm_build_ai_workflow",
+    "Build and deploy a complete AI Workflow (Agent Studio agent) from a natural language description. Creates the agent, configures knowledge base connections, adds MCP server nodes for tool access, and promotes to production.",
+    {
+      location_id: z.string().describe("CRM location ID"),
+      name: z.string().describe("AI Workflow name"),
+      description: z.string().describe("What this AI Workflow does — the AI generates the full agent config from this"),
+      knowledge_base_ids: z.array(z.string()).optional().describe("Knowledge base IDs to connect"),
+      mcp_enabled: z.boolean().optional().describe("Enable MCP server access (default true — gives agent access to 0nMCP tools)"),
+      personality: z.string().optional().describe("Agent personality/system prompt override"),
+      auto_promote: z.boolean().optional().describe("Auto-promote to production (default true)"),
+      access_token: z.string().optional().describe("CRM access token (auto-resolved)"),
+    },
+    async ({ location_id, name, description, knowledge_base_ids, mcp_enabled, personality, auto_promote, access_token }) => {
+      try {
+        const token = access_token;
+        if (!token) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: "access_token required" }) }] };
+        }
+
+        const headers = crmHeaders(token);
+
+        // Step 1: Create the agent
+        const createRes = await fetch(`${CRM_API_BASE}/agent-studio/agent`, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({ locationId: location_id, name, description }),
+        });
+        const createData = await createRes.json();
+
+        if (!createRes.ok) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: "Agent creation failed", details: createData }) }] };
+        }
+
+        const agentId = createData.agent?.id || createData.id;
+        const versionId = createData.agent?.versions?.[0]?.id || createData.versionId;
+
+        if (!agentId) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: "No agent ID returned", data: createData }) }] };
+        }
+
+        // Step 2: Configure the agent version with nodes
+        const nodes = [];
+        const edges = [];
+
+        // Add knowledge base nodes
+        if (knowledge_base_ids && knowledge_base_ids.length > 0) {
+          for (let i = 0; i < knowledge_base_ids.length; i++) {
+            nodes.push({
+              id: `kb_${i}`,
+              type: "knowledge_base",
+              data: { knowledgeBaseId: knowledge_base_ids[i] },
+              position: { x: 200, y: 100 + i * 120 },
+            });
+          }
+        }
+
+        // Add MCP server node if enabled
+        if (mcp_enabled !== false) {
+          nodes.push({
+            id: "mcp_0nmcp",
+            type: "mcp_server",
+            data: {
+              url: "https://services.leadconnectorhq.com/mcp/",
+              name: "0nMCP",
+              description: "Universal AI orchestrator — 332+ CRM tools, 96 services",
+            },
+            position: { x: 400, y: 200 },
+          });
+        }
+
+        // Update agent with nodes if we have any
+        if (versionId && nodes.length > 0) {
+          await fetch(`${CRM_API_BASE}/agent-studio/agent/${agentId}`, {
+            method: "PUT",
+            headers,
+            body: JSON.stringify({
+              locationId: location_id,
+              versionId,
+              nodes,
+              edges,
+              variables: {
+                system_prompt: personality || `You are ${name}. ${description}. Be helpful, professional, and thorough.`,
+              },
+            }),
+          });
+        }
+
+        // Step 3: Promote to production
+        if (auto_promote !== false && versionId) {
+          await fetch(`${CRM_API_BASE}/agent-studio/agent/${agentId}/promote`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ locationId: location_id, versionId }),
+          });
+        }
+
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              status: "deployed",
+              agent_id: agentId,
+              version_id: versionId,
+              name,
+              description,
+              knowledge_bases: knowledge_base_ids?.length || 0,
+              mcp_enabled: mcp_enabled !== false,
+              promoted: auto_promote !== false,
+              execute_command: `crm_execute_agent with agentId=${agentId}, locationId=${location_id}`,
+            }, null, 2),
+          }],
+        };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: err.message }) }] };
+      }
+    }
+  );
+
+  server.tool(
+    "crm_list_ai_workflows",
+    "List all AI Workflows (Agent Studio agents) for a location with their status, version, and execution stats.",
+    {
+      location_id: z.string().describe("CRM location ID"),
+      access_token: z.string().optional().describe("CRM access token"),
+    },
+    async ({ location_id, access_token }) => {
+      try {
+        const token = access_token;
+        if (!token) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: "access_token required" }) }] };
+        }
+        const headers = crmHeaders(token);
+        const res = await fetch(`${CRM_API_BASE}/agent-studio/agent?locationId=${location_id}`, { headers });
+        const data = await res.json();
+
+        const workflows = (data.agents || data || []).map((a) => ({
+          id: a.id,
+          name: a.name,
+          description: a.description,
+          status: a.status,
+          versions: a.versions?.length || 0,
+          createdAt: a.createdAt,
+          updatedAt: a.updatedAt,
+        }));
+
+        return { content: [{ type: "text", text: JSON.stringify({ workflows, total: workflows.length }, null, 2) }] };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: err.message }) }] };
+      }
+    }
+  );
+
+  server.tool(
+    "crm_run_ai_workflow",
+    "Execute an AI Workflow (Agent Studio agent). Send a message and get a response. Maintains conversation context via executionId.",
+    {
+      agent_id: z.string().describe("Agent/workflow ID"),
+      location_id: z.string().describe("CRM location ID"),
+      message: z.string().describe("Message to send to the AI Workflow"),
+      execution_id: z.string().optional().describe("Previous execution ID to continue conversation"),
+      contact_id: z.string().optional().describe("Contact ID for context"),
+      access_token: z.string().optional().describe("CRM access token"),
+    },
+    async ({ agent_id, location_id, message, execution_id, contact_id, access_token }) => {
+      try {
+        const token = access_token;
+        if (!token) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: "access_token required" }) }] };
+        }
+        const headers = crmHeaders(token);
+        const res = await fetch(`${CRM_API_BASE}/agent-studio/agent/${agent_id}/execute`, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({
+            locationId: location_id,
+            message,
+            executionId: execution_id || undefined,
+            contactId: contact_id || undefined,
+          }),
+        });
+        const data = await res.json();
+
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              response: data.response || data.message || data.content,
+              execution_id: data.executionId || data.execution_id,
+              agent_id,
+            }, null, 2),
+          }],
+        };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: err.message }) }] };
+      }
+    }
+  );
+}