Warden MCP Server

Instructions

Implementation Reference

• src/tools/registerTools.ts:206-242 (handler)

  Registration and handler implementation for the keychain_generate_username tool.

  registerTool(
    `${deps.toolPrefix}.generate_username`,
    {
      title: 'Generate Username',
      description:
        'Generate a username like the Bitwarden generator (random word, plus-addressed email, catch-all). Returning the value requires reveal=true.',
      annotations: { readOnlyHint: true },
      inputSchema: {
        type: z
          .enum([
            'random_word',
            'plus_addressed_email',
            'catch_all_email',
            'forwarded_email_alias',
          ])
          .optional(),
        capitalize: z.boolean().optional(),
        includeNumber: z.boolean().optional(),
        email: z.string().optional(),
        domain: z.string().optional(),
        reveal: z.boolean().optional(),
      },
      _meta: toolMeta,
    },
    async (input, extra) => {
      const sdk = await deps.getSdk(extra.authInfo);
      const result = await sdk.generateUsername(clampReveal(input));
      return {
        structuredContent: toolResult(
          'generated',
          result.value,
          result.revealed,
        ),
        content: [{ type: 'text', text: 'OK' }],
      };
    },
  );