@formmy.app/mcp-server 0.3.0 → 0.4.0

package/dist/sdk-client.d.ts

@@ -33,5 +33,22 @@ export declare function listConversationEstados(agentId: string): Promise<unknow
 export declare function setConversationStatus(conversationId: string, label: string, color: string): Promise<unknown>;
 export declare function addConversationTag(conversationId: string, label: string, color: string, comment?: string): Promise<unknown>;
 export declare function removeConversationTag(conversationId: string, tagLabel: string): Promise<unknown>;
+export declare function createOrder(conversationId: string, data: {
+    folio?: string;
+    cliente?: string;
+    tel?: string;
+    total?: number;
+    estatus?: string;
+    status?: "ABIERTA" | "CERRADA";
+    notas?: string;
+    cotizacionUrl?: string;
+    direccionEntrega?: {
+        label?: string;
+        direccion?: string;
+        cp?: string;
+        ciudad?: string;
+        mapsUrl?: string;
+    };
+}): Promise<unknown>;
 export declare function shareAgent(agentId: string, email: string, role?: string): Promise<unknown>;
 export declare function connectIntegration(agentId: string, integration: string, config: Record<string, string>): Promise<unknown>;

package/dist/sdk-client.js

@@ -162,6 +162,9 @@ export async function addConversationTag(conversationId, label, color, comment)
 export async function removeConversationTag(conversationId, tagLabel) {
     return bridgeFetch("remove_tag", { conversationId, tagLabel });
 }
+export async function createOrder(conversationId, data) {
+    return bridgeFetch("create_order", { conversationId, ...data });
+}
 // --- Sharing ---
 export async function shareAgent(agentId, email, role) {
     return sdkFetch("agents.share", {

package/dist/tools/conversations.js

@@ -43,4 +43,40 @@ export function registerConversationTools(server) {
         const result = await sdk.removeConversationTag(conversationId, tagLabel);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
+    server.tool("create_order", "Record an order (cotización/pedido) for a conversation in Formmy, mirroring what is sent to Kommo. It shows in the contact panel's Órdenes accordion, moves the kanban card when `estatus` matches a CRM estado (call list_conversation_estados first), and bumps the conversation to the top. Does NOT replace the Kommo push — call it IN ADDITION. Use when an order/quote is confirmed or its status changes; only the most recent order drives the card and the board value.", {
+        conversationId: z.string().describe("Conversation ID"),
+        folio: z.string().optional().describe("Order folio/number, e.g. '260521-007'"),
+        cliente: z.string().optional().describe("Customer name"),
+        tel: z.string().optional().describe("Contact phone"),
+        total: z
+            .number()
+            .optional()
+            .describe("Order total / budget as a number, e.g. 783"),
+        estatus: z
+            .string()
+            .optional()
+            .describe("Free-form status; match a CRM estado label (list_conversation_estados) so the card moves to that column, e.g. 'Pago a contra entrega'"),
+        status: z
+            .enum(["ABIERTA", "CERRADA"])
+            .optional()
+            .describe("Order lifecycle (default ABIERTA). Use CERRADA when delivered/closed."),
+        notas: z.string().optional().describe("Special instructions / internal notes"),
+        cotizacionUrl: z
+            .string()
+            .optional()
+            .describe("URL to the quote PDF deployed on EasyBits"),
+        direccionEntrega: z
+            .object({
+            label: z.string().optional(),
+            direccion: z.string().optional(),
+            cp: z.string().optional(),
+            ciudad: z.string().optional(),
+            mapsUrl: z.string().optional(),
+        })
+            .optional()
+            .describe("Delivery address snapshot { label, direccion, cp, ciudad, mapsUrl }"),
+    }, async ({ conversationId, ...data }) => {
+        const result = await sdk.createOrder(conversationId, data);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formmy.app/mcp-server",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "MCP server for managing Formmy agents via Claude Code",
   "type": "module",
   "main": "dist/index.js",

package/src/sdk-client.ts

@@ -196,7 +196,7 @@ export async function listConversationEstados(agentId: string) {
 const BRIDGE_SECRET = process.env.NANOCLAW_WEBHOOK_SECRET || "";
 
 async function bridgeFetch(
-  intent: "set_estado" | "add_tag" | "remove_tag",
+  intent: "set_estado" | "add_tag" | "remove_tag" | "create_order",
   body: Record<string, unknown>,
 ): Promise<unknown> {
   if (!BRIDGE_SECRET) {
@@ -244,6 +244,29 @@ export async function removeConversationTag(
   return bridgeFetch("remove_tag", { conversationId, tagLabel });
 }
 
+export async function createOrder(
+  conversationId: string,
+  data: {
+    folio?: string;
+    cliente?: string;
+    tel?: string;
+    total?: number;
+    estatus?: string;
+    status?: "ABIERTA" | "CERRADA";
+    notas?: string;
+    cotizacionUrl?: string;
+    direccionEntrega?: {
+      label?: string;
+      direccion?: string;
+      cp?: string;
+      ciudad?: string;
+      mapsUrl?: string;
+    };
+  },
+) {
+  return bridgeFetch("create_order", { conversationId, ...data });
+}
+
 // --- Sharing ---
 
 export async function shareAgent(

package/src/tools/conversations.ts

@@ -80,4 +80,48 @@ export function registerConversationTools(server: McpServer) {
       return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
   );
+
+  server.tool(
+    "create_order",
+    "Record an order (cotización/pedido) for a conversation in Formmy, mirroring what is sent to Kommo. It shows in the contact panel's Órdenes accordion, moves the kanban card when `estatus` matches a CRM estado (call list_conversation_estados first), and bumps the conversation to the top. Does NOT replace the Kommo push — call it IN ADDITION. Use when an order/quote is confirmed or its status changes; only the most recent order drives the card and the board value.",
+    {
+      conversationId: z.string().describe("Conversation ID"),
+      folio: z.string().optional().describe("Order folio/number, e.g. '260521-007'"),
+      cliente: z.string().optional().describe("Customer name"),
+      tel: z.string().optional().describe("Contact phone"),
+      total: z
+        .number()
+        .optional()
+        .describe("Order total / budget as a number, e.g. 783"),
+      estatus: z
+        .string()
+        .optional()
+        .describe(
+          "Free-form status; match a CRM estado label (list_conversation_estados) so the card moves to that column, e.g. 'Pago a contra entrega'",
+        ),
+      status: z
+        .enum(["ABIERTA", "CERRADA"])
+        .optional()
+        .describe("Order lifecycle (default ABIERTA). Use CERRADA when delivered/closed."),
+      notas: z.string().optional().describe("Special instructions / internal notes"),
+      cotizacionUrl: z
+        .string()
+        .optional()
+        .describe("URL to the quote PDF deployed on EasyBits"),
+      direccionEntrega: z
+        .object({
+          label: z.string().optional(),
+          direccion: z.string().optional(),
+          cp: z.string().optional(),
+          ciudad: z.string().optional(),
+          mapsUrl: z.string().optional(),
+        })
+        .optional()
+        .describe("Delivery address snapshot { label, direccion, cp, ciudad, mapsUrl }"),
+    },
+    async ({ conversationId, ...data }) => {
+      const result = await sdk.createOrder(conversationId, data);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
 }