discord-integration

What problem does it solve?

Integrating with Discord can be complex, involving bot tokens, permissions, and choosing the right API method, often leading to frustrating permission errors or connection issues. This Skill simplifies Discord interactions by providing a robust, three-tier integration strategy with automatic fallback, preventing common setup headaches and wasted debugging time.

Core Features & Use Cases

• Three-Tier Integration: Offers preferred MCP tools, Discord.js Gateway scripts, and direct REST API calls, ensuring reliable message sending and reading even if one method encounters issues.
• Automatic Fallback: Automatically attempts the next available integration method if the primary one fails, maximizing message delivery reliability and minimizing manual intervention.
• Bot Management: Provides clear information on available bots (e.g., Sombra, GladOSv3) and their configurations, simplifying bot token management and access setup.
• Troubleshooting: Helps diagnose and resolve common Discord bot connection or permission issues, guiding users through potential OAuth scope problems and configuration errors.
• Use Case: An AI agent needs to send an urgent alert to a Discord channel. It first attempts to use the mcp__discord__send-message tool. If that fails (e.g., due to a Claude Code restart), it automatically falls back to executing a Discord.js Gateway script, ensuring the critical message is delivered without any manual intervention or delay.

Quick Start

Use the discord-integration skill to send a message "Hello from Claude!" to the #general channel using the preferred MCP method.