@champz-llc/legends-mcp-server 1.1.2 → 1.3.2

package/README.md

@@ -58,6 +58,12 @@ Once configured, you can ask Claude:
 - "How much CHAMPZ has been burned?"
 - "How much USDC has been distributed to players?"
 
+### Leaderboards
+- "Show me the current cycle leaderboard for Legends"
+- "Who's winning the weekly battle leaderboard?"
+- "What are the all-time leaderboards for Legends of Champz?"
+- "Show me the top 20 players in the current cycle"
+
 ### Reward Management
 - "Check my claimable rewards in Legends"
 - "Get my CHAMPZ claim data"
@@ -85,10 +91,50 @@ Get contract call data for claiming CHAMPZ tokens.
 ### `get_usdc_claim_data`
 Get contract call data for claiming USDC rewards.
 
+### `legends_leaderboard_current`
+Get current cycle battle leaderboard (top players in active 12-hour cycle).
+
+**Parameters**:
+- `limit` (optional): Number of players to show (1-100, default: 10)
+
+**Returns**:
+- Current cycle ID and letter
+- Cycle end time
+- Top players with wins/losses, win rate, streaks
+- Player tier badges and legend rarity
+
+### `legends_leaderboard_weekly`
+Get weekly battle leaderboard with USDC prize distribution.
+
+**Parameters**:
+- `limit` (optional): Number of players to show (1-100, default: 10)
+
+**Returns**:
+- Week number and cycle range
+- Total USDC prize pool ($100)
+- Top players with battle stats and USDC rewards
+- Cycles remaining in current week
+
+### `legends_leaderboard_alltime`
+Get all-time leaderboards across 10 categories.
+
+**Parameters**:
+- `limit` (optional): Players per category (1-50, default: 10)
+
+**Returns**:
+- Most CHAMPZ earned
+- Most USDC earned
+- Most total wins
+- Most guardian wins
+- Highest win rate (min 100 battles)
+- Longest win streak
+- Elemental Charge high scores and stats
+
 ## 📡 API Endpoints
 
 The server connects to:
 - **Global Stats**: `https://api.champz.world/game/spore-trainer/global-stats`
+- **Leaderboards**: `https://api.champz.world/game/spore-trainer/public-leaderboard`
 - **Rewards**: (Coming soon - player-specific endpoints)
 
 ## 🔧 Development

package/index.js

@@ -8,6 +8,12 @@ import {
 } from '@modelcontextprotocol/sdk/types.js';
 import fetch from 'node-fetch';
 
+// 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 +106,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',
@@ -137,9 +142,116 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {},
           required: []
         },
