@champz-llc/legends-mcp-server 1.2.1 → 1.3.4

package/index.js

@@ -8,6 +8,27 @@ import {
 } from '@modelcontextprotocol/sdk/types.js';
 import fetch from 'node-fetch';
 
+// Helper function to fetch image and convert to base64
+async function fetchImageAsBase64(imageUrl) {
+  try {
+    const response = await fetch(imageUrl);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch image: ${response.status}`);
+    }
+    const buffer = await response.buffer();
+    return buffer.toString('base64');
+  } catch (error) {
+    console.error(`Error fetching image ${imageUrl}:`, error.message);
+    return null;
+  }
+}
+
+// MCP Signature Authentication (optional - for player data access)
+const WALLET = process.env.WALLET;
+const SIGNATURE = process.env.SIGNATURE;
+const SIGNED_AT = process.env.SIGNED_AT;
+const hasWalletAuth = WALLET && SIGNATURE && SIGNED_AT;
+
 // Hardcoded rewards data for demo
 const DEMO_WALLET = '0xfbc159e35f56580d5d297af18a8c19f83d66088a';
 
@@ -100,8 +121,7 @@ const server = new Server(
 
 // List available tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
+  const tools = [
       {
         name: 'legends_global_stats',
         description: 'Get overall Legends of Champz game statistics including total legends rolled, CHAMPZ burned, USDC distributed, total battles, and more',
@@ -201,8 +221,52 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: []
         },
       }
-    ],
-  };
+    ];
+
+  // Add player data tools if wallet is configured
+  if (hasWalletAuth) {
+    tools.push({
+      name: 'legends_player_data',
+      description: 'Get your personal Legends of Champz statistics including CHAMPZ spent on packs, legends owned, thrones, battle stats, claims history, and saved trainers. Requires wallet authentication.',
+      inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+      },
+    });
+
+    tools.push({
+      name: 'show_legend',
+      description: 'Show details and image for a specific legend you own by ID. Use this when the user asks to see a particular legend (e.g., "show me legend #1010").',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          legend_id: {
+            type: 'number',
+            description: 'The ID of the legend to display'
+          }
+        },
+        required: ['legend_id']
+      },
+    });
+
+    tools.push({
+      name: 'show_throne',
+      description: 'Show details and image for a specific throne you own by ID. Use this when the user asks to see a particular throne.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          throne_id: {
+            type: 'number',
+            description: 'The ID of the throne to display'
+          }
+        },
+        required: ['throne_id']
+      },
+    });
+  }
+
+  return { tools };
 });
 
 // Handle tool calls
@@ -531,6 +595,329 @@ Last updated: ${new Date(stats.cached_at * 1000).toLocaleString()}`;
         };
       }
 
