Discord MCP

https://github.com/yosefhayim/discord-mcp
Admin
Discord MCP is a Model Context Protocol server that lets AI assistants build and configure Discord...
Tokens:10,522
Snippets:45
Trust Score:4
License:Apache-2.0
Update:7 months ago
Show doc for...
Tokens:
Raw
### Install and Run Discord MCP

Source: https://github.com/yosefhayim/discord-mcp/blob/main/README.md

Commands to install the Discord MCP package globally or run it directly using npx, and the steps to initialize the development environment.

```bash
npm install -g discord-mcp
npx discord-mcp
```

```bash
npm install
npm run setup
npm run dev
```

--------------------------------

### Install and Manage Discord MCP via CLI

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Commands for installing the Discord MCP package globally, running the setup wizard, and managing server configurations via the command line interface.

```bash
npm install -g discord-mcp
npx discord-mcp
discord-mcp setup
npm run dev
discord-mcp check 123456789012345678
```

--------------------------------

### MCP Client Configuration for Claude Desktop

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Configuration snippets for integrating Discord MCP into Claude Desktop. Supports both npx-based execution and globally installed binaries.

```json
{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": ["discord-mcp"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here",
        "DEBUG": "false"
      }
    }
  }
}
```

```json
{
  "mcpServers": {
    "discord-mcp": {
      "command": "discord-mcp",
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here"
      }
    }
  }
}
```

--------------------------------

### Discord Blueprint Schema Example (JSON)

Source: https://github.com/yosefhayim/discord-mcp/blob/main/PLAN.md

Defines the structure of a Discord server blueprint used for provisioning. This JSON schema outlines the metadata, guild settings, roles, categories, channels (including forum channels with tags), and invite configurations. It serves as the input for the `apply_blueprint` tool.

```json
{
  "metadata": { "name": "example-blueprint", "version": "1.0.0" },
  "guild": {
    "name": "My New Server",
    "icon": "base64encodediconstring",
    "settings": {
      "verification_level": "LOW",
      "default_message_notifications": "MENTIONS"
    }
  },
  "roles": [
    { "id": "admin", "name": "Administrator", "permissions": ["ADMINISTRATOR"] },
    { "id": "member", "name": "Member", "permissions": [] }
  ],
  "categories": [
    { "id": "general", "name": "General Channels" },
    { "id": "community", "name": "Community" }
  ],
  "channels": [
    { "id": "general-chat", "type": "text", "name": "general", "parent_id": "general" },
    { "id": "rules", "type": "text", "name": "rules", "parent_id": "general", "topic": "Server Rules" },
    { "id": "feedback", "type": "forum", "name": "Feedback", "parent_id": "community", "forum_tags": [{"name": "Bug Report", "emoji_id": null, "emoji_name": null}, {"name": "Feature Request", "emoji_id": null, "emoji_name": null}] },
    { "id": "announcements", "type": "text", "name": "announcements", "parent_id": "community", "permission_overwrites": [{"type": 0, "id": "@everyone", "deny": ["SEND_MESSAGES"]}] }
  ],
  "invites": [
    { "channel_ref": "general-chat", "max_age": 86400, "max_uses": 5 }
  ]
}
```

--------------------------------

### Retrieve Blueprint Registry via MCP

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Example JSON response for the MCP resource URI 'blueprint://list'. This returns a collection of available server blueprints with their metadata and unique identifiers.

```json
{
  "blueprints": [
    { "name": "startup-team", "version": "1.0.0", "description": "Discord server blueprint for Seed to Series A startup teams", "tags": ["startup", "team", "seed", "series-a"], "uri": "blueprint://startup-team" },
    { "name": "dev-team", "version": "1.0.0", "description": "Minimal Discord server blueprint for development teams", "tags": ["development", "engineering", "minimal"], "uri": "blueprint://dev-team" },
    { "name": "gaming-community", "version": "1.0.0", "description": "Discord server blueprint for gaming communities", "tags": ["gaming", "community", "lfg"], "uri": "blueprint://gaming-community" }
  ],
  "count": 6
}
```

--------------------------------

### Programmatic Discord MCP Usage with TypeScript

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Demonstrates how to initialize the MCP server, validate blueprints, and interact with the Discord API using the discord-mcp library. Requires a valid DISCORD_BOT_TOKEN environment variable for client operations.

