Discord MCP server Let your AI agent run your Discord community.

ToolWhat it doesAccess

• list_servers Discord servers you are a member of, with your roles and unread state. read

  Returns the servers in your server list, in the order Discord shows them. Each entry has the server name, the id to pass as server to the other tools and the name of your highest role. unread is true when the server has unread messages in unmuted channels. It does not list servers you have not joined.

  MCP calldiscord_read → list_servers

  REST endpointGET https://cotlet.dev/api/v1/discord/servers

  Parameters

  No parameters.

  Example response

  {
    "servers": [
      {
        "server_id": "1058204419337711702",
        "name": "Landing Page Lab",
        "highest_role": "Moderator",
        "unread": true
      },
      {
        "server_id": "1041930587712340066",
        "name": "Indie Makers",
        "highest_role": "Member",
        "unread": false
      }
    ]
  }

• list_channels Text channels, threads and forum channels of a server that you can see. read

  Lists the channels of one server in the order of the sidebar, grouped by category. Only channels your account can see are returned. type is text, forum or thread. Use channel_id as channel in list_messages and send_message. Private channels you cannot open are not shown.

  MCP calldiscord_read → list_channels

  REST endpointGET https://cotlet.dev/api/v1/discord/channels

  Parameters

  Parameters: list_channels

  Name	Type	Description
  server string required	string	Server id from list_servers.
  type enum	enum	all, text, forum or thread. Default: all.

  Example input

  {
    "server": "server"
  }

  Example response

  {
    "channels": [
      {
        "channel_id": "1058204419337711800",
        "name": "general",
        "category": "Community",
        "type": "text"
      },
      {
        "channel_id": "1058204419337711811",
        "name": "help",
        "category": "Community",
        "type": "forum"
      },
      {
        "channel_id": "1058204419337711822",
        "name": "weekly-recap",
        "category": "Community",
        "type": "text"
      }
    ]
  }

• list_messages Recent messages of a channel, thread or DM, newest first, with author, text and reactions. read

  Returns messages of one channel you can open, newest first, a page at a time; pass next_cursor back as cursor for older ones. Each message has its id, the author, the text, the time, the number of replies in its thread and the reactions. replied is true when a later message in the channel is a reply to it. Messages you cannot see in the app are not returned.

  MCP calldiscord_read → list_messages

  REST endpointGET https://cotlet.dev/api/v1/discord/messages

  Parameters

  Parameters: list_messages

  Name	Type	Description
  channel string required	string	Channel, thread or DM id from list_channels or list_direct_conversations.
  since date	date	Only messages sent on or after this date.
  limit integer	integer	Messages per page. Default: 50.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "channel": "channel"
  }

  Example response

  {
    "messages": [
      {
        "message_id": "1190466022837014528",
        "author": "tom.becker",
        "text": "Does anyone have a template for a pricing page?",
        "sent_at": "2026-11-04T16:12:00.000000Z",
        "thread_replies": 0,
        "replied": false,
        "reactions": [
          {
            "emoji": "👀",
            "count": 2
          }
        ]
      },
      {
        "message_id": "1190431876100952064",
        "author": "maria.silva",
        "text": "Shipped my first landing page today.",
        "sent_at": "2026-11-04T10:41:00.000000Z",
        "thread_replies": 3,
        "replied": true,
        "reactions": [
          {
            "emoji": "🎉",
            "count": 5
          }
        ]
      }
    ],
    "next_cursor": "1190431876100952064"
  }

• search_messages Search a server or DM with the same filters as the Discord search bar. read

  Runs the search box of Discord for one server or one DM. query is the text to find. from, in, mentions and has work like the from:, in:, mentions: and has: shortcuts of the search bar. Results show the channel, the author and the message text. Discord searches the server or DM you name, not all your servers at once.

  MCP calldiscord_read → search_messages

  REST endpointGET https://cotlet.dev/api/v1/discord/messages/search

  Parameters

  Parameters: search_messages

  Name	Type	Description
  server string	string	Server id to search. Use this or dm.
  dm string	string	DM conversation id to search. Use this or server.
  query string required	string	Text to find.
  from string	string	Only messages by this username.
  in string	string	Only messages in this channel name.
  mentions string	string	Only messages that mention this username.
  has enum	enum	link, embed, image, video or sound.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "results": [
      {
        "message_id": "1189022840016593920",
        "channel": "general",
        "author": "tom.becker",
        "text": "My pricing page converts better with three plans than two.",
        "sent_at": "2026-10-29T09:03:00.000000Z"
      }
    ]
  }

