A simple, lightweight MCP server that exposes Discord bot functionality to AI agents
dismcp provides 27 well-structured Discord tools with consistent naming (verb_noun pattern), clear descriptions (avg ~80 chars), and complete JSON Schema definitions. All tools have input schemas with typed parameters and descriptions. However, output schemas are not documented, LLMs cannot predict response structure. Error handling is minimal; no recovery guidance or actionable error messages. Parameter descriptions lack constraints (ranges, enums, formats). No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels. Missing idempotency guidance for retry-safe operations.
Ban a user from a guild.
Remove a member timeout.
Create an application emoji from a data URI image.
Create a guild emoji from a data URI image.
Create a scheduled event in a guild.
Delete an application emoji.
Delete a guild emoji.
Output schemas not documented. LLMs cannot predict response structure or plan downstream tool calls. Violates pattern:tool requirement for documented return types.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). Agents cannot determine retry safety or permission requirements.
Parameter descriptions lack constraints. 'guild_id' and 'user_id' described as 'snowflake, as string' but no format/pattern validation. 'limit' parameters lack min/max bounds (e.g., 1-200 for get_guilds is stated but not enforced in schema).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 65 | <=2025-11-25 | v2 |
Delete a scheduled event.
Edit an application emoji.
Edit the current bot profile (username, avatar, banner).
Edit a guild emoji.
Edit a scheduled event.
Get details for an application emoji.
List application emojis.
Get information about the current Discord application.
Get details for a specific guild.
Get details for a guild emoji.
List emojis in a guild.
List members from a specific guild.
List guilds visible to the currently authenticated user.
Get a guild member by guild and user IDs.
Get details for a scheduled event.
List users interested in a scheduled event.
List scheduled events in a guild.
Kick a member from a guild.
Set a member timeout until the specified ISO-8601 timestamp.
Unban a user from a guild.
No error handling guidance. Tools return raw API errors without recovery hints. E.g., 'User not found' should suggest 'Try get_guild_members() to find the user first.'
Pagination tools (get_guilds, get_guild_members, get_scheduled_event_users) lack total_count or next_cursor in documented output. LLMs cannot determine if more results exist or how to fetch them efficiently.