@champz-llc/legends-mcp-server 1.4.0 → 1.6.0

package/index.js

@@ -51,10 +51,14 @@ const SIGNATURE = process.env.SIGNATURE;
 const SIGNED_AT = process.env.SIGNED_AT;
 const hasWalletAuth = WALLET && SIGNATURE && SIGNED_AT;
 
-// Hardcoded rewards data for demo
+// ============================================================
+// LEGACY: Hardcoded rewards data for BuildOnBase contest demo
+// NOTE: This is no longer used! Real claims now fetched from API
+// with mode=claims parameter. Kept for reference only.
+// ============================================================
 const DEMO_WALLET = '0xfbc159e35f56580d5d297af18a8c19f83d66088a';
 
-const REWARDS_DATA = {
+const REWARDS_DATA_LEGACY = {
   wallet: DEMO_WALLET,
   champz_claims: [
     {
@@ -155,7 +159,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'check_legends_rewards',
-        description: 'Check claimable rewards in Legends of Champz game. Returns pending CHAMPZ tokens and USDC claims with contract details.',
+        description: 'Check YOUR pending claimable rewards in Legends of Champz. Returns CHAMPZ tokens and USDC claims with amounts and expiration dates. Requires wallet authentication.',
         inputSchema: {
           type: 'object',
           properties: {},
@@ -164,7 +168,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'get_champz_claim_data',
-        description: 'Get complete contract call data for claiming CHAMPZ tokens (includes ABI, parameters, signature)',
+        description: 'Get complete contract call data for claiming YOUR CHAMPZ token rewards. Returns contract address, ABI, function parameters, and signature ready for Base MCP execution. Requires wallet authentication.',
         inputSchema: {
           type: 'object',
           properties: {},
@@ -173,7 +177,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'get_usdc_claim_data',
-        description: 'Get complete contract call data for claiming USDC rewards (includes ABI, parameters, signature)',
+        description: 'Get complete contract call data for claiming YOUR USDC rewards. Returns contract address, ABI, function parameters, and signature ready for Base MCP execution. Requires wallet authentication.',
         inputSchema: {
           type: 'object',
           properties: {},
@@ -351,54 +355,154 @@ Last updated: ${new Date(stats.cached_at * 1000).toLocaleString()}`;
       }
 
     case 'check_legends_rewards':
-      return {
-        content: [
-          {
-            type: 'text',
-            text: `Legends of Champz - Claimable Rewards\n\n${REWARDS_DATA.summary.message}\n\nDetails:\n- CHAMPZ: ${REWARDS_DATA.champz_claims[0].amount_human}\n- USDC: ${REWARDS_DATA.usdc_claims[0].amount_human}\n\nBoth claims are ready to execute on Base L2.`,
-          },
-        ],
-      };
+      if (!hasWalletAuth) {
+        return {
+          content: [{ type: 'text', text: 'Authentication required. Visit https://legends.champz.world/mcp-setup' }],
+        };
+      }
+
+      try {
+        // Fetch pending claims
+        const url = `https://api.champz.world/game/spore-trainer/player-data?wallet=${encodeURIComponent(WALLET)}&signature=${encodeURIComponent(SIGNATURE)}&timestamp=${encodeURIComponent(SIGNED_AT)}&mode=claims`;
+        const response = await fetch(url);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error('Failed to fetch claims data');
+        }
+
+        if (data.champz_claims.length === 0 && data.usdc_claims.length === 0) {
+          return {
+            content: [
+              {
+                type: 'text',
+                text: '🍄 Legends of Champz - Claimable Rewards\n\nNo pending claims available at the moment.\n\nKeep battling and holding thrones to earn rewards! ⚔️👑',
+              },
+            ],
+          };
+        }
+
+        let output = '🍄 Legends of Champz - Claimable Rewards\n\n';
+        output += `${data.message}\n\n`;
+        output += `💰 **Total Claimable:**\n`;
+        if (data.total_champz !== '0.00 CHAMPZ') output += `  🍄 ${data.total_champz}\n`;
+        if (data.total_usdc !== '0.00 USDC') output += `  💵 ${data.total_usdc}\n`;
+        output += `\n📍 Ready to execute on Base L2 (Chain ID: ${data.chain_id})\n`;
+
+        return {
+          content: [{ type: 'text', text: output }],
+        };
+      } catch (error) {
+        return {
+          content: [{ type: 'text', text: `Error fetching claims: ${error.message}` }],
+        };
+      }
 
     case 'get_champz_claim_data':
-      return {
-        content: [
-          {
-            type: 'text',
-            text: JSON.stringify({
-              claim_type: 'CHAMPZ Tokens',
-              contract_address: REWARDS_DATA.champz_claims[0].contract,
-              chain: 'Base (8453)',
-              amount: REWARDS_DATA.champz_claims[0].amount_human,
-              contract_call: {
-                function: 'claim',
-                parameters: REWARDS_DATA.champz_claims[0].parameters,
-                abi: CHAMPZ_REWARDS_ABI
-              }
-            }, null, 2),
-          },
-        ],
-      };
+      if (!hasWalletAuth) {
+        return {
+          content: [{ type: 'text', text: 'Authentication required. Visit https://legends.champz.world/mcp-setup' }],
+        };
+      }
+
+      try {
+        // Fetch pending claims
+        const url = `https://api.champz.world/game/spore-trainer/player-data?wallet=${encodeURIComponent(WALLET)}&signature=${encodeURIComponent(SIGNATURE)}&timestamp=${encodeURIComponent(SIGNED_AT)}&mode=claims`;
+        const response = await fetch(url);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error('Failed to fetch claims data');
+        }
+
+        if (data.champz_claims.length === 0) {
+          return {
+            content: [{ type: 'text', text: 'No pending CHAMPZ claims available' }],
+          };
+        }
+
+        // Return all CHAMPZ claims with contract data
+        const claimsOutput = data.champz_claims.map(claim => ({
+          claim_id: claim.claim_id,
+          claim_type: claim.claim_type_name,
+          amount: claim.amount_human,
+          contract_address: claim.contract,
+          chain: 'Base (8453)',
+          expires_at: claim.expires_at,
+          contract_call: {
+            function: claim.function_name,
+            parameters: claim.parameters,
+            abi_function: claim.abi_function,
+            abi: CHAMPZ_REWARDS_ABI
+          }
+        }));
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(claimsOutput, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [{ type: 'text', text: `Error fetching CHAMPZ claims: ${error.message}` }],
+        };
+      }
 
     case 'get_usdc_claim_data':
-      return {
-        content: [
-          {
-            type: 'text',
-            text: JSON.stringify({
-              claim_type: 'USDC Rewards',
-              contract_address: REWARDS_DATA.usdc_claims[0].contract,
-              chain: 'Base (8453)',
-              amount: REWARDS_DATA.usdc_claims[0].amount_human,
-              contract_call: {
-                function: 'claim',
-                parameters: REWARDS_DATA.usdc_claims[0].parameters,
-                abi: USDC_REWARDS_ABI
-              }
-            }, null, 2),
-          },
-        ],
-      };
+      if (!hasWalletAuth) {
+        return {
+          content: [{ type: 'text', text: 'Authentication required. Visit https://legends.champz.world/mcp-setup' }],
+        };
+      }
+
+      try {
+        // Fetch pending claims
+        const url = `https://api.champz.world/game/spore-trainer/player-data?wallet=${encodeURIComponent(WALLET)}&signature=${encodeURIComponent(SIGNATURE)}&timestamp=${encodeURIComponent(SIGNED_AT)}&mode=claims`;
+        const response = await fetch(url);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error('Failed to fetch claims data');
+        }
+
+        if (data.usdc_claims.length === 0) {
+          return {
+            content: [{ type: 'text', text: 'No pending USDC claims available' }],
+          };
+        }
+
+        // Return all USDC claims with contract data
+        const claimsOutput = data.usdc_claims.map(claim => ({
+          claim_id: claim.claim_id,
+          claim_type: claim.claim_type_name,
+          amount: claim.amount_human,
+          contract_address: claim.contract,
+          chain: 'Base (8453)',
+          expires_at: claim.expires_at,
+          contract_call: {
+            function: claim.function_name,
+            parameters: claim.parameters,
+            abi_function: claim.abi_function,
+            abi: USDC_REWARDS_ABI
+          }
+        }));
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(claimsOutput, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [{ type: 'text', text: `Error fetching USDC claims: ${error.message}` }],
+        };
+      }
 
     case 'legends_leaderboard_current':
       try {
@@ -831,13 +935,17 @@ You can still ask about:
           };
         }
 
-        // Build card-like output with gaming vibes
-        const rarityEmojis = {
-          unique: '💎',
-          legendary: '🌟',
-          epic: '🟣',
-          rare: '🔵',
-          common: '⚪'
+        // Fetch image
+        const imageUrl = `https://img.champz.world${legend.image_path}`;
+        const base64Data = await fetchImageAsBase64(imageUrl);
+
+        // Build HTML card with embedded image
+        const rarityColors = {
+          unique: '#FFD700',
+          legendary: '#FF6B35',
+          epic: '#9D4EDD',
+          rare: '#4EA8DE',
+          common: '#CCCCCC'
         };
         const elementEmojis = {
           fire: '🔥',
@@ -848,46 +956,193 @@ You can still ask about:
           dark: '🌑'
         };
 
-        let output = `╔════════════════════════╗\n`;
-        output += `║  ${rarityEmojis[legend.rarity]} ${legend.rarity.toUpperCase()} LEGEND #${legend.legend_id}  ║\n`;
-        output += `╚════════════════════════╝\n\n`;
-
-        output += `🍄 **${legend.name}**\n\n`;
-
-        // Elements with emojis
-        const elementIcons = legend.elements.map(e => `${elementEmojis[e] || '⭐'} ${e.charAt(0).toUpperCase() + e.slice(1)}`).join('  ');
-        output += `${elementIcons}\n\n`;
-
-        output += `⚡ **Total Power:** ${legend.total_power}\n`;
-        output += `⚔️  **ATK:** ${legend.attack}\n`;
-        output += `🛡️  **DEF:** ${legend.defense}\n`;
-        output += `💨 **SPD:** ${legend.speed}\n\n`;
-
-        output += `📅 Rolled: ${new Date(legend.rolled_at).toLocaleDateString()}\n`;
-        output += legend.is_saved ? `⭐ **Saved Trainer** - This legend is in your collection!\n` : `💡 Not saved yet - save this legend to keep it forever!\n`;
-
-        // Fetch image
-        const imageUrl = `https://img.champz.world${legend.image_path}`;
-
-        // Fetch and convert image to base64
-        const base64Data = await fetchImageAsBase64(imageUrl);
-
-        const content = [
-          {
-            type: 'text',
-            text: output,
-          },
-        ];
-
-        if (base64Data) {
-          content.push({
-            type: 'image',
-            data: base64Data,
-            mimeType: 'image/jpeg',
-          });
-        }
+        const elementIcons = legend.elements.map(e => `${elementEmojis[e] || '⭐'} ${e.charAt(0).toUpperCase() + e.slice(1)}`).join(' ');
+        const rarityColor = rarityColors[legend.rarity] || '#9D4EDD';
+        const rarityBadge = legend.rarity.toUpperCase();
+
+        const html = `<!DOCTYPE html>
+<html>
+<head>
+<meta charset="UTF-8">
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+    background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    min-height: 100vh;
+    padding: 20px;
+  }
+  .card {
+    background: linear-gradient(145deg, #2a2a3e 0%, #1f1f2e 100%);
+    border-radius: 16px;
+    padding: 24px;
+    max-width: 400px;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.4);
+    border: 2px solid ${rarityColor};
+    position: relative;
+    overflow: hidden;
+  }
+  .card::before {
+    content: '';
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    height: 4px;
+    background: linear-gradient(90deg, ${rarityColor}, transparent);
+  }
+  .header {
+    text-align: center;
+    margin-bottom: 16px;
+    border-bottom: 2px solid rgba(255,255,255,0.1);
+    padding-bottom: 12px;
+  }
+  .rarity-badge {
+    background: ${rarityColor};
+    color: #000;
+    padding: 4px 12px;
+    border-radius: 12px;
+    font-weight: bold;
+    font-size: 11px;
+    display: inline-block;
+    margin-bottom: 8px;
+    text-transform: uppercase;
+    letter-spacing: 1px;
+  }
+  .legend-id {
+    color: #fff;
+    font-size: 20px;
+    font-weight: bold;
+    margin-bottom: 4px;
+  }
+  .legend-name {
+    color: ${rarityColor};
+    font-size: 18px;
+    font-weight: bold;
+  }
+  .image-container {
+    text-align: center;
+    margin: 16px 0;
+    background: rgba(0,0,0,0.3);
+    border-radius: 12px;
+    padding: 12px;
+    border: 1px solid rgba(255,255,255,0.1);
+  }
+  .legend-image {
+    max-width: 200px;
+    border-radius: 8px;
+    display: block;
+    margin: 0 auto;
+  }
+  .elements {
+    text-align: center;
+    font-size: 14px;
+    color: #fff;
+    margin: 12px 0;
+    padding: 8px;
+    background: rgba(255,255,255,0.05);
+    border-radius: 8px;
+  }
+  .stats {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 12px;
+    margin: 16px 0;
+  }
+  .stat {
+    background: rgba(255,255,255,0.05);
+    padding: 12px;
+    border-radius: 8px;
+    border-left: 3px solid ${rarityColor};
+  }
+  .stat-label {
+    color: #aaa;
+    font-size: 12px;
+    margin-bottom: 4px;
+  }
+  .stat-value {
+    color: #fff;
+    font-size: 18px;
+    font-weight: bold;
+  }
+  .power {
+    grid-column: 1 / -1;
+    text-align: center;
+    background: linear-gradient(135deg, rgba(157, 78, 221, 0.2), rgba(77, 144, 254, 0.2));
+    border: 2px solid ${rarityColor};
+  }
+  .power .stat-value {
+    font-size: 24px;
+    color: ${rarityColor};
+  }
+  .footer {
+    margin-top: 16px;
+    padding-top: 12px;
+    border-top: 1px solid rgba(255,255,255,0.1);
+    text-align: center;
+    color: #888;
+    font-size: 12px;
+  }
+  .saved-badge {
+    display: inline-block;
+    background: linear-gradient(135deg, #FFD700, #FFA500);
+    color: #000;
+    padding: 6px 12px;
+    border-radius: 8px;
+    font-weight: bold;
+    margin-top: 8px;
+  }
+</style>
+</head>
+<body>
+  <div class="card">
+    <div class="header">
+      <div class="rarity-badge">${rarityBadge}</div>
+      <div class="legend-id">Legend #${legend.legend_id}</div>
+      <div class="legend-name">🍄 ${legend.name}</div>
+    </div>
+    ${base64Data ? `
+    <div class="image-container">
+      <img src="data:image/jpeg;base64,${base64Data}" alt="${legend.name}" class="legend-image">
+    </div>` : ''}
+    <div class="elements">${elementIcons}</div>
+    <div class="stats">
+      <div class="stat power">
+        <div class="stat-label">⚡ TOTAL POWER</div>
+        <div class="stat-value">${legend.total_power}</div>
+      </div>
+      <div class="stat">
+        <div class="stat-label">⚔️ ATTACK</div>
+        <div class="stat-value">${legend.attack}</div>
+      </div>
+      <div class="stat">
+        <div class="stat-label">🛡️ DEFENSE</div>
+        <div class="stat-value">${legend.defense}</div>
+      </div>
+      <div class="stat">
+        <div class="stat-label">💨 SPEED</div>
+        <div class="stat-value">${legend.speed}</div>
+      </div>
+    </div>
+    <div class="footer">
+      📅 Rolled: ${new Date(legend.rolled_at).toLocaleDateString()}
+      ${legend.is_saved ? '<div class="saved-badge">⭐ SAVED TRAINER</div>' : ''}
+    </div>
+  </div>
+</body>
+</html>`;
 
-        return { content };
+        return {
+          content: [
+            {
+              type: 'text',
+              text: html,
+            },
+          ],
+        };
       } catch (error) {
         return {
           content: [
@@ -935,43 +1190,180 @@ You can still ask about:
           };
         }
 
-        // Build card-like output with gaming vibes
-        const rarityEmojis = {
-          legendary: '👑',
-          epic: '💜',
-          rare: '💙',
-          common: '🤍'
-        };
-
-        let output = `╔════════════════════════╗\n`;
-        output += `║  ${rarityEmojis[throne.rarity] || '🏆'} ${throne.rarity.toUpperCase()} THRONE #${throne.throne_id}  ║\n`;
-        output += `╚════════════════════════╝\n\n`;
-
-        output += `👑 **${throne.name}**\n\n`;
-        output += `🎮 **Earned in Cycle:** ${throne.cycle_id}\n`;
-        output += `📅 **Date Earned:** ${new Date(throne.earned_at).toLocaleDateString()}\n\n`;
-        output += `🏆 You're a champion! This throne proves you held the Guardian position and won the cycle!\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,
-          },
-        ];
+        // Build HTML card with embedded image
+        const rarityColors = {
+          legendary: '#FFD700',
+          epic: '#9D4EDD',
+          rare: '#4EA8DE',
+          common: '#CCCCCC'
+        };
 
-        if (base64Data) {
-          content.push({
-            type: 'image',
-            data: base64Data,
-            mimeType: 'image/jpeg',
-          });
-        }
+        const rarityColor = rarityColors[throne.rarity] || '#FFD700';
+        const rarityBadge = throne.rarity.toUpperCase();
+
+        const html = `<!DOCTYPE html>
+<html>
+<head>
+<meta charset="UTF-8">
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+    background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    min-height: 100vh;
+    padding: 20px;
+  }
+  .card {
+    background: linear-gradient(145deg, #2a2a3e 0%, #1f1f2e 100%);
+    border-radius: 16px;
+    padding: 24px;
+    max-width: 400px;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.4);
+    border: 2px solid ${rarityColor};
+    position: relative;
+    overflow: hidden;
+  }
+  .card::before {
+    content: '';
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    height: 4px;
+    background: linear-gradient(90deg, ${rarityColor}, transparent);
+  }
+  .header {
+    text-align: center;
+    margin-bottom: 16px;
+    border-bottom: 2px solid rgba(255,255,255,0.1);
+    padding-bottom: 12px;
+  }
+  .rarity-badge {
+    background: ${rarityColor};
+    color: #000;
+    padding: 4px 12px;
+    border-radius: 12px;
+    font-weight: bold;
+    font-size: 11px;
+    display: inline-block;
+    margin-bottom: 8px;
+    text-transform: uppercase;
+    letter-spacing: 1px;
+  }
+  .throne-id {
+    color: #fff;
+    font-size: 20px;
+    font-weight: bold;
+    margin-bottom: 4px;
+  }
+  .throne-name {
+    color: ${rarityColor};
+    font-size: 18px;
+    font-weight: bold;
+  }
+  .image-container {
+    text-align: center;
+    margin: 16px 0;
+    background: rgba(0,0,0,0.3);
+    border-radius: 12px;
+    padding: 12px;
+    border: 1px solid rgba(255,255,255,0.1);
+  }
+  .throne-image {
+    max-width: 200px;
+    border-radius: 8px;
+    display: block;
+    margin: 0 auto;
+  }
+  .info {
+    background: rgba(255,255,255,0.05);
+    padding: 16px;
+    border-radius: 8px;
+    border-left: 3px solid ${rarityColor};
+    margin: 16px 0;
+  }
+  .info-row {
+    display: flex;
+    justify-content: space-between;
+    color: #fff;
+    padding: 8px 0;
+    border-bottom: 1px solid rgba(255,255,255,0.05);
+  }
+  .info-row:last-child {
+    border-bottom: none;
+  }
+  .info-label {
+    color: #aaa;
+    font-size: 14px;
+  }
+  .info-value {
+    font-weight: bold;
+    font-size: 14px;
+  }
+  .trophy-message {
+    text-align: center;
+    background: linear-gradient(135deg, rgba(255, 215, 0, 0.2), rgba(255, 165, 0, 0.2));
+    border: 2px solid ${rarityColor};
+    padding: 16px;
+    border-radius: 8px;
+    margin-top: 16px;
+  }
+  .trophy-message .emoji {
+    font-size: 32px;
+    display: block;
+    margin-bottom: 8px;
+  }
+  .trophy-message .text {
+    color: #fff;
+    font-weight: bold;
+    font-size: 14px;
+  }
+</style>
+</head>
+<body>
+  <div class="card">
+    <div class="header">
+      <div class="rarity-badge">${rarityBadge} THRONE</div>
+      <div class="throne-id">Throne #${throne.throne_id}</div>
+      <div class="throne-name">👑 ${throne.name}</div>
+    </div>
+    ${base64Data ? `
+    <div class="image-container">
+      <img src="data:image/jpeg;base64,${base64Data}" alt="${throne.name}" class="throne-image">
+    </div>` : ''}
+    <div class="info">
+      <div class="info-row">
+        <span class="info-label">🎮 Cycle</span>
+        <span class="info-value">#${throne.cycle_id}</span>
+      </div>
+      <div class="info-row">
+        <span class="info-label">📅 Date Earned</span>
+        <span class="info-value">${new Date(throne.earned_at).toLocaleDateString()}</span>
+      </div>
+    </div>
+    <div class="trophy-message">
+      <span class="emoji">🏆</span>
+      <span class="text">CHAMPION! You held the Guardian position and won Cycle ${throne.cycle_id}!</span>
+    </div>
+  </div>
+</body>
+</html>`;
 
-        return { content };
+        return {
+          content: [
+            {
+              type: 'text',
+              text: html,
+            },
+          ],
+        };
       } catch (error) {
         return {
           content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@champz-llc/legends-mcp-server",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "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",