​
Prerequisites

To get the most out of this guide, you’ll need to:

​
1. Create a Discord MCP Server

Use the following endpoint to create a new remote Discord MCP server instance:

​
Request

curl --request POST \
  --url https://api.klavis.ai/mcp-server/instance/create \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "serverName": "Discord",
  "userId": "<YOUR_USER_ID>",
  "platformName": "<YOUR_PLATFORM_NAME>"
}'

​
Response

{
  "serverUrl": "https://discord-mcp-server.klavis.ai/sse?instance_id=<instance-id>",
  "instanceId": "<instance-id>"
}
serverUrl specifies the endpoint of the Discord MCP server, which allows you to interact with Discord servers and channels.
instanceId is used to get an authentication token. After you complete the OAuth flow, this token allows the MCP server to access Discord on your behalf.

​
2. Discord Bot Setup

To enable your MCP server to access Discord, you need to set up a Discord bot and authenticate it.

​
Option 1: API Call

curl --request GET \
  --url 'https://api.klavis.ai/oauth/discord/authorize?instance_id=<YOUR_INSTANCE_ID>'

​
Option 2: Browser Redirect

Simply copy and paste the following URL into your web browser, replacing <YOUR_INSTANCE_ID> with your actual instance ID:

https://api.klavis.ai/oauth/discord/authorize?instance_id=<YOUR_INSTANCE_ID>

​
Bot Permissions

When authorizing your bot, you’ll be prompted to select a Discord server. The bot will request the following permissions:

  • Read messages/view channels
  • Send messages
  • Read message history
  • Attach files
  • Embed links

​
Explore MCP Server Tools