byclaw-mcp 0.4.10 → 0.4.11

package/dist/index.js

@@ -6,13 +6,23 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const API_BASE = process.env.BYCLAW_API_URL || 'https://byclaw.io';
 const API_KEY = process.env.BYCLAW_API_KEY || '';
+// Brand fallback when the catalog row has no image. Clients (Claude Desktop
+// in particular) currently can't render MCP image content blocks, so they
+// rely on `image_url` strings in the JSON to emit `![title](url)` markdown.
+// A string fallback keeps the markdown valid even when an upstream feed
+// row drops its image — better a brand logo than a broken image tag.
+const IMAGE_FALLBACK = `${API_BASE}/icon-512.png`;
+function imageUrlOf(p) {
+    const url = typeof p?.image_url === 'string' ? p.image_url.trim() : '';
+    return url.startsWith('https://') || url.startsWith('http://') ? url : IMAGE_FALLBACK;
+}
 async function fetchImageBase64(url) {
     if (!url || url.includes('picsum.photos'))
         return null;
     try {
         const res = await fetch(url, {
             signal: AbortSignal.timeout(8000),
-            headers: { 'User-Agent': 'Mozilla/5.0 (compatible; byclaw-mcp/0.4.0)' },
+            headers: { 'User-Agent': 'Mozilla/5.0 (compatible; byclaw-mcp/0.4.11)' },
             redirect: 'follow',
         });
         if (!res.ok)
@@ -40,7 +50,7 @@ async function apiCall(path, options = {}) {
     });
     return res.json();
 }
