io.github.Oratorian/discord-node-mcp
NPM · @MAHESVARA/DISCORD-MCPSERVER · SCANNED SEP 20
MCP server for controlling Discord servers via bot token
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 41 of 147 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency96
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to Oratorian/discord-node-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 233 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability69
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 10274 tokens (~153/item across 67 items; 67 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management90
- Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage99
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 97% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 15 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 67 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.Oratorian/discord-node-mcp server?
io.github.Oratorian/discord-node-mcp runs locally as an npm package, launched with npx -y @mahesvara/discord-mcpserver. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @mahesvara/discord-mcpserver
claude mcp add oratorian-discord-node-mcp -- npx -y @mahesvara/discord-mcpserver
{
"mcpServers": {
"oratorian-discord-node-mcp": {
"command": "npx",
"args": [
"-y",
"@mahesvara/discord-mcpserver"
]
}
}
} {
"servers": {
"oratorian-discord-node-mcp": {
"command": "npx",
"args": [
"-y",
"@mahesvara/discord-mcpserver"
]
}
}
} codex mcp add oratorian-discord-node-mcp -- npx -y @mahesvara/discord-mcpserver
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"oratorian-discord-node-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@mahesvara/discord-mcpserver"
],
"enabled": true
}
}
} openclaw mcp add oratorian-discord-node-mcp --command npx --arg -y --arg @mahesvara/discord-mcpserver
mcp_servers:
oratorian-discord-node-mcp:
command: "npx"
args: ["-y", "@mahesvara/discord-mcpserver"] {
"McpServers": {
"oratorian-discord-node-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@mahesvara/discord-mcpserver"
]
}
}
} assistant mcp add oratorian-discord-node-mcp -t stdio -c npx -a -y @mahesvara/discord-mcpserver
{
"mcpServers": {
"oratorian-discord-node-mcp": {
"command": "npx",
"args": [
"-y",
"@mahesvara/discord-mcpserver"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 19 Sept 26 0
- Security disclosure: unverified → fail ▼ functional
- 18 Sept 26 −2
- Security disclosure: fail → unverified ▼ functional
- Stability: pass → 0.83 functional
- 17 Sept 26 0
- Stability: 0.97 → pass security
- 16 Sept 26 +3
- CVE-2026-82562 no longer affects this package ▲ security
- CVE-2026-82417 no longer affects this package ▲ security
- Known CVEs: fail → pass ▲ security
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 −2
- Stability: pass → 0.80 functional
- 10 Sept 26 0
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/@mahesvara/discord-mcpserver@1.1.4
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | Oratorian/discord-node-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/Oratorian/discord-node-mcp/.github/workflows/publish.yml@refs/tags/v1.1.4 |
| Rekor log index | 870676883 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:c0c5aa854c24eb504ec5dc54f3b8e72c33e4d16726524ae3a42f9b78520b52ef64ca0318d35e517ef4150058f201661543f01d1f5db8708694a426f57 |
Background: How many MCP packages publish verified provenance →
Dependencies 147 packages
| Packages resolved | 147 |
|---|---|
| Stale | 41 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
discord_list_webhooks List Webhooks ~144
List webhooks in a guild or channel. Args: - guild_id (string, optional): List all webhooks in the server - channel_id (string, optional): List webhooks for a specific channel - response_format ('json' | 'markdown'): Output format Returns: List of webhooks with name, channel, and URL
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | – | Channel ID to list webhooks for a specific channel |
| guild_id | string | – | Guild ID to list all webhooks in the server |
| response_format | string | – | Output format: 'markdown' for human-readable or 'json' for structured data |
No output schema declared.
No examples provided.
discord_move_member Move Member to Voice Channel ~140
Move a member to a different voice channel or disconnect them from voice. The member must currently be connected to a voice channel to be moved. Args: - guild_id (string): Discord server/guild ID - user_id (string): Discord user ID to move - channel_id (string | null): Target voice channel ID, or null to disconnect Returns: Confirmation of move or disconnect
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | – | yes | Target voice channel ID, or null to disconnect the user |
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| user_id | string | yes | Discord user ID (snowflake) |
No output schema declared.
No examples provided.
discord_pin_message Pin Discord Message ~77
Pin a message in a channel. Args: - channel_id (string): Discord channel ID - message_id (string): Message ID to pin Returns: Confirmation of message pinned
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | yes | Discord channel ID (snowflake) |
| message_id | string | yes | Discord message ID (snowflake) |
No output schema declared.
No examples provided.
discord_prune_members Prune Members ~177
Remove inactive members from the server. Args: - guild_id (string): Discord server/guild ID - days (number): Days of inactivity required (1-30) - include_roles (string[], optional): Role IDs to include in prune (by default only members without roles) - dry_run (boolean): If true, returns count without actually pruning (default true) Returns: Number of members pruned (or would be pruned if dry_run)
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | yes | Number of days of inactivity (1-30) |
| dry_run | boolean | – | If true, only returns count without actually pruning |
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| include_roles | array | – | Role IDs to include in prune (normally members with roles are excluded) |
No output schema declared.
No examples provided.
discord_remove_channel_permissions Remove Channel Permission Overrides ~91
Remove all permission overrides for a role or member on a channel. Args: - channel_id (string): Discord channel ID - target_id (string): Role or User ID to remove permission overrides for Returns: Confirmation of removal
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | yes | Discord channel ID (snowflake) |
| target_id | string | yes | Role or User ID to remove permission overrides for |
No output schema declared.
No examples provided.
discord_remove_reaction Remove Reaction from Message ~100
Remove the bot's emoji reaction from a message. Args: - channel_id (string): Discord channel ID - message_id (string): Message ID - emoji (string): Emoji to remove Returns: Confirmation of reaction removed
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | yes | Discord channel ID (snowflake) |
| emoji | string | yes | Emoji reaction to remove |
| message_id | string | yes | Discord message ID (snowflake) |
No output schema declared.
No examples provided.
discord_remove_role Remove Role from Member ~108
Remove a role from a Discord member. Args: - guild_id (string): Discord server/guild ID - user_id (string): Discord user ID - role_id (string): Discord role ID to remove Returns: Confirmation of role removed
| Name | Type | Req | Description |
|---|---|---|---|
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| role_id | string | yes | Discord role ID (snowflake) |
| user_id | string | yes | Discord user ID (snowflake) |
No output schema declared.
No examples provided.
discord_send_message Send Discord Message ~113
Send a message to a Discord channel. Args: - channel_id (string): Discord channel ID - content (string): Message content (max 2000 characters) - reply_to (string, optional): Message ID to reply to Returns: The sent message details including ID
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | yes | Discord channel ID (snowflake) |
| content | string | yes | Message content (max 2000 characters) |
| reply_to | string | – | Optional message ID to reply to |
No output schema declared.
No examples provided.
discord_set_channel_permissions Set Channel Permissions ~295
Set permission overrides for a role or member on a channel. Common permission names: - View: ViewChannel - Messages: SendMessages, ReadMessageHistory, ManageMessages, EmbedLinks, AttachFiles, AddReactions - Voice: Connect, Speak, Stream, MuteMembers, DeafenMembers, MoveMembers - Threads: CreatePublicThreads, CreatePrivateThreads, SendMessagesInThreads - Management: ManageChannels, ManageRoles, ManageWebhooks Args: - channel_id (string): Discord channel ID - target_id (string): Role or User ID to set permissions for - target_type ('role' | 'member'): Whether target is a role or member - allow (string[], optional): Permissions to allow (e.g., ['ViewChannel', 'SendMessages']) - deny (string[], optional): Permissions to deny (e.g., ['SendMessages']) Returns: Confirmation of permission changes
| Name | Type | Req | Description |
|---|---|---|---|
| allow | array | – | Permissions to allow (e.g., ['ViewChannel', 'SendMessages', 'ReadMessageHistory']) |
| channel_id | string | yes | Discord channel ID (snowflake) |
| deny | array | – | Permissions to deny (e.g., ['SendMessages', 'AddReactions']) |
| target_id | string | yes | Role or User ID to set permissions for |
| target_type | string | yes | Whether target is a role or member |
No output schema declared.
No examples provided.
discord_set_nickname Set Member Nickname ~115
Set or clear a member's nickname. Args: - guild_id (string): Discord server/guild ID - user_id (string): Discord user ID - nickname (string, optional): New nickname (empty/null to reset) Returns: Confirmation of nickname change
| Name | Type | Req | Description |
|---|---|---|---|
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| nickname | – | yes | New nickname (max 32 chars) or null to clear |
| user_id | string | yes | Discord user ID (snowflake) |
No output schema declared.
No examples provided.
discord_set_role_positions Set Role Positions ~161
Reorder role hierarchy by setting role positions. Higher position = more authority in the hierarchy. The @everyone role is always at position 0. Roles can only manage other roles below them in the hierarchy. IMPORTANT: The bot can only move roles that are below its own highest role in the hierarchy. Args: - guild_id (string): Discord server/guild ID - positions (array): Array of objects with: - role_id (string): Discord role ID - position (number): New position for the role (higher = more authority) Returns: Confirmation of position changes
| Name | Type | Req | Description |
|---|---|---|---|
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| positions | array | yes | Array of role positions to set |
No output schema declared.
No examples provided.
discord_setup_community Setup Community Server ~260
Configure the required channels for a Community server. Sets the rules channel and public updates channel which are required for Community features. The server must already have Community enabled in Discord Server Settings. Args: - guild_id (string): Discord server/guild ID - rules_channel_id (string): Channel for server rules (required) - public_updates_channel_id (string): Channel for Discord updates (required) - description (string, optional): Server description (max 120 chars) - preferred_locale (string, optional): Preferred language (e.g., 'en-US', 'de') - safety_alerts_channel_id (string, optional): Channel for safety alerts Returns: Updated community settings
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | Server description (max 120 chars) |
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| preferred_locale | string | – | Preferred language (e.g., 'en-US', 'de', 'fr') |
| public_updates_channel_id | string | yes | Channel for Discord community updates (required for Community) |
| rules_channel_id | string | yes | Channel for server rules (required for Community) |
| safety_alerts_channel_id | string | – | Channel for safety alerts from Discord |
No output schema declared.
No examples provided.
discord_setup_onboarding Setup Server Onboarding ~421
Setup and enable onboarding for a server from scratch. This tool configures the complete onboarding experience for new members. The server must have Community features enabled. Requirements: - Server must have Community features enabled (done in Discord Server Settings) - At least one default channel must be specified - At least one prompt with options must be provided - Each option must have at least one role_ids OR channel_ids Args: - guild_id (string): Discord server/guild ID - default_channel_ids (string[]): Channels shown to all new members (required, at least one) - prompts (array): Onboarding questions (required, at least one) - type ('multiple_choice' | 'dropdown'): Prompt type - title (string): Question title - single_select (boolean): Allow only one selection (default: true) - required (boolean): Must answer to continue (default: false) - in_onboarding (boolean): Show during onboarding (default: true) - options (array): Available choices (at least one) - title (string): Option title - description (string, optional): Option description - emoji_name (string, optional): Unicode emoji (e.g., '🎮') - role_ids (string[], optional): Roles to assign when selected - channel_ids (string[], optional): Channels to show when selected - mode ('onboarding_default' | 'onboarding_advanced', optional): Mode (default: 'onboarding_default') - enabled (boolean, optional): Enable after setup (default: true) Returns: Confirmation with onboarding status
| Name | Type | Req | Description |
|---|---|---|---|
| default_channel_ids | array | yes | Channels shown to new members by default (at least one required) |
| enabled | boolean | – | Whether to enable onboarding after setup |
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| mode | string | – | Onboarding mode |
| prompts | array | yes | Onboarding prompts/questions (at least one required) |
No output schema declared.
No examples provided.
discord_sync_channel_permissions Sync Channel Permissions with Category ~54
Sync a channel's permissions with its parent category. Args: - channel_id (string): Discord channel ID Returns: Confirmation of sync
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | yes | Discord channel ID (snowflake) |
No output schema declared.
No examples provided.
discord_timeout_member Timeout Member ~169
Timeout (mute) a member for a specified duration. They cannot send messages, react, or join voice. Args: - guild_id (string): Discord server/guild ID - user_id (string): Discord user ID to timeout - duration_minutes (number): Timeout duration in minutes (0 to remove, max 40320 = 28 days) - reason (string, optional): Reason for timeout (visible in audit log) Returns: Confirmation of timeout
| Name | Type | Req | Description |
|---|---|---|---|
| duration_minutes | integer | yes | Timeout duration in minutes (max 28 days = 40320) |
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| reason | string | – | Reason for timeout |
| user_id | string | yes | Discord user ID (snowflake) |
No output schema declared.
No examples provided.
discord_unban_member Unban Discord Member ~84
Remove a ban from a user. Args: - guild_id (string): Discord server/guild ID - user_id (string): Discord user ID to unban Returns: Confirmation of unban
| Name | Type | Req | Description |
|---|---|---|---|
| guild_id | string | yes | Discord server/guild ID (snowflake) |
| user_id | string | yes | Discord user ID (snowflake) |
No output schema declared.
No examples provided.
discord_unpin_message Unpin Discord Message ~82
Unpin a message in a channel. Args: - channel_id (string): Discord channel ID - message_id (string): Message ID to unpin Returns: Confirmation of message unpinned
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | yes | Discord channel ID (snowflake) |
| message_id | string | yes | Discord message ID (snowflake) |
No output schema declared.
No examples provided.
What is the io.github.Oratorian/discord-node-mcp server?
io.github.Oratorian/discord-node-mcp is listed in the public MCP registry as io.github.Oratorian/discord-node-mcp. MCP server for controlling Discord servers via bot token. This page covers its npm package (@mahesvara/discord-mcpserver).
Is the io.github.Oratorian/discord-node-mcp server safe to use?
io.github.Oratorian/discord-node-mcp scores 92 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.Oratorian/discord-node-mcp server expose?
io.github.Oratorian/discord-node-mcp exposes 67 tools: discord_list_guilds, discord_get_guild, discord_leave_guild, discord_edit_guild, discord_list_channels, and 62 more. Their descriptions and schemas cost roughly 10,274 tokens of context every time the server is loaded.
Is the io.github.Oratorian/discord-node-mcp server still maintained?
io.github.Oratorian/discord-node-mcp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.Oratorian/discord-node-mcp server under?
io.github.Oratorian/discord-node-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.