AGA-mcp-server

Instructions

Implementation Reference

• src/tools/set-verification-tier.ts:22-37 (handler)

  The handler function that executes the 'aga_set_verification_tier' tool, updating the verification tier in the server context and returning metadata.

  export async function handleSetVerificationTier(args: SetVerificationTierArgs, ctx: ServerContext) {
    const validTiers = ['BRONZE', 'SILVER', 'GOLD'] as const;
    if (!validTiers.includes(args.tier as any)) {
      return ctx.error(`Invalid tier: ${args.tier}. Must be BRONZE, SILVER, or GOLD.`);
    }
    const previousTier = ctx.verificationTier;
    ctx.verificationTier = args.tier;
    const info = TIER_DESCRIPTIONS[args.tier];
    return ctx.json({
      success: true,
      previous_tier: previousTier,
      current_tier: ctx.verificationTier,
      description: info.description,
      trust_assumption: info.trust_assumption,
    });
  }

• src/tools/set-verification-tier.ts:3-5 (schema)

  The interface defining the input arguments for the tool.

  export interface SetVerificationTierArgs {
    tier: 'BRONZE' | 'SILVER' | 'GOLD';
  }

• src/server.ts:266-273 (registration)

  The registration of the tool within the MCP server setup.

  // 16. aga_set_verification_tier (ungoverned)
  server.tool('aga_set_verification_tier',
    'Set the verification tier (BRONZE, SILVER, GOLD).',
    {
      tier: z.enum(['BRONZE', 'SILVER', 'GOLD']),
    },
    async (args) => handleSetVerificationTier(args, ctx),
  );