```typescript
import { createMCPServer, loadConfig, type AppConfig } from 'discord-mcp';
import { validateBlueprint, fullyValidateBlueprint, type Blueprint } from 'discord-mcp/blueprints/schema';
import { createDiscordClient } from 'discord-mcp/discord/client';
import { createProvisioner } from 'discord-mcp/discord/provisioner';

const config: AppConfig = loadConfig();
const server = createMCPServer(config);

const blueprintData = {
  metadata: { name: 'test', version: '1.0.0' },
  guild: { name: 'Test Server' },
  roles: [],
  categories: [],
  channels: [],
  invites: []
};

const validation = fullyValidateBlueprint(blueprintData);
if (!validation.success) {
  console.error('Blueprint validation errors:', validation.errors);
  process.exit(1);
}

const discordClient = createDiscordClient({
  botToken: process.env.DISCORD_BOT_TOKEN!,
  maxConcurrentRequests: 5,
  requestDelayMs: 100,
});

await discordClient.connect();
const guilds = await discordClient.listGuilds();
console.log('Accessible guilds:', guilds);

const permissions = await discordClient.checkPermissions('123456789012345678');
if (!permissions.hasRequired) {
  console.error('Missing permissions:', permissions.missing);
}

const newRole = await discordClient.createRole('123456789012345678', {
  id: 'moderator',
  name: 'Moderator',
  color: '#9B59B6',
  hoist: true,
  permissions: ['MANAGE_MESSAGES', 'KICK_MEMBERS']
});

await discordClient.disconnect();
```

--------------------------------

### Discord MCP Server Provisioning Tools (TypeScript)

Source: https://github.com/yosefhayim/discord-mcp/blob/main/PLAN.md

Defines the core tools exposed by the MCP server for interacting with Discord. These tools facilitate guild creation, blueprint application, invite generation, and role assignments. They are designed to be called by an AI or other services to manage Discord server configurations.

```typescript
/**
 * Creates a new Discord guild.
 * @param name The name of the guild.
 * @param icon The guild icon (base64 encoded).
 * @param settings Guild settings.
 * @returns The ID and name of the created guild.
 */
async function create_guild(name: string, icon?: string, settings?: any): Promise<{ guild_id: string, name: string }> {
  // Implementation details...
  return { guild_id: "", name: "" };
}

/**
 * Applies a blueprint to an existing Discord guild.
 * @param guild_id The ID of the guild to apply the blueprint to.
 * @param blueprint The blueprint object defining the desired state.
 * @returns An object detailing the actions taken, created/updated resources, and any errors.
 */
async function apply_blueprint(guild_id: string, blueprint: any): Promise<{ actions: any[], created: any[], updated: any[], skipped: any[], errors: any[] }> {
  // Implementation details...
  return { actions: [], created: [], updated: [], skipped: [], errors: [] };
}

/**
 * Creates invite links for a given channel.
 * @param channel_id The ID of the channel to create invites for.
 * @param max_age The duration in seconds the invite is valid for.
 * @param max_uses The maximum number of times the invite can be used.
 * @returns A list of created invite codes.
 */
async function create_invites(channel_id: string, max_age: number, max_uses: number): Promise<{ invites: string[] }> {
  // Implementation details...
  return { invites: [] };
}

/**
 * Assigns roles to a user in a guild.
 * @param guild_id The ID of the guild.
 * @param user_id The ID of the user.
 * @param role_ids An array of role IDs to assign.
 * @returns The result of the role assignment operation.
 */
async function assign_roles(guild_id: string, user_id: string, role_ids: string[]): Promise<any> {
  // Implementation details...
  return {};
}
```

--------------------------------

### Apply Server Blueprint via MCP Tool

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

JSON request format for the discord.apply_blueprint tool, supporting both named registry blueprints and inline configuration objects. This tool provisions roles, categories, and channels idempotently.

```json
{
  "tool": "discord.apply_blueprint",
  "arguments": {
    "guild_id": "123456789012345678",
    "blueprint": {
      "metadata": { "name": "my-server" },
      "roles": [{ "id": "admin", "name": "Admins", "permissions": ["ADMINISTRATOR"] }],
      "channels": [{ "id": "welcome", "type": "text", "name": "welcome" }]
    }
  }
}
```