+    case 'legends_player_data':
+      // Check if wallet authentication is configured
+      if (!hasWalletAuth) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `To access your personal Legends of Champz data, you need to connect your wallet.
+
+🔗 Setup Guide: https://legends.champz.world/mcp-setup
+
+This one-time setup takes 2 minutes:
+1. Visit the link above on your desktop
+2. Connect your Coinbase Wallet
+3. Sign a message to prove ownership
+4. Copy the config to Claude Desktop
+5. Restart Claude Desktop
+
+You can still ask about:
+• Global game stats (legends_global_stats)
+• Leaderboards (legends_leaderboard_*)
+• Current cycle information`,
+            },
+          ],
+        };
+      }
+
+      try {
+        // Call player-data endpoint with signature authentication
+        const url = `https://api.champz.world/game/spore-trainer/player-data?wallet=${encodeURIComponent(WALLET)}&signature=${encodeURIComponent(SIGNATURE)}&timestamp=${encodeURIComponent(SIGNED_AT)}`;
+        const response = await fetch(url);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error(data.error || 'Failed to fetch player data');
+        }
+
+        // Format player data
+        const displayName = data.display_name || data.basename || `${data.wallet.slice(0, 8)}...`;
+        const stats = data.statistics;
+        const claims = data.claims;
+
+        let output = `Legends of Champz - Your Statistics\n\n`;
+        output += `Player: ${displayName}\n`;
+        output += `Wallet: ${data.wallet}\n`;
+        if (data.basename) {
+          output += `Basename: ${data.basename}\n`;
+        }
+        output += `Member since: ${new Date(stats.member_since).toLocaleDateString()}\n\n`;
+
+        output += `📦 Packs & Legends:\n`;
+        output += `  • Total packs opened: ${stats.total_packs_opened}\n`;
+        output += `  • CHAMPZ spent on packs: ${stats.champz_spent_on_packs.toLocaleString()}\n`;
+        output += `  • Legends owned: ${stats.legends_owned}\n`;
+        output += `  • Saved trainer slots: ${stats.saved_trainer_slots}\n\n`;
+
+        output += `⚔️  Battle Statistics:\n`;
+        output += `  • Total battles: ${stats.total_battles}\n`;
+        output += `  • Wins: ${stats.battles_won} (${(stats.win_rate * 100).toFixed(1)}% win rate)\n`;
+        output += `  • Losses: ${stats.battles_lost}\n`;
+        output += `  • Current streak: ${stats.current_win_streak}\n`;
+        output += `  • Best streak: ${stats.best_win_streak}\n\n`;
+
+        output += `👑 Thrones & Guardian:\n`;
+        output += `  • Thrones owned: ${stats.thrones_owned}\n`;
+        output += `  • Times held guardian: ${stats.times_held_guardian}\n`;
+        output += `  • CHAMPZ spent on guardian: ${stats.champz_spent_on_guardian.toLocaleString()}\n\n`;
+
+        output += `💰 Claims History:\n`;
+        output += `  • Total USDC claimed: $${claims.total_usdc_claimed}\n`;
+        output += `  • Total CHAMPZ claimed: ${claims.total_champz_claimed.toLocaleString()}\n`;
+        output += `  • Battle USDC (type 6): ${claims.by_type['6'].count} claims, $${claims.by_type['6'].total_amount}\n`;
+        output += `  • Battle CHAMPZ (type 5): ${claims.by_type['5'].count} claims, ${claims.by_type['5'].total_amount.toLocaleString()} tokens\n`;
+        output += `  • Guardian USDC (type 19): ${claims.by_type['19'].count} claims, $${claims.by_type['19'].total_amount}\n`;
+        output += `  • Guardian CHAMPZ (type 18): ${claims.by_type['18'].count} claims, ${claims.by_type['18'].total_amount.toLocaleString()} tokens\n\n`;
+
+        // Build content array with text and images
+        const content = [
+          {
+            type: 'text',
+            text: output,
+          },
+        ];
+
+        // Add throne images (show all thrones)
+        if (data.thrones && data.thrones.length > 0) {
+          const throneText = `\n🏆 Throne Collection (${data.thrones.length}):\n`;
+          let throneList = '';
+
+          for (const [i, throne] of data.thrones.entries()) {
+            throneList += `${i + 1}. ${throne.name} (${throne.rarity.toUpperCase()}) - Cycle ${throne.cycle_id}\n`;
+
+            // Add throne image
+            const imageUrl = `https://img.champz.world${throne.image_path}`;
+            const base64Data = await fetchImageAsBase64(imageUrl);
+            if (base64Data) {
+              content.push({
+                type: 'image',
+                data: base64Data,
+                mimeType: 'image/png',
+              });
+            }
+          }
+
+          content[0].text += throneText + throneList + '\n';
+        }
+
+        // Show legend summary (don't show all images by default - too many)
+        if (data.all_legends && data.all_legends.length > 0) {
+          const legendText = `\n🍄 All Legends Owned (${data.all_legends.length}):\n`;
+          let legendSummary = '';
+
+          // Group by rarity
+          const byRarity = {
+            unique: [],
+            legendary: [],
+            epic: [],
+            rare: [],
+            common: []
+          };
+
+          data.all_legends.forEach(legend => {
+            byRarity[legend.rarity]?.push(legend);
+          });
+
+          Object.entries(byRarity).forEach(([rarity, legends]) => {
+            if (legends.length > 0) {
+              legendSummary += `  ${rarity.toUpperCase()}: ${legends.length} legends\n`;
+            }
+          });
+
+          legendSummary += `\nTo view a specific legend, ask: "Show me legend #<ID>"\n`;
+          legendSummary += `Example: "Show me legend #1010"\n\n`;
+
+          content[0].text += legendText + legendSummary;
+        }
+
+        // Add saved trainer images (premium collection)
+        if (data.saved_trainers && data.saved_trainers.length > 0) {
+          const trainerText = `⭐ Saved Trainers (${data.saved_trainers.length}):\n`;
+          let trainerList = '';
+
+          for (const [i, trainer] of data.saved_trainers.entries()) {
+            trainerList += `${i + 1}. ${trainer.rarity.toUpperCase()} Legend #${trainer.legend_id} - Power: ${trainer.total_power}\n`;
+            trainerList += `   ATK: ${trainer.attack} | DEF: ${trainer.defense} | SPD: ${trainer.speed}\n`;
+            trainerList += `   Elements: ${trainer.elements.join(', ')}\n\n`;
+
+            // Add trainer image
+            const imageUrl = `https://img.champz.world${trainer.image_path}`;
+            const base64Data = await fetchImageAsBase64(imageUrl);
+            if (base64Data) {
+              content.push({
+                type: 'image',
+                data: base64Data,
+                mimeType: 'image/png',
+              });
+            }
+          }
+
+          content[0].text += trainerText + trainerList;
+        }
+
+        return { content };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Error fetching player data: ${error.message}\n\nMake sure your wallet is registered in Legends of Champz. Visit https://legends.champz.world to play!`,
+            },
+          ],
+        };
+      }
+
+    case 'show_legend':
+      if (!hasWalletAuth) {
+        return {
+          content: [{ type: 'text', text: 'Authentication required. Visit https://legends.champz.world/mcp-setup' }],
+        };
+      }
+
+      try {
+        const legendId = request.params.arguments?.legend_id;
+        if (!legendId) {
+          throw new Error('legend_id is required');
+        }
+
+        // Fetch player data
+        const url = `https://api.champz.world/game/spore-trainer/player-data?wallet=${encodeURIComponent(WALLET)}&signature=${encodeURIComponent(SIGNATURE)}&timestamp=${encodeURIComponent(SIGNED_AT)}`;
+        const response = await fetch(url);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error('Failed to fetch player data');
+        }
+
+        // Find the legend in all_legends
+        const legend = data.all_legends?.find(l => l.legend_id === legendId);
+
+        if (!legend) {
+          return {
+            content: [
+              {
+                type: 'text',
+                text: `Legend #${legendId} not found in your collection. You own ${data.all_legends?.length || 0} legends total.`,
+              },
+            ],
+          };
+        }
+
+        // Build output
+        let output = `Legend #${legend.legend_id} - ${legend.name}\n\n`;
+        output += `Rarity: ${legend.rarity.toUpperCase()}\n`;
+        output += `Total Power: ${legend.total_power}\n`;
+        output += `ATK: ${legend.attack} | DEF: ${legend.defense} | SPD: ${legend.speed}\n`;
+        output += `Elements: ${legend.elements.join(', ')}\n`;
+        output += `Rolled: ${new Date(legend.rolled_at).toLocaleDateString()}\n`;
+        output += `Saved: ${legend.is_saved ? 'Yes ⭐' : 'No'}\n`;
+
+        // Fetch and convert image to base64
+        const imageUrl = `https://img.champz.world${legend.image_path}`;
+        const base64Data = await fetchImageAsBase64(imageUrl);
+
+        const content = [
+          {
+            type: 'text',
+            text: output,
+          },
+        ];
+
+        if (base64Data) {
+          content.push({
+            type: 'image',
+            data: base64Data,
+            mimeType: 'image/png',
+          });
+        }
+
+        return { content };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Error showing legend: ${error.message}`,
+            },
+          ],
+        };
+      }
+
+    case 'show_throne':
+      if (!hasWalletAuth) {
+        return {
+          content: [{ type: 'text', text: 'Authentication required. Visit https://legends.champz.world/mcp-setup' }],
+        };
+      }
+
+      try {
+        const throneId = request.params.arguments?.throne_id;
+        if (!throneId) {
+          throw new Error('throne_id is required');
+        }
+
+        // Fetch player data
+        const url = `https://api.champz.world/game/spore-trainer/player-data?wallet=${encodeURIComponent(WALLET)}&signature=${encodeURIComponent(SIGNATURE)}&timestamp=${encodeURIComponent(SIGNED_AT)}`;
+        const response = await fetch(url);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error('Failed to fetch player data');
+        }
+
+        // Find the throne
+        const throne = data.thrones?.find(t => t.throne_id === throneId);
+
+        if (!throne) {
+          return {
+            content: [
+              {
+                type: 'text',
+                text: `Throne #${throneId} not found in your collection. You own ${data.thrones?.length || 0} thrones total.`,
+              },
+            ],
+          };
+        }
+
+        // Build output
+        let output = `Throne #${throne.throne_id} - ${throne.name}\n\n`;
+        output += `Rarity: ${throne.rarity.toUpperCase()}\n`;
+        output += `Earned in Cycle: ${throne.cycle_id}\n`;
+        output += `Earned: ${new Date(throne.earned_at).toLocaleDateString()}\n`;
+
+        // Fetch and convert image to base64
+        const imageUrl = `https://img.champz.world${throne.image_path}`;
+        const base64Data = await fetchImageAsBase64(imageUrl);
+
+        const content = [
+          {
+            type: 'text',
+            text: output,
+          },
+        ];
+
+        if (base64Data) {
+          content.push({
+            type: 'image',
+            data: base64Data,
+            mimeType: 'image/png',
+          });
+        }
+
+        return { content };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Error showing throne: ${error.message}`,
+            },
+          ],
+        };
+      }
+
     default:
       throw new Error(`Unknown tool: ${name}`);
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@champz-llc/legends-mcp-server",
-  "version": "1.2.1",
-  "description": "MCP server for Legends of Champz - Query game stats and claim rewards through Claude Desktop",
+  "version": "1.3.4",
+  "description": "MCP server for Legends of Champz - Query game stats, access personal data with signature auth, and claim rewards through Claude Desktop",
   "type": "module",
   "main": "index.js",
   "bin": {
@@ -33,7 +33,6 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@champz-llc/legends-mcp-server": "^1.1.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "node-fetch": "^3.3.2"
   }