🍄 Legends of Champz MCP Server

Query game stats and manage rewards through Claude Desktop using Model Context Protocol

Built for Legends of Champz - a blockchain-based battle game on Base L2.

✨ Features

• 📊 Global Game Statistics - Real-time stats (legends rolled, CHAMPZ burned, battles, rewards)
• 💰 Reward Checking - Check claimable CHAMPZ and USDC rewards
• ⚡ Base L2 Integration - Execute on-chain claims via smart contracts
• 🤖 Conversational Interface - Natural language queries through Claude Desktop

🚀 Installation

Option 1: Global Install (Recommended)

npm install -g @champz-llc/legends-mcp-server

Option 2: Use with npx (No installation)

npx @champz-llc/legends-mcp-server

⚙️ Configuration

Add to your Claude Desktop config file:

Windows (Standard Install): %APPDATA%\Claude\claude_desktop_config.json Windows (Microsoft Store): %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Tip: If you're unsure which version you have, check both locations. The Microsoft Store version has Packages\Claude_ in the path.

{
  "mcpServers": {
    "legends-champz": {
      "command": "npx",
      "args": ["@champz-llc/legends-mcp-server"]
    }
  }
}

Restart Claude Desktop after saving.

📖 Usage Examples

Once configured, you can ask Claude:

Global Statistics

• "What are the global stats for Legends of Champz?"
• "How many legends have been rolled?"
• "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"
• "Show me my USDC rewards"

🛠️ Available Tools

legends_global_stats

Get real-time global game statistics.

Returns:

• Legends rolled
• Thrones claimed
• CHAMPZ earned/spent/burned
• USDC distributed
• Total battles
• Battles today

check_legends_rewards

Check claimable rewards (demo data).

get_champz_claim_data

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

# Clone repository
git clone https://github.com/champz/legends-mcp-server.git
cd legends-mcp-server

# Install dependencies
npm install

# Run locally
npm start

🎮 About Legends of Champz

Legends of Champz is a blockchain-based battle game on Base L2 featuring:

• 20,000 unique mushroom warrior NFTs
• Ghost PvP battles with point-based resolution
• Guardian king-of-the-hill mechanics
• CHAMPZ token + USDC rewards
• Cycle-based gameplay (12-hour cycles)

Play now: https://legends.champz.world

🔗 Links

• Game: https://legends.champz.world
• Base MCP: https://mcp.base.org
• Contest: BuildOnBase X (Twitter)

📄 License

MIT - Created for Base MCP demo contest