mcp-discord

Instructions

Implementation Reference

• src/discord_mcp/server.py:433-458 (handler)

  Handler that fetches the message, deletes it with the given reason, and optionally times out the message author for the specified number of minutes.

  elif name == "moderate_message":
      channel = await discord_client.fetch_channel(int(arguments["channel_id"]))
      message = await channel.fetch_message(int(arguments["message_id"]))
      
      # Delete the message
      await message.delete(reason=arguments["reason"])
      
      # Handle timeout if specified
      if "timeout_minutes" in arguments and arguments["timeout_minutes"] > 0:
          if isinstance(message.author, discord.Member):
              duration = discord.utils.utcnow() + datetime.timedelta(
                  minutes=arguments["timeout_minutes"]
              )
              await message.author.timeout(
                  duration,
                  reason=arguments["reason"]
              )
              return [TextContent(
                  type="text",
                  text=f"Message deleted and user timed out for {arguments['timeout_minutes']} minutes."
              )]
      
      return [TextContent(
          type="text",
          text="Message deleted successfully."
      )]

• src/discord_mcp/server.py:327-354 (registration)

  Registers the 'moderate_message' tool in the list_tools() handler, including its description and input schema definition.

  Tool(
      name="moderate_message",
      description="Delete a message and optionally timeout the user",
      inputSchema={
          "type": "object",
          "properties": {
              "channel_id": {
                  "type": "string",
                  "description": "Channel ID containing the message"
              },
              "message_id": {
                  "type": "string",
                  "description": "ID of message to moderate"
              },
              "reason": {
                  "type": "string",
                  "description": "Reason for moderation"
              },
              "timeout_minutes": {
                  "type": "number",
                  "description": "Optional timeout duration in minutes",
                  "minimum": 0,
                  "maximum": 40320  # Max 4 weeks
              }
          },
          "required": ["channel_id", "message_id", "reason"]
      }
  ),