Skip to main content
Glama
Sign In
Discord MCP - Discord server management MCP for AI agents

Discord MCP - Discord server management MCP for AI agents

by OrygnsCode
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Diff blueprint

diff_blueprint
Read-only

Compare a blueprint against the live Discord server to detect drift: missing, changed, and extra roles, channels, and permissions. Find config drift before applying updates.

Instructions

Compare a blueprint against the live server: what the blueprint expects but the server lacks (missing), what exists but differs (changed, with the fields), and what the server has that the blueprint never mentioned (extra, informational). Reads the blueprint as the whole truth, so a setting it leaves out counts as its default. The drift detector for config-as-code workflows. To act on it, plan_server_build applies changes with update_existing and deletes extras listed in remove.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "blueprint": "<blueprint>"
    },
    "name": "diff_blueprint"
  }
}

Input Schema

NameRequiredDescriptionDefault
guildNoGuild (server) name or ID. Omit to use the default guild.
blueprintYesA saved blueprint's name or ID, or a blueprint itself.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changedv1.4.2
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedInput schema / properties / blueprint / anyOf
      Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "properties": {
+      "categories": {
+        "items": {
+          "properties": {
+            "channels": {
+              "items": {
+                "properties": {
+                  "id": {
+                    "description": "Discord id from export_server_blueprint. Matches this exact item, so a new name renames it.",
+                    "pattern": "^\\d{17,20}$",
+                    "type": "string"
+                  },
+                  "name": {
+                    "maxLength": 100,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "nsfw": {
+                    "type": "boolean"
+                  },
+                  "permissions": {
+                    "description": "Extra permissions per role here, beyond who can see and post (private_to, read_only, posting_roles). Example: [{\"role\": \"Event Staff\", \"allow\": [\"mention_everyone\", \"embed_links\"]}]. A listed role's extras become exactly these; roles not listed keep theirs.",
+                    "items": {
+                      "properties": {
+                        "allow": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "deny": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "role": {
+                          "description": "Role name, or @everyone.",
+                          "maxLength": 100,
+                          "minLength": 1,
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "role"
+                      ],
+                      "type": "object"
+                    },
+                    "maxItems": 50,
+                    "type": "array"
+                  },
+                  "posting_roles": {
+                    "description": "With read_only: role names that may still post and start threads.",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "private_to": {
+                    "anyOf": [
+                      {
+                        "items": {
+                          "type": "string"
+                        },
+                        "type": "array"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Role names that can see this channel; everyone else is denied view. [] leaves only admins. null makes it visible to everyone. Omit to follow the category."
+                  },
+                  "read_only": {
+                    "description": "Deny sending for everyone; for rules and announcements.",
+                    "type": "boolean"
+                  },
+                  "slowmode_seconds": {
+                    "maximum": 21600,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "topic": {
+                    "maxLength": 1024,
+                    "type": "string"
+                  },
+                  "type": {
+                    "description": "Default text.",
+                    "enum": [
+                      "text",
+                      "voice",
+                      "forum",
+                      "stage",
+                      "announcement"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "type": "object"
+              },
+              "maxItems": 50,
+              "type": "array"
+            },
+            "id": {
+              "description": "Discord id from export_server_blueprint. Matches this exact item, so a new name renames it.",
+              "pattern": "^\\d{17,20}$",
+              "type": "string"
+            },
+            "name": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "permissions": {
+              "description": "Extra permissions per role here, beyond who can see and post (private_to, read_only, posting_roles). Example: [{\"role\": \"Event Staff\", \"allow\": [\"mention_everyone\", \"embed_links\"]}]. A listed role's extras become exactly these; roles not listed keep theirs.",
+              "items": {
+                "properties": {
+                  "allow": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "deny": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "role": {
+                    "description": "Role name, or @everyone.",
+                    "maxLength": 100,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "role"
+                ],
+                "type": "object"
+              },
+              "maxItems": 50,
+              "type": "array"
+            },
+            "private_to": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Role names that can see the whole category. [] leaves only admins. null makes it visible to everyone."
+            }
+          },
+          "required": [
+            "name",
+            "channels"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "channels": {
+        "description": "Top-level channels outside any category.",
+        "items": {
+          "properties": {
+            "id": {
+              "description": "Discord id from export_server_blueprint. Matches this exact item, so a new name renames it.",
+              "pattern": "^\\d{17,20}$",
+              "type": "string"
+            },
+            "name": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "nsfw": {
+              "type": "boolean"
+            },
+            "permissions": {
+              "description": "Extra permissions per role here, beyond who can see and post (private_to, read_only, posting_roles). Example: [{\"role\": \"Event Staff\", \"allow\": [\"mention_everyone\", \"embed_links\"]}]. A listed role's extras become exactly these; roles not listed keep theirs.",
+              "items": {
+                "properties": {
+                  "allow": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "deny": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "role": {
+                    "description": "Role name, or @everyone.",
+                    "maxLength": 100,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "role"
+                ],
+                "type": "object"
+              },
+              "maxItems": 50,
+              "type": "array"
+            },
+            "posting_roles": {
+              "description": "With read_only: role names that may still post and start threads.",
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "private_to": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Role names that can see this channel; everyone else is denied view. [] leaves only admins. null makes it visible to everyone. Omit to follow the category."
+            },
+            "read_only": {
+              "description": "Deny sending for everyone; for rules and announcements.",
+              "type": "boolean"
+            },
+            "slowmode_seconds": {
+              "maximum": 21600,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topic": {
+              "maxLength": 1024,
+              "type": "string"
+            },
+            "type": {
+              "description": "Default text.",
+              "enum": [
+                "text",
+                "voice",
+                "forum",
+                "stage",
+                "announcement"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 500,
+        "type": "array"
+      },
+      "name": {
+        "description": "Optional label for saving or referencing this blueprint.",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "roles": {
+        "description": "Highest role first, the way the server settings list them. A build creates them in this order and that order is the hierarchy.",
+        "items": {
+          "properties": {
+            "color": {
+              "anyOf": [
+                {
+                  "pattern": "^#?[0-9a-fA-F]{6}$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "null clears it."
+            },
+            "hoist": {
+              "description": "Show members with this role separately in the sidebar.",
+              "type": "boolean"
+            },
+            "id": {
+              "description": "Discord id from export_server_blueprint. Matches this exact item, so a new name renames it.",
+              "pattern": "^\\d{17,20}$",
+              "type": "string"
+            },
+            "mentionable": {
+              "type": "boolean"
+            },
+            "name": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "permissions": {
+              "description": "Extra permission names beyond the preset.",
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "preset": {
+              "description": "Vetted permission bundle. Administrator is never included.",
+              "enum": [
+                "none",
+                "member",
+                "moderator",
+                "admin"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 250,
+        "type": "array"
+      },
+      "theme": {
+        "description": "Freeform note recording the intent and naming style.",
+        "maxLength": 500,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+]
    • changedInput schema / properties / blueprint / description
      Previous value: -"Saved blueprint name or ID."New value: +"A saved blueprint's name or ID, or a blueprint itself."
    • removedInput schema / properties / blueprint / type
      Removed value: -"string"
  2. Changed1 schema field changedv1.3.0
    • removedInput schema / additionalProperties
      Removed value: -false
  3. First observedv1.0.2

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the readOnlyHint by explaining the interpretive rule that makes results meaningful: the blueprint is read as the whole truth, so omitted settings count as their defaults, and "extra" items are informational. It also describes what each result category carries (changed fields), which annotations cannot convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first sentence, with result categories and the key interpretive rule before the alternative-tool pointer. Dense but every clause carries meaning; the parenthetical field/category detail is useful rather than filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Though there is no output schema, the description compensates by describing the missing/changed/extra result structure and the default-equivalence rule. For a two-parameter read-only diff tool this is complete enough to call and interpret correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% so the schema documents both parameters, but the description adds a genuine semantic insight about the blueprint parameter: it is treated as authoritative and unspecified settings fall back to defaults. The guild parameter is left entirely to the schema, keeping this just under 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: "Compare a blueprint against the live server," then explicitly enumerates the three result categories (missing, changed, extra). It is unmistakably distinct from plan_server_build, which it names as the apply-action sibling.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Frames the tool as "the drift detector for config-as-code workflows" and explicitly routes the agent to plan_server_build with update_existing/remove when it needs to act. The condition selecting this versus the apply-tool is spelled out, leaving little inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools