discord-mcp

Instructions

Implementation Reference

• src/tools/audit-tools.ts:144-169 (handler)

  Executes the tool logic: fetches the auto-moderation rule by guildId and ruleId using Discord client, processes the data, handles errors with withErrorHandling, and returns JSON stringified response.

  async ({ guildId, ruleId }) => {
    const result = await withErrorHandling(async () => {
      const client = await getDiscordClient();
      const guild = await client.guilds.fetch(guildId);
      const rule = await guild.autoModerationRules.fetch(ruleId);
  
      return {
        id: rule.id,
        name: rule.name,
        enabled: rule.enabled,
        eventType: rule.eventType,
        triggerType: rule.triggerType,
        triggerMetadata: rule.triggerMetadata,
        actions: rule.actions,
        exemptRoles: rule.exemptRoles.map((r) => ({ id: r.id, name: r.name })),
        exemptChannels: rule.exemptChannels.map((c) => ({ id: c.id, name: c.name })),
        creatorId: rule.creatorId,
      };
    });
  
    if (!result.success) {
      return { content: [{ type: 'text', text: result.error }], isError: true };
    }
  
    return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
  }

• src/tools/audit-tools.ts:140-143 (schema)

  Input schema using Zod for validating guildId and ruleId parameters.

  {
    guildId: z.string().describe('The ID of the server (guild)'),
    ruleId: z.string().describe('The ID of the rule'),
  },

• src/tools/audit-tools.ts:137-170 (registration)

  Registers the 'get_automod_rule' tool on the MCP server with name, description, input schema, and handler function inside registerAuditTools.

  server.tool(
    'get_automod_rule',
    'Get details of a specific auto-moderation rule',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
      ruleId: z.string().describe('The ID of the rule'),
    },
    async ({ guildId, ruleId }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const rule = await guild.autoModerationRules.fetch(ruleId);
  
        return {
          id: rule.id,
          name: rule.name,
          enabled: rule.enabled,
          eventType: rule.eventType,
          triggerType: rule.triggerType,
          triggerMetadata: rule.triggerMetadata,
          actions: rule.actions,
          exemptRoles: rule.exemptRoles.map((r) => ({ id: r.id, name: r.name })),
          exemptChannels: rule.exemptChannels.map((c) => ({ id: c.id, name: c.name })),
          creatorId: rule.creatorId,
        };
      });
  
      if (!result.success) {
        return { content: [{ type: 'text', text: result.error }], isError: true };
      }
  
      return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
    }
  );

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

  Calls registerAuditTools to register all audit tools including get_automod_rule on the MCP server instance.

  registerAuditTools(server);