Quake Coding Arena MCP

Instructions

Implementation Reference

• src/tools/settings.ts:22-32 (handler)

  The core handler function for the 'set_enhanced_volume' tool. It takes a volume parameter, updates the global enhancedStats.volume, and returns a text response confirming the change along with the new volume value.

  async ({ volume }) => {
      enhancedStats.volume = volume;
  
      return {
          content: [{
              type: "text",
              text: `🔊 Enhanced volume set to ${volume}%`
          }],
          volume: enhancedStats.volume
      };
  }

• src/tools/settings.ts:7-33 (registration)

  Registration of the 'set_enhanced_volume' tool on the MCP server, including detailed description, Zod-based input schema for volume (0-100), annotations, and the handler function.

  server.registerTool(
      "set_enhanced_volume",
      {
          description: "🔊 Adjust the global soundboard volume for all achievement sounds. This setting persists for the session and affects all subsequent audio playback until changed. Volume range is 0-100, where 0 is silent and 100 is maximum volume.",
          inputSchema: {
              volume: z.number().min(0).max(100).describe("🔊 Volume level (0-100). 0 = silent, 100 = maximum volume. Default is 80. This setting applies to all achievement sounds until changed. Examples: 50, 75, 80, 100"),
          },
          annotations: {
              title: "🔊 Set Volume",
              readOnlyHint: false,
              destructiveHint: false,
              idempotentHint: false,
              openWorldHint: false
          }
      },
      async ({ volume }) => {
          enhancedStats.volume = volume;
  
          return {
              content: [{
                  type: "text",
                  text: `🔊 Enhanced volume set to ${volume}%`
              }],
              volume: enhancedStats.volume
          };
      }
  );

• src/tools/settings.ts:11-13 (schema)

  The input schema definition using Zod for validating the 'volume' parameter as a number between 0 and 100.

  inputSchema: {
      volume: z.number().min(0).max(100).describe("🔊 Volume level (0-100). 0 = silent, 100 = maximum volume. Default is 80. This setting applies to all achievement sounds until changed. Examples: 50, 75, 80, 100"),
  },

• src/index.ts:57-57 (registration)

  Call to registerSettingsTools in the main server setup, which includes the set_enhanced_volume tool registration.

  registerSettingsTools(server);