+      },
+      {
+        name: 'legends_leaderboard_current',
+        description: 'Get current cycle leaderboard for Legends of Champz. Shows top players in the active 12-hour cycle across battles, guardian (throne), or Elemental Charge mini-game.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            category: {
+              type: 'string',
+              description: 'Leaderboard category: battles (default), guardian (throne holders), or ec (Elemental Charge)',
+              enum: ['battles', 'guardian', 'ec']
+            },
+            limit: {
+              type: 'number',
+              description: 'Number of top players to show (default: 10, max: 100)',
+              minimum: 1,
+              maximum: 100
+            }
+          },
+          required: []
+        },
+      },
+      {
+        name: 'legends_leaderboard_weekly',
+        description: 'Get weekly leaderboard for Legends of Champz. Shows top players for the current week (21 cycles) across battles (with USDC rewards) or guardian (throne competition).',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            category: {
+              type: 'string',
+              description: 'Leaderboard category: battles (default - with USDC rewards) or guardian (throne holders). Note: ec not available for weekly.',
+              enum: ['battles', 'guardian']
+            },
+            limit: {
+              type: 'number',
+              description: 'Number of top players to show (default: 10, max: 100)',
+              minimum: 1,
+              maximum: 100
+            }
+          },
+          required: []
+        },
+      },
+      {
+        name: 'legends_leaderboard_alltime',
+        description: 'Get all-time leaderboards for Legends of Champz. Can show all categories or filter by battles, guardian, or ec (Elemental Charge) stats.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            category: {
+              type: 'string',
+              description: 'Filter by category: all (default - shows everything), battles (wins/earnings/streaks), guardian (throne wins), or ec (Elemental Charge scores)',
+              enum: ['all', 'battles', 'guardian', 'ec']
+            },
+            limit: {
+              type: 'number',
+              description: 'Number of top players per category (default: 10, max: 50)',
+              minimum: 1,
+              maximum: 50
+            }
+          },
+          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
@@ -251,6 +363,532 @@ Last updated: ${new Date(stats.cached_at * 1000).toLocaleString()}`;
         ],
       };
 
+    case 'legends_leaderboard_current':
+      try {
+        const category = request.params.arguments?.category || 'battles';
+        const limit = request.params.arguments?.limit || 10;
+        const response = await fetch(`https://api.champz.world/game/spore-trainer/public-leaderboard?type=current&category=${category}&limit=${limit}`);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error(data.error || 'Failed to fetch current cycle leaderboard');
+        }
+
+        let output = '';
+        const cycleInfo = `Cycle #${data.cycle_id} (${data.cycle_key}) - Ends: ${new Date(data.ends_at * 1000).toLocaleString()}\n`;
+
+        if (category === 'battles') {
+          output = `🏆 Legends of Champz - Current Cycle Battle Leaderboard\n\n`;
+          output += cycleInfo;
+          output += `Active Players: ${data.total_players.toLocaleString()}\n\n`;
+          output += `Top ${data.showing_top} Players:\n\n`;
+
+          data.leaderboard.forEach((player, index) => {
+            const tierEmoji = player.tier_emoji || '';
+            const name = player.display_name || `${player.wallet.slice(0, 6)}...${player.wallet.slice(-4)}`;
+            const winRate = player.win_rate.toFixed(1);
+            const record = `${player.wins}W-${player.losses}L`;
+
+            output += `${index + 1}. ${tierEmoji} ${name}\n`;
+            output += `   ${record} (${winRate}% win rate)`;
+            if (player.streak > 0) {
+              output += ` 🔥 ${player.streak} streak`;
+            }
+            output += `\n`;
+            if (player.rarity) {
+              output += `   ${player.rarity.charAt(0).toUpperCase() + player.rarity.slice(1)} • ${player.elements.join('/')}\n`;
+            }
+            output += `\n`;
+          });
+        } else if (category === 'guardian') {
+          output = `👑 Legends of Champz - Current Cycle Guardian (Throne) Leaderboard\n\n`;
+          output += cycleInfo;
+          output += `Current Guardian: ${data.current_guardian ? data.current_guardian.slice(0, 6) + '...' : 'None'}\n`;
+          output += `Prize Pool: ${data.prize_pool.toLocaleString()} CHAMPZ\n\n`;
+          output += `Top ${data.showing_top} Guardian Holders:\n\n`;
+
+          data.leaderboard.forEach((player) => {
+            const tierEmoji = player.tier_emoji || '';
+            const name = player.display_name || `${player.wallet.slice(0, 6)}...${player.wallet.slice(-4)}`;
+            const crown = player.is_current ? '👑 ' : '';
+
+            output += `${player.rank}. ${crown}${tierEmoji} ${name}\n`;
+            output += `   Held ${player.times_held}x • Sent ${player.total_sent.toLocaleString()} CHAMPZ\n\n`;
+          });
+        } else if (category === 'ec') {
+          output = `⚡ Legends of Champz - Current Cycle Elemental Charge Leaderboard\n\n`;
+          output += cycleInfo;
+          output += `Top ${data.showing_top} High Scores:\n\n`;
+
+          data.leaderboard.forEach((player) => {
+            const tierEmoji = player.tier_emoji || '';
+            const name = player.display_name || `${player.wallet.slice(0, 6)}...${player.wallet.slice(-4)}`;
+
+            output += `${player.rank}. ${tierEmoji} ${name}\n`;
+            output += `   Score: ${player.best_score} • Rounds: ${player.best_rounds} • Streak: ${player.best_streak}\n\n`;
+          });
+        }
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: output,
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Error fetching current cycle leaderboard: ${error.message}`,
+            },
+          ],
+        };
+      }
+
+    case 'legends_leaderboard_weekly':
+      try {
+        const category = request.params.arguments?.category || 'battles';
+        const limit = request.params.arguments?.limit || 10;
+        const response = await fetch(`https://api.champz.world/game/spore-trainer/public-leaderboard?type=weekly&category=${category}&limit=${limit}`);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error(data.error || 'Failed to fetch weekly leaderboard');
+        }
+
+        let output = '';
+        const weekInfo = `Week ${data.week_number} (Cycles ${data.week_start_cycle}-${data.week_end_cycle})\nCurrent Cycle: ${data.current_cycle} | Cycles Remaining: ${data.cycles_remaining}\n`;
+
+        if (category === 'battles') {
+          output = `💰 Legends of Champz - Weekly Battle Leaderboard\n\n`;
+          output += weekInfo;
+          output += `Total Prize Pool: $${data.total_pool_usdc} USDC\n`;
+          output += `Active Players: ${data.total_players.toLocaleString()}\n\n`;
+          output += `Top ${data.showing_top} Players:\n\n`;
+
+          data.leaderboard.forEach((player, index) => {
+            const tierEmoji = player.tier_emoji || '';
+            const name = player.display_name || `${player.wallet.slice(0, 6)}...${player.wallet.slice(-4)}`;
+            const winRate = player.win_rate.toFixed(1);
+            const record = `${player.wins}W-${player.losses}L`;
+            const reward = player.usdc_reward > 0 ? ` 💵 $${player.usdc_reward.toFixed(2)}` : '';
+
+            output += `${index + 1}. ${tierEmoji} ${name}\n`;
+            output += `   ${record} in ${player.battles} battles (${winRate}% WR)${reward}\n\n`;
+          });
+        } else if (category === 'guardian') {
+          output = `👑 Legends of Champz - Weekly Guardian (Throne) Leaderboard\n\n`;
+          output += weekInfo;
+          output += `\nTop ${data.showing_top} Guardian Competitors:\n\n`;
+
+          data.leaderboard.forEach((player) => {
+            const tierEmoji = player.tier_emoji || '';
+            const name = player.display_name || `${player.wallet.slice(0, 6)}...${player.wallet.slice(-4)}`;
+
+            output += `${player.rank}. ${tierEmoji} ${name}\n`;
+            output += `   ${player.cycles_participated} cycles • ${player.total_sends} sends • ${player.total_sent.toLocaleString()} CHAMPZ\n\n`;
+          });
+        }
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: output,
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Error fetching weekly leaderboard: ${error.message}`,
+            },
+          ],
+        };
+      }
+
+    case 'legends_leaderboard_alltime':
+      try {
+        const category = request.params.arguments?.category || 'all';
+        const limit = request.params.arguments?.limit || 10;
+        const response = await fetch(`https://api.champz.world/game/spore-trainer/public-leaderboard?type=alltime&category=${category}&limit=${limit}`);
+        const data = await response.json();
+
+        if (!data.success) {
+          throw new Error(data.error || 'Failed to fetch all-time leaderboards');
+        }
+
+        const boards = data.leaderboards;
+        let output = `🏅 Legends of Champz - All-Time Leaderboards`;
+        if (category !== 'all') {
+          output += ` (${category.toUpperCase()})`;
+        }
+        output += `\n\n`;
+
+        // Define categories to display based on what's available
+        const allCategories = [
+          { key: 'champz_earned', title: '💰 Most CHAMPZ Earned', format: (v) => `${(v / 1000000).toFixed(2)}M` },
+          { key: 'usdc_earned', title: '💵 Most USDC Earned', format: (v) => `$${v.toFixed(2)}` },
+          { key: 'champz_spent', title: '🔥 Most CHAMPZ Spent', format: (v) => `${(v / 1000000).toFixed(2)}M` },
+          { key: 'total_wins', title: '⚔️ Most Total Wins', format: (v) => v.toLocaleString() },
+          { key: 'win_rate', title: '🎯 Highest Win Rate (100+ battles)', format: (v) => `${v.toFixed(1)}%` },
+          { key: 'longest_streak', title: '🔥 Longest Win Streak', format: (v) => `${v} wins` },
+          { key: 'guardian_wins', title: '👑 Most Guardian (Throne) Wins', format: (v) => v },
+          { key: 'ec_best_score', title: '⚡ Best EC Score', format: (v) => v },
+          { key: 'ec_total_rounds', title: '⚡ Most EC Rounds Completed', format: (v) => v.toLocaleString() },
+          { key: 'ec_games_played', title: '⚡ Most EC Games Played', format: (v) => v },
+        ];
+
+        allCategories.forEach(cat => {
+          const board = boards[cat.key];
+          if (board && board.length > 0) {
+            output += `${cat.title}\n`;
+            board.slice(0, 3).forEach((player, i) => {
+              const name = player.display_name || `${player.wallet.slice(0, 6)}...`;
+              const value = cat.format(player.value);
+              output += `  ${i + 1}. ${name} - ${value}`;
+              if (player.battles) {
+                output += ` (${player.wins}/${player.battles})`;
+              }
+              output += `\n`;
+            });
+            output += `\n`;
+          }
+        });
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: output,
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Error fetching all-time leaderboards: ${error.message}`,
+            },
+          ],
+        };
+      }
+
+    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 = '';
+
+          data.thrones.forEach((throne, i) => {
+            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}`;
+            content.push({
+              type: 'image',
+              data: imageUrl,
+              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 = '';
+
+          data.saved_trainers.forEach((trainer, i) => {
+            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}`;
+            content.push({
+              type: 'image',
+              data: imageUrl,
+              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`;
+
+        // Return with image
+        const imageUrl = `https://img.champz.world${legend.image_path}`;
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: output,
+            },
+            {
+              type: 'image',
+              data: imageUrl,
+              mimeType: 'image/png',
+            },
+          ],
+        };
+      } 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`;
+
+        // Return with image
+        const imageUrl = `https://img.champz.world${throne.image_path}`;
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: output,
+            },
+            {
+              type: 'image',
+              data: imageUrl,
+              mimeType: 'image/png',
+            },
+          ],
+        };
+      } 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.1.2",
-  "description": "MCP server for Legends of Champz - Query game stats and claim rewards through Claude Desktop",
+  "version": "1.3.2",
+  "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": {