@champz-llc/legends-mcp-server 1.8.0 → 1.8.1

package/index.js

@@ -295,6 +295,20 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           },
           required: []
         },
+      },
+      {
+        name: 'legends_game_guide',
+        description: 'Get comprehensive game guide information about Legends of Champz. Use this tool when users ask about game mechanics, how to play, strategies, features, or any game-related questions. Covers: battles, elements, Guardian, Elemental Charge, AI Magistrate, rewards, achievements, tiers, AP system, and pro tips.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            topic: {
+              type: 'string',
+              description: 'Optional: specific topic to search for (e.g., "elemental charge", "AI magistrate", "guardian", "battles", "achievements"). If not provided, returns overview.',
+            }
+          },
+          required: []
+        },
       }
     ];
 
@@ -1460,6 +1474,86 @@ You can still ask about:
         };
       }
 
+    case 'legends_game_guide':
+      try {
+        const docPath = join(__dirname, 'docs', 'game-guide.md');
+        const fullGuide = readFileSync(docPath, 'utf-8');
+
+        const topic = request.params.arguments?.topic;
+
+        if (!topic) {
+          // Return full guide overview
+          return {
+            content: [
+              {
+                type: 'text',
+                text: fullGuide,
+              },
+            ],
+          };
+        }
+
+        // Search for specific topic (case-insensitive)
+        const topicLower = topic.toLowerCase();
+        const lines = fullGuide.split('\n');
+        let relevantSection = '';
+        let inRelevantSection = false;
+        let sectionDepth = 0;
+
+        for (let i = 0; i < lines.length; i++) {
+          const line = lines[i];
+          const lineLower = line.toLowerCase();
+
+          // Check if this line is a header that matches our topic
+          if (line.startsWith('#')) {
+            const headerLevel = line.match(/^#+/)[0].length;
+
+            if (lineLower.includes(topicLower)) {
+              inRelevantSection = true;
+              sectionDepth = headerLevel;
+              relevantSection = line + '\n';
+            } else if (inRelevantSection && headerLevel <= sectionDepth) {
+              // Hit a same-level or higher-level header, section ended
+              break;
+            }
+          }
+
+          if (inRelevantSection) {
+            relevantSection += line + '\n';
+          }
+        }
+
+        if (relevantSection) {
+          return {
+            content: [
+              {
+                type: 'text',
+                text: `Found relevant section about "${topic}":\n\n${relevantSection}`,
+              },
+            ],
+          };
+        } else {
+          // Topic not found, return full guide
+          return {
+            content: [
+              {
+                type: 'text',
+                text: `Topic "${topic}" not found in specific section. Here's the complete game guide:\n\n${fullGuide}`,
+              },
+            ],
+          };
+        }
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Error reading game guide: ${error.message}`,
+            },
+          ],
+        };
+      }
+
     case 'show_throne':
       if (!hasWalletAuth) {
         return {

package/package.json

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