byclaw-mcp 0.4.10 → 0.4.12

package/dist/index.js

@@ -4,15 +4,42 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const fs_1 = require("fs");
+const path_1 = require("path");
+// Single source of truth for the version string. Used in serverInfo,
+// startup banner, User-Agent, and as a [byclaw-mcp vX.Y.Z] prefix on
+// every tool description so MCP clients (and the model running inside
+// them) can see at a glance which version they're talking to without
+// peeking at the MCP-internal serverInfo handshake metadata.
+const SERVER_VERSION = (() => {
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', 'package.json'), 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
+const TOOL_PREFIX = `[byclaw-mcp v${SERVER_VERSION}] `;
 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/${SERVER_VERSION})` },
             redirect: 'follow',
         });
         if (!res.ok)
@@ -40,7 +67,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: SERVER_VERSION }, { capabilities: { tools: {}, prompts: {} } });
 // Prompts
 server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({
     prompts: [{
@@ -51,7 +78,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 +89,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: 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). 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 +105,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: TOOL_PREFIX + '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: {
@@ -93,7 +120,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         },
         {
             name: 'leave_review',
-            description: 'Write a product review. Only call if the user explicitly asks to leave a review. Only de and en allowed.',
+            description: TOOL_PREFIX + 'Write a product review. Only call if the user explicitly asks to leave a review. Only de and en allowed.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -109,17 +136,17 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         // ── Discovery ──
         {
             name: 'list_categories',
-            description: 'Browse all available product categories.',
+            description: TOOL_PREFIX + 'Browse all available product categories.',
             inputSchema: { type: 'object', properties: {} },
         },
         {
             name: 'get_trending',
-            description: 'Get trending products that agents are buying right now.',
+            description: TOOL_PREFIX + 'Get trending products that agents are buying right now.',
             inputSchema: { type: 'object', properties: {} },
         },
         {
             name: 'get_product_reviews',
-            description: 'Get agent reviews for a product.',
+            description: TOOL_PREFIX + 'Get agent reviews for a product.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -129,13 +156,13 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         },
         {
             name: 'get_platform_stats',
-            description: 'Get platform statistics: products compared, reviews written, recommendations sent.',
+            description: TOOL_PREFIX + 'Get platform statistics: products compared, reviews written, recommendations sent.',
             inputSchema: { type: 'object', properties: {} },
         },
         // ── QA / Testing ──
         {
             name: 'test_web_search',
-            description: 'Test the web agent search endpoint (same as dashboard search). Use for QA to verify web search behavior vs MCP shop behavior.',
+            description: TOOL_PREFIX + 'Test the web agent search endpoint (same as dashboard search). Use for QA to verify web search behavior vs MCP shop behavior.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -280,6 +307,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 +378,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 +387,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 +430,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 +519,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 +534,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 +555,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 v${SERVER_VERSION} running on stdio`);
 }
 main().catch(console.error);

package/package.json

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