• list_members Members of a server with roles and join date, newest first. read

  Lists the members of one server that your account can see in the member list, newest joiners first, a page at a time. Each member has the username, the display name, the roles and joined_at. member_id goes to assign_role and timeout_member. Large servers show only part of the member list to members without moderator permissions.

  MCP calldiscord_read → list_members

  REST endpointGET https://cotlet.dev/api/v1/discord/members

  Parameters

  Parameters: list_members

  Name	Type	Description
  server string required	string	Server id from list_servers.
  joined_since date	date	Only members who joined on or after this date.
  role string	string	Only members with this role name.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "server": "server"
  }

  Example response

  {
    "members": [
      {
        "member_id": "1161738420995301376",
        "username": "ana.lopez",
        "display_name": "Ana Lopez",
        "roles": [
          "Member"
        ],
        "joined_at": "2026-11-04T18:21:00.000000Z"
      }
    ],
    "next_cursor": "1161738420995301376"
  }

ToolWhat it doesAccess

• list_mentions The Mentions tab of your Inbox: messages that mention you, across your servers and DMs. read

  Returns the items of the Mentions tab in your Discord Inbox, newest first. Each item has the server, the channel, the author and the message. include_everyone and include_roles switch on the @everyone and @role mentions, as the filter button of the tab does. Reading does not remove items from the Inbox.

  MCP calldiscord_read → list_mentions

  REST endpointGET https://cotlet.dev/api/v1/discord/mentions

  Parameters

  Parameters: list_mentions

  Name	Type	Description
  include_everyone boolean	boolean	Include @everyone mentions. Default: false.
  include_roles boolean	boolean	Include @role mentions. Default: false.
  since date	date	Only mentions on or after this date.

  Example response

  {
    "mentions": [
      {
        "message_id": "1190466022837014528",
        "server": "Landing Page Lab",
        "channel": "help",
        "author": "tom.becker",
        "text": "@maya can you look at my pricing page?",
        "sent_at": "2026-11-04T16:12:00.000000Z"
      }
    ]
  }

• list_direct_conversations Your direct messages and group DMs, most recent first, with the last message. read

  Lists the conversations in your Direct Messages list, the most recent first. Each has the people in it, the id to use as channel in list_messages or dm in search_messages, and the last message. unread is true when you have not read it. Reading does not mark a conversation as read.

  MCP calldiscord_read → list_direct_conversations

  REST endpointGET https://cotlet.dev/api/v1/discord/direct-conversations

  Parameters

  Parameters: list_direct_conversations

  Name	Type	Description
  unread_only boolean	boolean	Only conversations with unread messages. Default: false.

  Example response

  {
    "conversations": [
      {
        "dm_id": "1171290365844979712",
        "with": [
          "ana.lopez"
        ],
        "last_message": "Thanks, I will send the draft tomorrow.",
        "unread": true
      }
    ]
  }

• send_direct_message Send a direct message to a person from your account. writeasks first

  Sends a DM from your account to one user, in the existing conversation or in a new one. The person is notified. Discord can refuse a DM when the person has turned off messages from server members, and the call then fails with the reason. By default you confirm each call; you can switch that off for this tool.

  MCP calldiscord_write → send_direct_message

  REST endpointPOST https://cotlet.dev/api/v1/discord/direct-messages

  Parameters

  Parameters: send_direct_message

  Name	Type	Description
  user string	string	Username of the person. Use this or dm.
  dm string	string	Existing DM conversation id. Use this or user.
  content string required	string	Message text.

  Example input

  {
    "content": "content"
  }

  Example response

  {
    "message_id": "1190620017733128192",
    "status": "sent",
    "to": "ana.lopez",
    "sent_at": "2026-11-05T07:10:00.000000Z"
  }

ToolWhat it doesAccess

• send_message Post a message in a channel or thread as you. writeasks first

  Posts text in one channel or thread that your account can write in. The message appears under your name and everyone in the channel sees it. It returns the message id and link. It fails if your role cannot post in that channel. By default you confirm each call; you can switch that off for this tool.

  MCP calldiscord_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/discord/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  channel string required	string	Channel or thread id from list_channels.
  content string required	string	Message text. Discord markdown works.

  Example input

  {
    "channel": "1058204419337711822",
    "content": "Weekly recap: 3 landing pages shipped, pricing page template pinned in #help."
  }

  Example response

  {
    "message_id": "1190602918442721280",
    "status": "sent",
    "channel": "weekly-recap",
    "url": "https://discord.com/channels/1058204419337711702/1058204419337711822/1190602918442721280",
    "sent_at": "2026-11-05T07:00:00.000000Z"
  }