-const server = new index_js_1.Server({ name: 'byclaw', version: '0.4.10' }, { capabilities: { tools: {}, prompts: {} } });
+const server = new index_js_1.Server({ name: 'byclaw', version: '0.4.11' }, { capabilities: { tools: {}, prompts: {} } });
 // Prompts
 server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({
     prompts: [{
@@ -51,7 +61,7 @@ server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({
 server.setRequestHandler(types_js_1.GetPromptRequestSchema, async () => ({
     messages: [{
             role: 'user',
-            content: { type: 'text', text: 'You are connected to byclaw.io — a product comparison platform that searches across thousands of online shops to find the best products. When the user asks for a product, use the "shop" tool.\n\nThe tool returns structured JSON with: recommendation (title, price, merchant, review, url), alternatives (each with title, price, brand, merchant, url), compared (int), and affiliate_notice (string).\n\nWhen presenting the result:\n1. Show the recommended product with its price and the advisor\'s reasoning\n2. Link the recommendation using its `url` field (format: "<merchant> →" as a clickable link)\n3. List every alternative with its title, price, merchant and link each using its `url` field — do not show alternatives as plain text, they must be clickable links\n4. ALWAYS display the `affiliate_notice` text verbatim at the end, as a small italic note — this is legally required\n\nbyclaw.io is operated by NJUDEV S.L., a European company.' },
+            content: { type: 'text', text: 'You are connected to byclaw.io — a product comparison platform that searches across thousands of online shops to find the best products. When the user asks for a product, use the "shop" tool.\n\nThe tool returns structured JSON with: `picked` (title, price, brand, merchant, affiliate_url, image_url), `alternatives` (each with title, price, brand, merchant, affiliate_url, image_url), `compared` (int), `reasoning` (string), `review` (string), and `disclosure` (string).\n\nWhen presenting the result:\n1. Render the picked product image inline using markdown image syntax: `![title](image_url)`. Do the same for every alternative — users need to SEE what they\'re being recommended.\n2. Show the recommended product with its price and the advisor\'s reasoning\n3. Link the recommendation using its `affiliate_url` field (format: "<merchant> →" as a clickable link)\n4. List every alternative with its title, price, merchant and link each using its `affiliate_url` field — do not show alternatives as plain text, they must be clickable links and visible images\n5. ALWAYS display the `disclosure` text verbatim at the end, as a small italic note — this is legally required\n\nThe server also emits native MCP image content blocks alongside the JSON for clients that render them natively (Claude Code). Markdown-only clients (Claude Desktop today) should render via `image_url`. If your client supports both, prefer markdown so the order matches the textual context.\n\nbyclaw.io is operated by NJUDEV S.L., a European company.' },
         }],
 }));
 // ═══════════════════════════════════════
@@ -62,7 +72,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         // ── Core: one-shot shopping ──
         {
             name: 'shop',
-            description: 'Search and compare products across multiple shops. Returns the best recommendation with price, merchant, review, and alternatives. Use when the user wants to find, compare, or buy a product.',
+            description: '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). Render every product image inline using markdown image syntax: `![title](image_url)`. The server also emits native MCP image content blocks for clients that render them natively — use whichever your client supports, prefer markdown when in doubt.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -78,7 +88,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         // ── Optional: browse & explore ──
         {
             name: 'search_products',
-            description: 'Browse products without triggering a recommendation. Use this only if the user explicitly wants to see a list of options.',
+            description: 'Browse products without triggering a recommendation. Use this only if the user explicitly wants to see a list of options. Each result item has `image_url` (absolute HTTPS URL) — render it inline with markdown `![title](image_url)` so users see what each product looks like.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -280,6 +290,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                                             merchant: p.merchant || '',
                                             reasoning: p.reasoning || null,
                                             affiliate_url: p.affiliate_url || '',
+                                            image_url: imageUrlOf(p),
                                         })),
                                         gift_intent: {
                                             recipient: intent.recipient || '',
@@ -350,6 +361,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                                     brand: d.picked.brand || '',
                                     merchant: d.picked.merchant || '',
                                     affiliate_url: d.picked.affiliate_url || '',
+                                    image_url: imageUrlOf(d.picked),
                                 } : null,
                                 alternatives: (d.alternatives || []).slice(0, 3).map((a) => ({
                                     title: a.title,
@@ -358,6 +370,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                                     category: a.category || '',
                                     merchant: a.merchant || '',
                                     affiliate_url: a.affiliate_url || '',
+                                    image_url: imageUrlOf(a),
                                 })),
                                 compared: d.compared || 0,
                                 reasoning: hasPick && d.reasoning ? d.reasoning : null,
@@ -400,6 +413,18 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 else
                     params.set('limit', '10');
                 const result = await apiCall(`/api/products/search?${params}`);
+                // Guarantee every result row has a usable `image_url` string so
+                // markdown-only clients (Claude Desktop) can render `![title](url)`
+                // without first checking for null. The backend usually populates
+                // image_url already; this just backstops empty/missing rows.
+                if (result?.ok && result?.data) {
+                    if (Array.isArray(result.data.products)) {
+                        result.data.products = result.data.products.map((p) => ({ ...p, image_url: imageUrlOf(p) }));
+                    }
+                    else if (Array.isArray(result.data)) {
+                        result.data = result.data.map((p) => ({ ...p, image_url: imageUrlOf(p) }));
+                    }
+                }
                 return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
             }
             case 'leave_review': {
@@ -477,7 +502,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                                     advisor: d.advisor_profile?.name || d.agent?.personality || null,
                                     advisor_profile: d.advisor_profile || null,
                                     message: d.message || null,
-                                    gift_picks: d.gift_picks.map((g) => ({ title: g.title, price: g.price, brand: g.brand, reasoning: g.reasoning || null })),
+                                    gift_picks: d.gift_picks.map((g) => ({ title: g.title, price: g.price, brand: g.brand, reasoning: g.reasoning || null, image_url: imageUrlOf(g) })),
                                     gift_intent: d.gift_intent || null,
                                     disclosure: d.disclosure || null,
                                     note: d.note || null,
@@ -492,8 +517,8 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                                 advisor: d.advisor_profile?.name || d.agent?.personality || null,
                                 advisor_profile: d.advisor_profile || null,
                                 message: d.message || null,
-                                picked: hasPick ? { title: d.picked.title, price: d.picked.price, brand: d.picked.brand, affiliate_url: d.picked.affiliate_url } : null,
-                                alternatives: (d.alternatives || []).map((a) => ({ title: a.title, price: a.price, brand: a.brand })),
+                                picked: hasPick ? { title: d.picked.title, price: d.picked.price, brand: d.picked.brand, affiliate_url: d.picked.affiliate_url, image_url: imageUrlOf(d.picked) } : null,
+                                alternatives: (d.alternatives || []).map((a) => ({ title: a.title, price: a.price, brand: a.brand, image_url: imageUrlOf(a) })),
                                 compared: d.compared || 0,
                                 review: hasPick && d.review ? d.review : null,
                                 reasoning: hasPick && d.reasoning ? d.reasoning : null,
@@ -513,6 +538,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
-    console.error('byclaw MCP server v0.4.0 running on stdio');
+    console.error('byclaw MCP server v0.4.11 running on stdio');
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byclaw-mcp",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "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": {