discord-ops

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

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

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

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

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

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

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

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.

Unpin a message from a Discord channel.

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

Add a reaction emoji to a message.

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

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

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

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

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.

Edit a message sent by the bot.

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

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

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.

Create a webhook for a channel. Requires ManageWebhooks permission.

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

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

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

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

Get details about a specific webhook.

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

Unban a user from a guild. Requires BanMembers permission.

Kick a member from a guild. Requires KickMembers permission.

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

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

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

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.

Get detailed information about a specific channel.

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

Delete a channel. This is irreversible.

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

Create a new channel in a guild.

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 role in a guild. Requires ManageRoles permission.

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

List all roles in a guild.

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

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

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

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

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

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

List members of a guild.

Get detailed information about a guild member.

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.

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

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

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

Get all active invites for a guild.

Get detailed information about a guild (server).

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

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.

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