@tenpo/mcp 0.2.2 → 0.2.3

package/README.md

@@ -237,6 +237,9 @@ That's the first line. **First run auto-issues a free API key** (500 calls/month
 
 The second line goes into your AI host's config:
 
+> ⚠️ **After editing the config, fully restart your AI host.**
+> MCP servers are loaded at host startup — `claude mcp add`, saving Claude Desktop's config, or editing Cursor's MCP settings will register Tenpo, but the new tools won't appear in your running session until you **quit and relaunch the app** (Cmd+Q on Mac, fully close on Windows). This is a host-side limitation, not a Tenpo one.
+
 <details>
 <summary><b>Claude Desktop</b> · <code>claude_desktop_config.json</code></summary>
 

package/dist/index.js

@@ -370,6 +370,43 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     }));
     return { tools: [...TOOLS, ...dynamicEntries] };
 });
+/**
+ * Format a backend tool result as MCP CallTool content.
+ *
+ * Many Tenpo tools return `data.chat_message` — a pre-formatted, chat-ready
+ * string the host AI should display verbatim. Surface that as the PRIMARY
+ * text block; append the structured JSON afterward so the host AI can still
+ * introspect (e.g. for follow-up tool calls or to read `instruction_for_host_ai`).
+ *
+ * This stops the old "double-encoded JSON inside JSON" UX where the host AI
+ * saw nothing but a stringified blob.
+ */
+function formatToolResult(result) {
+    // Type guard: try to pull data.chat_message safely
+    const r = result;
+    // Error path: backend returned ok:false. Show it cleanly.
+    if (r && r.ok === false) {
+        return {
+            content: [
+                { type: "text", text: `Error: ${r.error ?? "Tool execution failed"}` },
+                { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+            isError: true,
+        };
+    }
+    const chatMessage = r?.data?.chat_message;
+    if (typeof chatMessage === "string" && chatMessage.length > 0) {
+        // Primary: the chat-ready message. Secondary: structured JSON for introspection.
+        return {
+            content: [
+                { type: "text", text: chatMessage },
+                { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+        };
+    }
+    // No chat_message — fall back to pretty-printed JSON.
+    return formatToolResult(result);
+}
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     await ensureApiKey();
     const { name, arguments: args = {} } = request.params;
@@ -380,7 +417,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     method: "POST",
                     body: args,
                 });
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
             case "tenpo_run_tool": {
                 const a = args;
@@ -390,7 +427,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     method: "POST",
                     body: a.args ?? {},
                 });
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
             case "tenpo_classify_intent": {
                 const a = args;
@@ -449,7 +486,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (!a.resource)
                     throw new Error("resource name required");
                 const result = await tenpoFetch(`/api/v1/resources/${encodeURIComponent(a.resource)}`);
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
             case "tenpo_get_prompt": {
                 const a = args;
@@ -464,7 +501,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     path += `?${params.toString()}`;
                 }
                 const result = await tenpoFetch(path);
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
             case "tenpo_list_prompts": {
                 const a = args;
@@ -472,7 +509,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ? `/api/v1/prompts?q=${encodeURIComponent(a.q)}`
                     : `/api/v1/prompts`;
                 const result = await tenpoFetch(path);
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
             case "tenpo_connect_integration": {
                 const a = args;
@@ -483,13 +520,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         method: "POST",
                         body: { integration_id: a.integration_id, credentials: a.credentials },
                     });
-                    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                    return formatToolResult(result);
                 }
                 const result = await tenpoFetch("/api/v1/connect/start", {
                     method: "POST",
                     body: { integration_id: a.integration_id },
                 });
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
             case "tenpo_remember": {
                 const a = args;
@@ -500,7 +537,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     method: "POST",
                     body: { content, scope: a.scope ?? a.memory_type ?? "fact", mode: a.mode ?? "append" },
                 });
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
             // tenpo_pattern_detect, tenpo_fetch_url, tenpo_write_md, tenpo_route_skills,
             // tenpo_overview cases DROPPED — host AI's native capabilities cover them.
@@ -515,7 +552,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     throw new Error(`Unknown tool: ${name}. Use tenpo_route to discover available tools.`);
                 }
                 const result = await tenpoFetch(`/api/v1/tools/${encodeURIComponent(name)}`, { method: "POST", body: args });
-                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                return formatToolResult(result);
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenpo/mcp",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Tenpo — the operator that runs alongside your store. Connects to 45+ commerce platforms (Shopify, Klaviyo, Meta Ads, GA4, Stripe…) and gives any AI host (Claude Desktop, Cursor, Claude Code, ChatGPT) deterministic answers about your sales, ads, email, inventory, suppliers, customers, finance, and competitors. Free tier, no card required.",
   "license": "MIT",
   "homepage": "https://tenpo.ai",