get_enhanced_achievement_stats
Read-onlyIdempotent
Retrieve detailed session statistics and achievement progress tracking for the Quake Coding Arena MCP server, including streak data, category breakdowns, and performance metrics.
Instructions
📊 Retrieve comprehensive session statistics and achievement progress. Returns total achievements played, category breakdown, session duration, current voice pack, volume setting, favorite category, current streak, longest streak, and achievements per minute rate.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _dummy | No | No parameters required. This tool returns session statistics without requiring any input. |
Implementation Reference
- src/tools/stats.ts:23-37 (handler)The handler function that executes the tool logic, computing session duration and returning formatted statistics including total achievements, category stats, voice pack, and achievements per minute.
async () => { const sessionMinutes = Math.floor((Date.now() - new Date(enhancedStats.sessionStart).getTime()) / 60000); return { content: [{ type: "text", text: `📊 Enhanced arena statistics retrieved!\nTotal achievements: ${enhancedStats.totalAchievements}\nSession time: ${sessionMinutes} minutes\nCurrent voice: ${enhancedStats.voicePack}` }], stats: { ...enhancedStats, sessionMinutes, achievementsPerMinute: sessionMinutes > 0 ? enhancedStats.totalAchievements / sessionMinutes : 0 } }; } - src/tools/stats.ts:9-22 (schema)The tool's input schema (no required params), description, and annotations defining its behavior and hints.
{ description: "📊 Retrieve comprehensive session statistics and achievement progress. Returns total achievements played, category breakdown, session duration, current voice pack, volume setting, favorite category, current streak, longest streak, and achievements per minute rate.", inputSchema: { // No parameters required for this tool _dummy: z.string().optional().describe("No parameters required. This tool returns session statistics without requiring any input.") }, annotations: { title: "📊 Get Achievement Stats", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false } }, - src/tools/stats.ts:7-38 (registration)The MCP server.registerTool invocation that registers 'get_enhanced_achievement_stats' with its schema and handler function.
server.registerTool( "get_enhanced_achievement_stats", { description: "📊 Retrieve comprehensive session statistics and achievement progress. Returns total achievements played, category breakdown, session duration, current voice pack, volume setting, favorite category, current streak, longest streak, and achievements per minute rate.", inputSchema: { // No parameters required for this tool _dummy: z.string().optional().describe("No parameters required. This tool returns session statistics without requiring any input.") }, annotations: { title: "📊 Get Achievement Stats", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false } }, async () => { const sessionMinutes = Math.floor((Date.now() - new Date(enhancedStats.sessionStart).getTime()) / 60000); return { content: [{ type: "text", text: `📊 Enhanced arena statistics retrieved!\nTotal achievements: ${enhancedStats.totalAchievements}\nSession time: ${sessionMinutes} minutes\nCurrent voice: ${enhancedStats.voicePack}` }], stats: { ...enhancedStats, sessionMinutes, achievementsPerMinute: sessionMinutes > 0 ? enhancedStats.totalAchievements / sessionMinutes : 0 } }; } ); - src/index.ts:58-58 (registration)Invocation of registerStatsTools in the main MCP server setup (src/index.ts), which registers the tool.
registerStatsTools(server); - run-server.ts:33-33 (registration)Invocation of registerStatsTools in the stdio server entry point (run-server.ts), which registers the tool.
registerStatsTools(server);