discord-ops

Check bot connection status, permissions, and project routing config. Optionally checks permissions in a specific guild.

Leave a directed note on the project's shared board — a durable log other agents and future

List the sessions recently active on a project's board — derived from who has posted notes

Read the project's note board — the durable log of directed notes. Filter by recipient

Mark a board note handled by adding a ${RESOLVED_EMOJI} reaction — get_notes({ unresolved: true })

Register an agent persona on a channel — a named posting identity that replaces creating new Discord bots.

List persona-capable webhooks — the carriers of agent persona identities. Scope to one channel via

Post a message AS a named agent persona — the agent-persona posting primitive. Persona identity is

Find replies to a message you posted earlier — use after send_message to collect responses

Send a beautifully formatted Discord message using a built-in template. Supports embeds, link buttons, native polls, multi-embed dashboards, Discord timestamps, and author branding. Use list_templates for full details on all 23 templates.

Ping project owners in a channel based on notification_type. Sends owner <@mention>s only — no embed, no template. Use when you need a raw ping without a full message. No-ops silently if notification_type is not in the project's notify_owners_on list.

Fetch recent messages from a Discord channel. Supports both snowflake IDs and ISO 8601 timestamps for before/after parameters. Each message includes reply_to so reply chains between agents are visible in bulk reads.

Unpin a message from a Discord channel.

Pin a message in a Discord channel. Channels can have up to 50 pinned messages.

Send a message to a Discord channel. Messages are automatically wrapped in a polished embed. Set raw=true for plain text. For richer formatting, use send_template instead. Returns message_id — capture it to later observe responses with get_replies, get_reactions, or get_message.

Read WHO reacted to a message and with what emoji. Use after send_message to detect

Forward a message to another channel as an immutable snapshot — the escalation primitive.

Delete a message. Bot can only delete its own messages or messages in channels where it has Manage Messages permission.

Fetch a single message by ID — the primitive for re-checking a message you posted earlier.

Edit a message sent by the bot.

Add a reaction emoji to a message.

List all available message templates with their required/optional variables. Use with send_template to send formatted Discord embeds.

Real-time local event feed written by `discord-ops listen` — reads normalized gateway

List all configured bot personas with their identity metadata, project assignments, and channel overrides. Does not expose token values.

List all configured projects with their guild mappings, channel aliases, token status, and routing config. Essential for understanding multi-org setups.

List members of a guild.

Get detailed information about a guild member.

Query the guild audit log. Filter by user, action type, or fetch recent entries. Requires ViewAuditLog permission.

Update a forum post's tags and/or archived state — the claim/complete mechanic for forum

List posts in a forum channel used as an agent work queue — each post is a task, its tags

Create a post in a forum channel — the enqueue primitive for using a forum as a durable

List all guilds (servers) the bot has access to. Pass project to use a specific bot token.

Get all active invites for a guild.

Get detailed information about a guild (server).

List active (and optionally archived) threads in a guild.

Archive a thread, optionally locking it to prevent new messages. Archived threads are hidden from the channel list but can be unarchived.

Create a thread in a channel, optionally from an existing message.

Create a native Discord poll — a structured voting surface for reaching consensus between

Immediately close a native Discord poll before its scheduled expiry — use when consensus

Read the current state of a native Discord poll: per-answer vote counts plus WHO voted,

Kick a member from a guild. Requires KickMembers permission.

Timeout (mute) a member for a specified duration. Set duration_seconds to 0 to remove timeout. Requires ModerateMembers permission.

Ban a user from a guild. Can optionally delete recent messages. Requires BanMembers permission.

Unban a user from a guild. Requires BanMembers permission.

Get details about a specific webhook.

Create a webhook for a channel. Requires ManageWebhooks permission.

List webhooks in a guild or channel. Requires ManageWebhooks permission.

Delete a webhook. This is irreversible. Requires ManageWebhooks permission.

Send a message through a webhook. Supports content, embeds, and username/avatar overrides. Great for CI/CD notifications.

Edit a webhook's name or channel. Requires ManageWebhooks permission.

Create a new role in a guild. Requires ManageRoles permission.

Edit an existing role in a guild. Requires ManageRoles permission.

Delete a role from a guild. This is irreversible. Requires ManageRoles permission.

Add or remove a role from a guild member. Requires ManageRoles permission.

List all roles in a guild.

List all channels in a guild, optionally filtered by type.

Set channel permission overrides for a role or member. Specify permission flags to allow or deny. Common flags: ViewChannel, SendMessages, ManageMessages, EmbedLinks, AttachFiles, ReadMessageHistory, AddReactions, ManageChannels.

Move a channel or category to a position immediately before or after another channel. Uses before_id/after_id instead of raw position integers.

Create a new channel in a guild.

Delete a channel. This is irreversible.

Edit a channel's name, topic, category, or position.

Bulk-delete messages from a channel. Messages must be less than 14 days old. Requires ManageMessages permission. This is irreversible.

Get detailed information about a specific channel.

Set or disable slowmode on a channel. Set seconds to 0 to disable. Requires ManageChannels permission.