--------------------------------

### discord.create_invites

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Creates invite links for specific channels with configurable expiration and usage limits.

```APIDOC
## POST /discord.create_invites

### Description
Creates invite links for specific channels with configurable expiration and usage limits.

### Method
POST

### Endpoint
/discord.create_invites

### Parameters
#### Request Body
- **tool** (string) - Required - The name of the tool to use, should be "discord.create_invites".
- **arguments** (object) - Required - The arguments for the tool.
  - **guild_id** (string) - Required - The ID of the Discord guild.
  - **channel_id** (string) - Required - The ID of the channel to create an invite for.
  - **max_age** (number) - Optional - The duration in seconds the invite is valid for. Defaults to 86400 (24 hours).
  - **max_uses** (number) - Optional - The maximum number of times the invite can be used. Defaults to 0 (unlimited).
  - **temporary** (boolean) - Optional - Whether the invite should be temporary. Defaults to false.
  - **unique** (boolean) - Optional - Whether the invite should be unique. Defaults to false.

### Request Example
```json
{
  "tool": "discord.create_invites",
  "arguments": {
    "guild_id": "123456789012345678",
    "channel_id": "987654321098765432",
    "max_age": 86400,
    "max_uses": 25,
    "temporary": false,
    "unique": true
  }
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the operation was successful.
- **invite** (object) - The created invite object.
  - **code** (string) - The invite code.
  - **url** (string) - The full invite URL.
  - **channel_id** (string) - The ID of the channel the invite is for.
  - **channel_name** (string) - The name of the channel the invite is for.
  - **max_age** (number) - The duration in seconds the invite is valid for.
  - **max_uses** (number) - The maximum number of times the invite can be used.
  - **expires_at** (string) - The expiration date and time of the invite in ISO 8601 format.

#### Response Example
```json
{
  "success": true,
  "invite": {
    "code": "xYz789",
    "url": "https://discord.gg/xYz789",
    "channel_id": "987654321098765432",
    "channel_name": "welcome",
    "max_age": 86400,
    "max_uses": 25,
    "expires_at": "2024-01-16T12:00:00.000Z"
  }
}
```
```

--------------------------------

### Create Discord Invite Links

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

JSON request and response structure for the discord.create_invites tool, used to generate invite links with specific expiration and usage constraints.

```json
{
  "tool": "discord.create_invites",
  "arguments": {
    "guild_id": "123456789012345678",
    "channel_id": "987654321098765432",
    "max_age": 86400,
    "max_uses": 25
  }
}
```

--------------------------------

### Discord Server Blueprint Schema

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Defines the complete structure for a Discord server, including metadata, guild settings, roles, categories, channels, and invites. Uses logical IDs that are mapped to Discord IDs during provisioning.

```json
{
  "metadata": {
    "name": "startup-team",
    "version": "1.0.0",
    "description": "Discord server blueprint for Seed to Series A startup teams",
    "author": "Your Name",
    "tags": ["startup", "team", "collaboration"]
  },
  "guild": {
    "name": "Startup Team",
    "description": "Our team's home base for collaboration",
    "defaultMessageNotifications": "ONLY_MENTIONS",
    "explicitContentFilter": "MEMBERS_WITHOUT_ROLES",
    "verificationLevel": "MEDIUM"
  },
  "roles": [
    {
      "id": "founders",
      "name": "Founders",
      "color": "#E74C3C",
      "hoist": true,
      "mentionable": true,
      "permissions": ["ADMINISTRATOR"],
      "position": 10
    },
    {
      "id": "engineering",
      "name": "Engineering",
      "color": "#3498DB",
      "hoist": true,
      "permissions": [
        "VIEW_CHANNEL",
        "SEND_MESSAGES",
        "EMBED_LINKS",
        "ATTACH_FILES",
        "READ_MESSAGE_HISTORY",
        "ADD_REACTIONS",
        "CONNECT",
        "SPEAK",
        "STREAM"
      ]
    }
  ],
  "categories": [
    { "id": "start-here", "name": "Start Here", "position": 0 },
    { "id": "engineering-cat", "name": "Engineering", "position": 1 },
    { "id": "private", "name": "Private", "position": 2 }
  ],
  "channels": [
    {
      "id": "announcements",
      "type": "announcement",
      "name": "announcements",
      "parent_id": "start-here",
      "topic": "Important company announcements"
    },
    {
      "id": "dev-chat",
      "type": "text",
      "name": "dev-chat",
      "parent_id": "engineering-cat",
      "topic": "Engineering discussions",
      "slowmode": 5
    },
    {
      "id": "help-forum",
      "type": "forum",
      "name": "help",
      "parent_id": "engineering-cat",
      "topic": "Get help from the team",
      "forum_tags": [
        { "name": "Bug", "emoji": "🐛" },
        { "name": "Question", "emoji": "❓" },
        { "name": "Resolved", "emoji": "✅", "moderated": true }
      ],
      "default_forum_layout": "LIST"
    },
    {
      "id": "dev-voice",
      "type": "voice",
      "name": "Dev Voice",
      "parent_id": "engineering-cat",
      "bitrate": 64000,
      "user_limit": 10
    },
    {
      "id": "founders-only",
      "type": "text",
      "name": "founders",
      "parent_id": "private",
      "topic": "Founders-only discussions",
      "permission_overwrites": [
        { "role_ref": "founders", "allow": ["VIEW_CHANNEL", "SEND_MESSAGES"] }
      ]
    }
  ],
  "invites": [
    {
      "channel_ref": "announcements",
      "max_age": 604800,
      "max_uses": 50,
      "temporary": false,
      "unique": false
    }
  ],
  "role_assignments": [
    {
      "user_id": "111111111111111111",
      "role_refs": ["founders", "engineering"]
    }
  ]
}
```

--------------------------------

### Define Discord Server Blueprint

Source: https://github.com/yosefhayim/discord-mcp/blob/main/README.md

The JSON schema for defining Discord server configurations, including metadata, roles, categories, channels, and invites.

```json
{
  "metadata": {
    "name": "my-server",
    "version": "1.0.0",
    "description": "What this blueprint creates"
  },
  "guild": { "name": "Server Name" },
  "roles": [
    { "id": "admin", "name": "Admin", "color": "#E74C3C", "permissions": ["ADMINISTRATOR"] }
  ],
  "categories": [],
  "channels": [],
  "invites": []
}
```

--------------------------------

### discord.apply_blueprint

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Applies a server blueprint to provision roles, channels, categories, and invites to a Discord guild. Supports named blueprints from a registry or inline blueprint objects. The `dry_run` option allows previewing changes without applying them.

```APIDOC
## POST /discord.apply_blueprint

### Description
Applies a server blueprint to provision roles, channels, categories, and invites to a Discord guild. Supports named blueprints from a registry or inline blueprint objects. The `dry_run` option allows previewing changes without applying them.

### Method
POST

### Endpoint
/discord.apply_blueprint

### Parameters
#### Request Body
- **tool** (string) - Required - The name of the tool to use, should be "discord.apply_blueprint".
- **arguments** (object) - Required - The arguments for the tool.
  - **guild_id** (string) - Required - The ID of the Discord guild to apply the blueprint to.
  - **blueprint** (string or object) - Required - Either the name of a registered blueprint or an inline blueprint object.
    - If object, it can contain:
      - **metadata** (object) - Optional - Metadata for the blueprint.
        - **name** (string) - Optional - The name of the blueprint.
        - **version** (string) - Optional - The version of the blueprint.
        - **description** (string) - Optional - A description of the blueprint.
      - **guild** (object) - Optional - Guild configuration.
        - **name** (string) - Optional - The name of the guild.
      - **roles** (array) - Optional - An array of role objects to create or update.
        - **id** (string) - Required - A unique identifier for the role within the blueprint.
        - **name** (string) - Required - The name of the role.
        - **color** (string) - Optional - The role's color in hexadecimal format.
        - **hoist** (boolean) - Optional - Whether the role is displayed separately.
        - **permissions** (array) - Optional - An array of permission strings.
      - **categories** (array) - Optional - An array of category objects to create or update.
        - **id** (string) - Required - A unique identifier for the category within the blueprint.
        - **name** (string) - Required - The name of the category.
        - **position** (number) - Optional - The position of the category.
      - **channels** (array) - Optional - An array of channel objects to create or update.
        - **id** (string) - Required - A unique identifier for the channel within the blueprint.
        - **type** (string) - Required - The type of channel (e.g., "text", "voice").
        - **name** (string) - Required - The name of the channel.
        - **parent_id** (string) - Optional - The ID of the parent category.
        - **topic** (string) - Optional - The topic of the text channel.
      - **invites** (array) - Optional - An array of invite configuration objects.
        - **channel_ref** (string) - Required - The ID of the channel for which to create an invite.
        - **max_age** (number) - Optional - The duration in seconds the invite is valid for.
        - **max_uses** (number) - Optional - The maximum number of times the invite can be used.
  - **dry_run** (boolean) - Optional - If true, simulates the blueprint application without making changes.

### Request Example
```json
{
  "tool": "discord.apply_blueprint",
  "arguments": {
    "guild_id": "123456789012345678",
    "blueprint": {
      "metadata": {
        "name": "my-server",
        "version": "1.0.0",
        "description": "Custom server setup"
      },
      "guild": {
        "name": "My Team Server"
      },
      "roles": [
        {
          "id": "admin",
          "name": "Admins",
          "color": "#E74C3C",
          "hoist": true,
          "permissions": ["ADMINISTRATOR"]
        },
        {
          "id": "member",
          "name": "Members",
          "color": "#3498DB",
          "permissions": ["VIEW_CHANNEL", "SEND_MESSAGES", "READ_MESSAGE_HISTORY"]
        }
      ],
      "categories": [
        { "id": "general", "name": "General", "position": 0 }
      ],
      "channels": [
        {
          "id": "welcome",
          "type": "text",
          "name": "welcome",
          "parent_id": "general",
          "topic": "Welcome to the server!"
        }
      ],
      "invites": [
        { "channel_ref": "welcome", "max_age": 86400, "max_uses": 10 }
      ]
    },
    "dry_run": false
  }
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the operation was successful.
- **guild_id** (string) - The ID of the guild.
- **guild_name** (string) - The name of the guild.
- **summary** (object) - A summary of the changes made.
  - **created** (number) - Number of resources created.
  - **updated** (number) - Number of resources updated.
  - **skipped** (number) - Number of resources skipped.
  - **errors** (number) - Number of errors encountered.
- **actions** (array) - A list of actions performed.
  - **type** (string) - The type of action (e.g., "create", "update").
  - **resource** (string) - The type of resource affected (e.g., "role", "channel").
  - **name** (string) - The name of the resource.
  - **discordId** (string) - The Discord ID of the resource.
- **invites** (array) - A list of generated invites.
  - **code** (string) - The invite code.
  - **url** (string) - The full invite URL.
  - **channel** (string) - The name of the channel the invite is for.
- **duration_ms** (number) - The duration of the operation in milliseconds.

#### Response Example
```json
{
  "success": true,
  "guild_id": "123456789012345678",
  "guild_name": "My Team Server",
  "summary": {
    "created": 4,
    "updated": 0,
    "skipped": 0,
    "errors": 0
  },
  "actions": [
    { "type": "create", "resource": "role", "name": "Admins", "discordId": "111111111111111111" },
    { "type": "create", "resource": "role", "name": "Members", "discordId": "222222222222222222" },
    { "type": "create", "resource": "category", "name": "General", "discordId": "333333333333333333" },
    { "type": "create", "resource": "channel", "name": "welcome", "discordId": "444444444444444444" }
  ],
  "invites": [
    { "code": "abc123", "url": "https://discord.gg/abc123", "channel": "welcome" }
  ],
  "duration_ms": 1250
}
```
```

--------------------------------

### Configure Environment Variables

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Required environment variables for the Discord MCP server, including the bot token and debug settings.

```text
DISCORD_BOT_TOKEN=your_discord_bot_token_here
DEBUG=false
```

--------------------------------

### Blueprint Schema

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Defines the structure for a complete Discord server blueprint, including metadata, guild settings, roles, categories, channels, and invites. This schema is used for provisioning servers.

```APIDOC
## Blueprint Schema

### Description
Defines a complete server blueprint with metadata, guild settings, roles, categories, channels, and invites. All IDs are logical references that get mapped to Discord IDs during provisioning.

### Schema Structure
```json
{
  "metadata": {
    "name": "string",
    "version": "string",
    "description": "string",
    "author": "string",
    "tags": ["string"]
  },
  "guild": {
    "name": "string",
    "description": "string",
    "defaultMessageNotifications": "string",
    "explicitContentFilter": "string",
    "verificationLevel": "string"
  },
  "roles": [
    {
      "id": "string",
      "name": "string",
      "color": "string",
      "hoist": "boolean",
      "mentionable": "boolean",
      "permissions": ["string"],
      "position": "integer"
    }
  ],
  "categories": [
    {
      "id": "string",
      "name": "string",
      "position": "integer"
    }
  ],
  "channels": [
    {
      "id": "string",
      "type": "string",
      "name": "string",
      "parent_id": "string",
      "topic": "string",
      "slowmode": "integer",
      "forum_tags": [
        {
          "name": "string",
          "emoji": "string",
          "moderated": "boolean"
        }
      ],
      "default_forum_layout": "string",
      "bitrate": "integer",
      "user_limit": "integer",
      "permission_overwrites": [
        {
          "role_ref": "string",
          "allow": ["string"],
          "deny": ["string"]
        }
      ]
    }
  ],
  "invites": [
    {
      "channel_ref": "string",
      "max_age": "integer",
      "max_uses": "integer",
      "temporary": "boolean",
      "unique": "boolean"
    }
  ],
  "role_assignments": [
    {
      "user_id": "string",
      "role_refs": ["string"]
    }
  ]
}
```

### Example Usage
```json
{
  "metadata": {
    "name": "startup-team",
    "version": "1.0.0",
    "description": "Discord server blueprint for Seed to Series A startup teams",
    "author": "Your Name",
    "tags": ["startup", "team", "collaboration"]
  },
  "guild": {
    "name": "Startup Team",
    "description": "Our team's home base for collaboration",
    "defaultMessageNotifications": "ONLY_MENTIONS",
    "explicitContentFilter": "MEMBERS_WITHOUT_ROLES",
    "verificationLevel": "MEDIUM"
  },
  "roles": [
    {
      "id": "founders",
      "name": "Founders",
      "color": "#E74C3C",
      "hoist": true,
      "mentionable": true,
      "permissions": ["ADMINISTRATOR"],
      "position": 10
    },
    {
      "id": "engineering",
      "name": "Engineering",
      "color": "#3498DB",
      "hoist": true,
      "permissions": [
        "VIEW_CHANNEL",
        "SEND_MESSAGES",
        "EMBED_LINKS",
        "ATTACH_FILES",
        "READ_MESSAGE_HISTORY",
        "ADD_REACTIONS",
        "CONNECT",
        "SPEAK",
        "STREAM"
      ]
    }
  ],
  "categories": [
    { "id": "start-here", "name": "Start Here", "position": 0 },
    { "id": "engineering-cat", "name": "Engineering", "position": 1 },
    { "id": "private", "name": "Private", "position": 2 }
  ],
  "channels": [
    {
      "id": "announcements",
      "type": "announcement",
      "name": "announcements",
      "parent_id": "start-here",
      "topic": "Important company announcements"
    },
    {
      "id": "dev-chat",
      "type": "text",
      "name": "dev-chat",
      "parent_id": "engineering-cat",
      "topic": "Engineering discussions",
      "slowmode": 5
    },
    {
      "id": "help-forum",
      "type": "forum",
      "name": "help",
      "parent_id": "engineering-cat",
      "topic": "Get help from the team",
      "forum_tags": [
        { "name": "Bug", "emoji": "🐛" },
        { "name": "Question", "emoji": "❓" },
        { "name": "Resolved", "emoji": "✅", "moderated": true }
      ],
      "default_forum_layout": "LIST"
    },
    {
      "id": "dev-voice",
      "type": "voice",
      "name": "Dev Voice",
      "parent_id": "engineering-cat",
      "bitrate": 64000,
      "user_limit": 10
    },
    {
      "id": "founders-only",
      "type": "text",
      "name": "founders",
      "parent_id": "private",
      "topic": "Founders-only discussions",
      "permission_overwrites": [
        { "role_ref": "founders", "allow": ["VIEW_CHANNEL", "SEND_MESSAGES"] }
      ]
    }
  ],
  "invites": [
    {
      "channel_ref": "announcements",
      "max_age": 604800,
      "max_uses": 50,
      "temporary": false,
      "unique": false
    }
  ],
  "role_assignments": [
    {
      "user_id": "111111111111111111",
      "role_refs": ["founders", "engineering"]
    }
  ]
}
```
```

--------------------------------

### Structure of a Development Team Blueprint

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

A comprehensive JSON schema for a server blueprint, defining metadata, roles, categories, channels, and invite settings. This structure is used to automate the deployment of Discord server environments.

```json
{
  "metadata": { "name": "dev-team", "version": "1.0.0", "description": "Minimal Discord server blueprint for development teams", "tags": ["development", "engineering", "minimal"] },
  "guild": { "name": "Dev Team", "description": "Engineering team collaboration hub" },
  "roles": [
    { "id": "admin", "name": "Admins", "color": "#E74C3C", "hoist": true, "permissions": ["ADMINISTRATOR"] },
    { "id": "dev", "name": "Developers", "color": "#3498DB", "hoist": true, "permissions": ["VIEW_CHANNEL", "SEND_MESSAGES", "EMBED_LINKS", "ATTACH_FILES", "READ_MESSAGE_HISTORY", "ADD_REACTIONS", "CONNECT", "SPEAK", "STREAM"] }
  ],
  "channels": [
    { "id": "welcome", "type": "text", "name": "welcome", "parent_id": "general" },
    { "id": "dev-chat", "type": "text", "name": "dev-chat", "parent_id": "development" }
  ]
}
```

--------------------------------

### Define Discord Permissions and Channel Types

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

A TypeScript constant array defining all available Discord permission flags and supported channel types. These are used to validate and construct role definitions and channel configurations within the blueprint system.

```typescript
const DiscordPermissions = [
  'ADMINISTRATOR', 'MANAGE_GUILD', 'MANAGE_ROLES', 'MANAGE_CHANNELS', 'VIEW_AUDIT_LOG',
  'KICK_MEMBERS', 'BAN_MEMBERS', 'MODERATE_MEMBERS', 'CHANGE_NICKNAME', 'MANAGE_NICKNAMES',
  'VIEW_CHANNEL', 'SEND_MESSAGES', 'SEND_TTS_MESSAGES', 'MANAGE_MESSAGES', 'EMBED_LINKS', 'ATTACH_FILES', 'READ_MESSAGE_HISTORY', 'MENTION_EVERYONE', 'USE_EXTERNAL_EMOJIS', 'ADD_REACTIONS',
  'CONNECT', 'SPEAK', 'MUTE_MEMBERS', 'DEAFEN_MEMBERS', 'MOVE_MEMBERS', 'USE_VAD', 'PRIORITY_SPEAKER', 'STREAM',
  'MANAGE_THREADS', 'CREATE_PUBLIC_THREADS', 'CREATE_PRIVATE_THREADS', 'SEND_MESSAGES_IN_THREADS',
  'CREATE_INSTANT_INVITE', 'MANAGE_WEBHOOKS', 'MANAGE_EMOJIS_AND_STICKERS', 'USE_APPLICATION_COMMANDS', 'REQUEST_TO_SPEAK', 'MANAGE_EVENTS', 'USE_EXTERNAL_STICKERS', 'USE_EMBEDDED_ACTIVITIES'
] as const;

const ChannelTypes = ['text', 'voice', 'forum', 'announcement', 'stage'] as const;
```

--------------------------------

### discord.list_guilds

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Retrieves a list of all Discord guilds (servers) that the bot currently has access to. This is useful for discovering available servers.

```APIDOC
## POST /discord/list_guilds

### Description
Lists all Discord guilds (servers) the bot has access to.

### Method
POST

### Endpoint
/discord/list_guilds

### Parameters
#### Request Body
- **tool** (string) - Required - The name of the tool, must be "discord.list_guilds".
- **arguments** (object) - Required - The arguments for the tool. This tool does not require any arguments.

### Request Example
```json
{
  "tool": "discord.list_guilds",
  "arguments": {}
}
```

### Response
#### Success Response (200)
- **guilds** (array of objects) - A list of guilds the bot has access to.
  - **id** (string) - The ID of the guild.
  - **name** (string) - The name of the guild.
- **count** (integer) - The total number of guilds listed.

#### Response Example
```json
{
  "guilds": [
    { "id": "123456789012345678", "name": "My Startup Team" },
    { "id": "234567890123456789", "name": "Dev Community" },
    { "id": "345678901234567890", "name": "Gaming Hub" }
  ],
  "count": 3
}
```
```

--------------------------------

### discord.check_permissions

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Checks if the bot possesses the necessary permissions to provision a specific Discord guild. It returns whether permissions are met and lists any missing ones.

```APIDOC
## POST /discord/check_permissions

### Description
Checks if the bot has the required permissions to provision a guild.

### Method
POST

### Endpoint
/discord/check_permissions

### Parameters
#### Request Body
- **tool** (string) - Required - The name of the tool, must be "discord.check_permissions".
- **arguments** (object) - Required - The arguments for the tool.
  - **guild_id** (string) - Required - The ID of the Discord guild to check permissions for.

### Request Example
```json
{
  "tool": "discord.check_permissions",
  "arguments": {
    "guild_id": "123456789012345678"
  }
}
```

### Response
#### Success Response (200)
- **guild_id** (string) - The ID of the guild for which permissions were checked.
- **has_required_permissions** (boolean) - True if the bot has all required permissions, false otherwise.
- **missing_permissions** (array of strings) - A list of permissions that are missing, if any.

#### Response Example (All Permissions Granted)
```json
{
  "guild_id": "123456789012345678",
  "has_required_permissions": true,
  "missing_permissions": []
}
```

#### Response Example (Missing Permissions)
```json
{
  "guild_id": "123456789012345678",
  "has_required_permissions": false,
  "missing_permissions": ["ManageChannels", "ManageRoles"]
}
```
```

--------------------------------

### List Discord Guilds

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Retrieves a list of all Discord guilds (servers) that the bot currently has access to. The request does not require any arguments.

```json
{
  "tool": "discord.list_guilds",
  "arguments": {}
}
```

--------------------------------

### Check Discord Guild Permissions

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Verifies if the bot possesses the necessary permissions to provision a specific Discord guild. Requires the guild ID as an argument. Returns a boolean indicating if permissions are met and a list of any missing permissions.

```json
{
  "tool": "discord.check_permissions",
  "arguments": {
    "guild_id": "123456789012345678"
  }
}
```

--------------------------------

### Assign Roles to Discord User

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Assigns one or more roles to a specified user within a Discord guild. Requires guild ID, user ID, and a list of role IDs.

```json
{
  "tool": "discord.assign_roles",
  "arguments": {
    "guild_id": "123456789012345678",
    "user_id": "555555555555555555",
    "role_ids": ["111111111111111111", "222222222222222222"]
  }
}
```

--------------------------------

### discord.assign_roles

Source: https://context7.com/yosefhayim/discord-mcp/llms.txt

Assigns one or more roles to a user within a specified Discord guild. This endpoint is crucial for managing user access and permissions.

```APIDOC
## POST /discord/assign_roles

### Description
Assigns one or more roles to a user in a Discord guild.

### Method
POST

### Endpoint
/discord/assign_roles

### Parameters
#### Request Body
- **tool** (string) - Required - The name of the tool to use, must be "discord.assign_roles".
- **arguments** (object) - Required - The arguments for the tool.
  - **guild_id** (string) - Required - The ID of the Discord guild.
  - **user_id** (string) - Required - The ID of the user to assign roles to.
  - **role_ids** (array of strings) - Required - A list of role IDs to assign to the user.

### Request Example
```json
{
  "tool": "discord.assign_roles",
  "arguments": {
    "guild_id": "123456789012345678",
    "user_id": "555555555555555555",
    "role_ids": ["111111111111111111", "222222222222222222"]
  }
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the role assignment was successful.
- **user_id** (string) - The ID of the user whose roles were modified.
- **assigned_roles** (array of objects) - A list of roles that were successfully assigned.
  - **id** (string) - The ID of the assigned role.
  - **name** (string) - The name of the assigned role.

#### Response Example
```json
{
  "success": true,
  "user_id": "555555555555555555",
  "assigned_roles": [
    { "id": "111111111111111111", "name": "Admins" },
    { "id": "222222222222222222", "name": "Members" }
  ]
}
```
```
Tokens:
Raw