---
name: discord-automation
description: |
  Comprehensive Discord server management via API. Use this skill whenever:
  - Creating, updating, or deleting Discord channels (text, voice, announcement, category, stage)
  - Managing channel permissions and settings
  - Sending messages or embeds to channels
  - Working with Discord roles (create, assign, delete)
  - Setting up webhooks for notifications
  - Reacting to messages or managing reactions
  - Automating Discord server operations
  - Any Discord API interaction via curl or Rube MCP
  This skill covers direct curl commands AND higher-level Rube MCP automation.
---

# Discord Automation Skill

Complete Discord server management for Firefrost Gaming via API.

---

## 🎯 QUICK REFERENCE

| Task | Method | File |
|------|--------|------|
| Create channels | curl | `discord-create-channel.md` |
| Update/delete channels | curl | `discord-manage-channel.md` |
| Messages, embeds, reactions | curl | `discord-bot-api.md` |
| Webhooks (no bot needed) | curl | `discord-webhook.md` |
| Roles, DMs, complex flows | Rube MCP | `discord-automation-rube-mcp.md` |

---

## 🔑 FIREFROST DISCORD CREDENTIALS

```bash
DISCORD_BOT_TOKEN=MTQ4NzA4MDE2Njk2OTU3NzUwMg.GU5EsT.mqBwo7XUHsciN9jNy9OygTRkaMZ9qJ2tHw7HbI
GUILD_ID=1260574715546701936
DISCORD_CLIENT_ID=1487080166969577502
```

### Key Channel IDs

| Channel | ID |
|---------|-----|
| general-chat | 1260574716058664962 |
| announcements | 1403980849686515832 |
| 📚-guides (forum) | 1491804184356454430 |

---

## 📢 CHANNEL TYPES

| Type | Number | Use |
|------|--------|-----|
| Text | 0 | Regular text channels |
| Voice | 2 | Voice chat |
| Category | 4 | Folder for organizing channels |
| Announcement | 5 | Crosspost to following servers |
| Stage | 13 | Audio events |
| Forum | 15 | Thread-based discussions |

---

## 🛠️ COMMON OPERATIONS

### Create a Text Channel

```bash
curl -X POST "https://discord.com/api/v10/guilds/${GUILD_ID}/channels" \
  -H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "channel-name",
    "type": 0,
    "parent_id": "CATEGORY_ID"
  }'
```

### Send a Message

```bash
curl -X POST "https://discord.com/api/v10/channels/${CHANNEL_ID}/messages" \
  -H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello from the API!"}'
```

### Send an Embed

```bash
curl -X POST "https://discord.com/api/v10/channels/${CHANNEL_ID}/messages" \
  -H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "Title Here",
      "description": "Description here",
      "color": 5765099,
      "fields": [
        {"name": "Field 1", "value": "Value 1", "inline": true}
      ]
    }]
  }'
```

### Update Channel Permissions

```bash
curl -X PUT "https://discord.com/api/v10/channels/${CHANNEL_ID}/permissions/${ROLE_ID}" \
  -H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": 0,
    "allow": "1024",
    "deny": "0"
  }'
```

### Delete a Channel

```bash
curl -X DELETE "https://discord.com/api/v10/channels/${CHANNEL_ID}" \
  -H "Authorization: Bot ${DISCORD_BOT_TOKEN}"
```

---

## 🎨 FIREFROST EMBED COLORS

| Color | Hex | Decimal |
|-------|-----|---------|
| Fire | #FF6B35 | 16738101 |
| Frost | #4ECDC4 | 5164484 |
| Arcane | #A855F7 | 11031031 |
| Gold | #FFD700 | 16766720 |
| Dark | #0F0F1E | 986910 |

---

## 📁 DETAILED DOCUMENTATION

For complex operations, see the individual files in this skill folder:

- **discord-create-channel.md** — All channel creation options, categories, permissions
- **discord-manage-channel.md** — Update, move, configure, delete channels
- **discord-bot-api.md** — Full bot API reference (messages, roles, members)
- **discord-webhook.md** — Simple webhooks (no bot token needed)
- **discord-automation-rube-mcp.md** — Rube MCP integration for complex workflows

---

## ⚠️ PERMISSION NUMBERS

Common permission flags (bitwise):

| Permission | Value |
|------------|-------|
| View Channel | 1024 |
| Send Messages | 2048 |
| Manage Messages | 8192 |
| Manage Channels | 16 |
| Manage Roles | 268435456 |

Combine with OR: `View + Send = 1024 | 2048 = 3072`

---

## 🔗 RESOURCES

- [Discord Developer Portal](https://discord.com/developers/applications)
- [Discord API Docs](https://discord.com/developers/docs)
- [Permission Calculator](https://discordapi.com/permissions.html)

---

**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️
