Revolt (Stoat) MCP server
14 operations0 webhooks
Community chat with Revolt, now branded Stoat - read the account behind a bot or user token, users, direct messages, channels, servers and members, and read, send, edit and delete messages and add reactions.
Try Revolt (Stoat) with your agent
Connect Revolt (Stoat), then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Revolt (Stoat) on my account, then run one read-only example and show me the result.
Revolt (Stoat) tools and triggers
Tools are what your agent can do in Revolt (Stoat) through Corsair's MCP server. Triggers are the Revolt (Stoat) events a routine can start from.
Messages
- DeleteDestructive
Delete a message permanently
messages.delete
- EditWrite
Edit a message the account posted, replacing its content
messages.edit
- GetRead-only
Fetch one message by id
messages.get
- ListRead-only
Read a channel’s messages with time cursors, already carrying their authors
messages.list
- SendWrite
Send a message to a channel, optionally replying or attaching files
messages.send
Channels
- DeleteDestructive
Delete a server channel and its messages, leave a group, or close a direct message (its messages stay)
channels.delete
- EditWrite
Rename or redescribe a group or server channel
channels.edit
- GetRead-only
Fetch one channel with its type, name and permissions
channels.get
Users
- DmsRead-only
List the direct-message and group channels the account is in, with their recipient ids
users.dms
- GetRead-only
Fetch one user by id with their profile and presence
users.get
- MeRead-only
Read the account behind the token: its id, username, discriminator and status
users.me
Servers
- GetRead-only
Fetch one server with its channels, roles and default permissions
servers.get
- MembersRead-only
List a server’s members with their users, optionally excluding offline ones
servers.members
Reactions
- AddWrite
Add an emoji reaction to a message
reactions.add
Connect Revolt (Stoat) to Claude, ChatGPT or Cursor
- 1
Connect Revolt (Stoat) in Corsair
Add your Revolt (Stoat) API key once in Corsair. Corsair stores the credential encrypted and makes the Revolt (Stoat) API calls for your agent, so it never goes into a prompt or a config file. Connect Revolt (Stoat)
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Revolt (Stoat). On a ChatGPT personal plan, connect Revolt (Stoat) here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Revolt (Stoat)'s read and write operations run right away and its 2 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/revolt, add the Revolt (Stoat) plugin, and connect with an API key. Then call methods like corsair.revolt.api.channels.delete() from your app. Corsair keeps each tenant isolated.
Yes. Revolt (Stoat) requires an API key from your Revolt (Stoat) account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Revolt (Stoat), GitHub, Notion, Stripe, and the rest. Trigger Revolt (Stoat) from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for community chat with Revolt, now branded Stoat - read the account behind a bot or user token, users, direct messages, channels, servers and members, and read, send, edit and delete messages and add reactions. Common builds include sync jobs, admin tooling, and agents that call Revolt (Stoat) APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Revolt (Stoat) API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/revolt in the open repo. When Revolt (Stoat) ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Revolt (Stoat) data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Revolt (Stoat) data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Revolt (Stoat) on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 2 destructive Revolt (Stoat) operations. You can change a link's mode at hub.corsair.dev/me.