byclaw-mcp 0.4.16 → 0.4.18

package/dist/index.js

@@ -113,7 +113,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         // ── Core: one-shot shopping ──
         {
             name: 'shop',
-            description: TOOL_PREFIX + 'Search and compare products across multiple shops. Returns a JSON object with `picked` (the recommendation) and `alternatives` (other candidates). Each product object includes `title`, `price`, `brand`, `merchant`, `affiliate_url`, and `image_url` (absolute HTTPS URL). Emit `![title](image_url)` markdown for each product so the image renders inline in clients that support it (Claude Code, Cursor, browsers). claude.ai web / Claude Desktop App will show a click-to-load placeholder for those markdown images — that is fine, accept it. Do NOT try to build HTML widgets or other workarounds; the artifact sandbox blocks our product CDNs. See `_render_hint` in every response for the exact rendering recipe.',
+            description: TOOL_PREFIX + 'Search and recommend products on byclaw.io. Handles specific product queries ("headphones under 100€"), gift queries ("gift for my dad who likes climbing"), and open-ended requests ("something nice under 100€"). The backend detects gift mode automatically and returns either `picked`+`alternatives` or `gift_picks`+`gift_intent`. Each product has `title`, `price`, `brand`, `merchant`, `affiliate_url`, and `image_url`. Use `_render_hint` in the response for display guidance.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -126,6 +126,20 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
                 required: ['query'],
             },
         },
+        // ── Gift-specific trigger ──
+        {
+            name: 'gift_finder',
+            description: TOOL_PREFIX + 'Recommend a gift from the byclaw catalog based on recipient, occasion and budget. Returns 3 curated picks with reasoning. Shares the backend with `shop` so picking either tool yields the same response — `gift_finder` exists as a clearer entry point when the user explicitly asks for gift ideas.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Free-text gift request. May include recipient ("for my mother"), age, interests, occasion, and budget. Pass the user\'s phrasing as-is — the backend parses intent fields itself.' },
+                    max_price: { type: 'number', description: 'Maximum budget in EUR (optional)' },
+                    language: { type: 'string', description: 'User language: de, en, fr, es (auto-detected if omitted)' },
+                },
+                required: ['query'],
+            },
+        },
         // ── Optional: browse & explore ──
         {
             name: 'search_products',
@@ -439,6 +453,38 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 }
                 return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
             }
+            case 'gift_finder': {
+                // Same backend endpoint as `shop` — /api/mcp/shop auto-detects gift
+                // mode via classifyGiftIntent. gift_finder exists as a separate
+                // tool name (with a gift-focused description) so claude.ai's
+                // "no proactive e-commerce" routing has an obvious hook for vague
+                // gift queries. No follow-up session tracking here — every gift
+                // call starts fresh from the user's prompt.
+                const result = await apiCall('/api/mcp/shop', {
+                    method: 'POST',
+                    body: JSON.stringify({
+                        query: String(args?.query || ''),
+                        max_price: args?.max_price,
+                        language: args?.language,
+                        source: 'mcp',
+                    }),
+                });
+                if (!result?.ok) {
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                const d = result.data;
+                // image_url backstop — defends in depth even though the gift-flow
+                // backend fix (7ecea02) already populates it.
+                if (Array.isArray(d.gift_picks)) {
+                    d.gift_picks = d.gift_picks.map((p) => ({ ...p, image_url: imageUrlOf(p) }));
+                }
+                if (d.picked)
+                    d.picked = { ...d.picked, image_url: imageUrlOf(d.picked) };
+                if (Array.isArray(d.alternatives)) {
+                    d.alternatives = d.alternatives.map((a) => ({ ...a, image_url: imageUrlOf(a) }));
+                }
+                return { content: [{ type: 'text', text: JSON.stringify({ _render_hint: RENDER_HINT, ...d }, null, 2) }] };
+            }
             case 'search_products': {
                 const params = new URLSearchParams();
                 if (args?.query)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byclaw-mcp",
-  "version": "0.4.16",
+  "version": "0.4.18",
   "description": "MCP Server for byclaw.io — Your AI shopping advisor. Connects Claude Desktop and other MCP clients to the byclaw.io product catalog.",
   "main": "dist/index.js",
   "bin": {