What the AI helper can (and can’t) do
The StageHand AI helper is a StageHand setup assistant. It talks to StageHand with your personal key (sh_…). It is not a general Discord bot controller.
If you want someone to kick members, create channels, manage roles as Discord moderation, or delete messages in Discord, this helper cannot do that. Use Discord itself, server staff tools, or a separate Discord-focused helper.
Your helper should ask you for missing pieces — Discord channel/role ids, form fields, and image files — before it writes settings. You do not need to invent snowflakes; it can list channels StageHand can see.
What it can do
On Discord servers where you have Manage Server (or you own the server / have Administrator):
| Area | Examples |
|---|---|
| Access check | Confirm your key works |
| See config | Read the server’s StageHand surface; list channels, roles, emojis |
| Forum indexes | Create/update/delete indexes, thumbs, refresh |
| Lore | Panels, snippets, carousels, selectors, import/export, layout validate, banners (first Discord publish may still need /lore panel once) |
| Flows | Flow Builder create/edit/delete; node catalog; Flow static images |
| Forms | Upsert/delete/import/export; post button panels |
| Roles (StageHand module) | Save role lists, sync Discord roles from lists, post role panels |
| Dice | Dice / sets / presets / post-automation; upload/list/delete face art |
| Mailboxes | Mailbox indexes, headers, refresh |
| Scene | Scene setup + upload/delete scene/end/day/preset images |
| Tickets | Ticket module config |
| Info Display | Voice-channel signs config |
| Keep open | Forums kept in the sidebar |
| Bot customization | Guild StageHand nickname/avatar/banner assets |
| Verification | Verification config + post honeypot bait |
| Rules & Watchers | Classic IFTTT rules + pending reminder cancel |
| Custom commands | Custom command config |
| Checklists / Quests | Module config |
| Reputation | Config + live lookup |
| Calendar / Ticker | Config (+ live calendar); ticker images + test post |
| Challenges | Config export/import/copy; finish button |
| Birthdays | Live list/create/update/delete/settings |
| Indexes (advanced) | Group + layered indexes; materialize thumbs |
| Emoji usage | Stats; optional emoji delete (asks confirmation — deletes Discord emoji) |
| MIA & Hiatus | Surface, policy, hiatus upsert/end, MIA mark/clear, activity touch, events, submit config, staff template post |
It only changes StageHand settings (the same kinds of things you’d configure in the StageHand dashboard). It does not become “you” for everyday Discord chat or moderation.
What it cannot do
- Kick, ban, timeout, or warn people
- Create, delete, or rename Discord channels, categories, roles, or forums by itself (the Roles module can sync roles StageHand manages after you define lists — that is not general Discord admin)
- Post arbitrary chat, react, or manage threads as a general Discord client
- Manage MultiMuse muses, BackDrop worlds, or other products
- Act on servers where you don’t have Manage Server
- Mint or list other people’s API keys
Deleting StageHand config (index, lore panel, form, etc.) removes StageHand settings. It does not always delete Discord messages or channels.
How to think about it
- Yes: “Set up a Characters forum index” / “Build a join Flow” / “Draft a rules lore panel” / “Make a ticket panel” / “Upload d6 faces for our dice set”
- No: “Delete that spam channel” / “Ban that user” / “Give me admin” / “Create a whole Discord category tree from scratch”
When you ask for custom art, expect the helper to ask for the image files (or paths) before uploading.
For install steps (key + Add to Cursor / Codex), see Connect an AI helper.
Safety
- Only create keys for AI apps you trust.
- Revoke keys on Dashboard → Me if anything feels off.
- Treat the key like a password — anyone with it can change StageHand settings on servers you can manage.