@champz-llc/legends-mcp-server 1.5.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 {

package/package.json

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