• reply_to_message Reply to one message in a channel, thread or DM as you. writeasks first

  Posts a reply that points at one message, so Discord shows the quote above it. The author of the message is notified. It works in channels, threads and DMs you can write in. It returns the id and link of the reply. By default you confirm each call; you can switch that off for this tool.

  MCP calldiscord_write → reply_to_message

  REST endpointPOST https://cotlet.dev/api/v1/discord/messages/{message_id}/replies

  Parameters

  Parameters: reply_to_message

  Name	Type	Description
  channel string required	string	Channel, thread or DM id.
  message_id string required	string	Id of the message to reply to.
  content string required	string	Reply text.

  Example input

  {
    "channel": "channel",
    "message_id": "message_8c41d2",
    "content": "content"
  }

  Example response

  {
    "message_id": "1190611204497309696",
    "status": "sent",
    "reply_to": "1190466022837014528",
    "sent_at": "2026-11-05T07:05:00.000000Z"
  }

• add_reaction React to a message with an emoji as you. writeasks first

  Adds your reaction to one message. Everyone who sees the message sees the reaction and the author may be notified. Adding the same emoji twice changes nothing. By default you confirm each call; you can switch that off for this tool.

  MCP calldiscord_write → add_reaction

  REST endpointPOST https://cotlet.dev/api/v1/discord/messages/{message_id}/reactions

  Parameters

  Parameters: add_reaction

  Name	Type	Description
  channel string required	string	Channel, thread or DM id.
  message_id string required	string	Id of the message.
  emoji string required	string	A standard emoji such as 🎉.

  Example input

  {
    "channel": "channel",
    "message_id": "message_8c41d2",
    "emoji": "emoji"
  }

  Example response

  {
    "message_id": "1190431876100952064",
    "emoji": "🎉",
    "status": "added"
  }

• pin_message Pin a message in a channel. Needs the Pin Messages permission in that channel. writeasks first

  Pins one message so it shows in the pinned messages of the channel, where every member can see it. Discord posts a notice in the channel that you pinned it. It fails if your role cannot pin messages there. By default you confirm each call; you can switch that off for this tool.

  MCP calldiscord_write → pin_message

  REST endpointPOST https://cotlet.dev/api/v1/discord/messages/{message_id}/pin

  Parameters

  Parameters: pin_message

  Name	Type	Description
  channel string required	string	Channel or thread id.
  message_id string required	string	Id of the message to pin.

  Example input

  {
    "channel": "channel",
    "message_id": "message_8c41d2"
  }

  Example response

  {
    "message_id": "1190602918442721280",
    "channel": "weekly-recap",
    "status": "pinned"
  }

ToolWhat it doesAccess

• assign_role Give a member a role in a server. Needs the Manage Roles permission. writeasks first

  Adds one role to one member, the same as picking the role in the member list. The member sees the role and what it unlocks, and the role may open channels for them. It fails if your account lacks Manage Roles or the role sits above your highest role. By default you confirm each call; you can switch that off for this tool.

  MCP calldiscord_write → assign_role

  REST endpointPOST https://cotlet.dev/api/v1/discord/members/{member_id}/role/assign

  Parameters

  Parameters: assign_role

  Name	Type	Description
  server string required	string	Server id from list_servers.
  member_id string required	string	Member id from list_members.
  role string required	string	Role name, as in Server Settings > Roles.

  Example input

  {
    "server": "server",
    "member_id": "member_8c41d2",
    "role": "role"
  }

  Example response

  {
    "member_id": "1161738420995301376",
    "role": "Member",
    "status": "assigned"
  }

• timeout_member Put a member on time out in a server. Needs the Time Out Members permission. writeasks first

  Puts one member on time out for the number of minutes you give. A timed-out member can still see and read channels but cannot post. The member is affected at once and sees it. It fails if your account lacks the permission or the member has an equal or higher role. By default you confirm each call; you can switch that off for this tool.

  MCP calldiscord_write → timeout_member

  REST endpointPOST https://cotlet.dev/api/v1/discord/members/{member_id}/timeout

  Parameters

  Parameters: timeout_member

  Name	Type	Description
  server string required	string	Server id from list_servers.
  member_id string required	string	Member id from list_members.
  minutes integer required	integer	Length of the time out in minutes.
  reason string	string	Reason for the moderation log.

  Example input

  {
    "server": "server",
    "member_id": "member_8c41d2",
    "minutes": 1
  }

  Example response

  {
    "member_id": "1161738420995301376",
    "status": "timed_out",
    "minutes": 60
  }