# Revolt — MCP server on mcp.ai
> Connect your Revolt account and use 26 tools for communication straight from your AI agent. Connect with your own API key. Revolt is a free and open-source chat platform offering secure and customizable communication.

By: mcp.ai · official
Page: https://mcp.ai/revolt

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_revolt?ms=1787296080000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/revolt/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/revolt/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/revolt/skill.md
Postman collection (v2.1): https://mcp.ai/revolt/postman.json

## Tools
- revolt_acknowledge_policy_changes() — Tool to acknowledge platform policy changes. Use when accepting or confirming policy updates for your bot account.
- revolt_add_channels_messages_reactions(msg: string, emoji: string, target: string) — Tool to add a reaction to a message in a channel. Use when you want to react with an emoji to a specific message. Returns success on completion.
- revolt_block_user(target: string) — Tool to block another user by their ID. Use when you need to prevent interactions with a specific user.
- revolt_create_sync_settings_set(settings: object, timestamp?: integer) — Tool to upload and save settings data to Revolt's sync storage. Use when you need to persist user settings or preferences.
- revolt_delete_message(channel_id: string, message_id: string) — Tool to delete a message you've sent or one you have permission to delete. Use when you need to remove a message from a channel.
- revolt_delete_messages_bulk(channel_id: string, message_ids: string[]) — Tool to bulk delete multiple messages from a channel. Use when you need to delete multiple messages at once. Requires ManageMessages permission regardless of message ownership. Messages must have been
- revolt_fetch_owned_bots() — Tool to fetch all bots that you have control over. Use when you need to retrieve information about bots owned by the authenticated user account.
- revolt_fetch_sync_settings(keys: string[]) — Tool to fetch settings from server filtered by keys. Returns an object with the requested keys where each value is a tuple of (timestamp, value). Only settings that exist on the server will be include
- revolt_fetch_user(user_id: string) — Tool to fetch detailed information about a user. Use when you have a valid user ID and need full account details. Call after authenticating with bot token.
- revolt_fetch_user_flags(user_id: string) — Tool to fetch flags associated with a specific user. Use after obtaining the user ID to inspect their special statuses or roles.
- revolt_get_api_info() — Tool to fetch the server configuration for this Revolt instance. Use when you need to discover API version, feature availability, WebSocket endpoints, or service URLs.
- revolt_get_channel(target: string) — Tool to fetch a channel by its ID. Use when you need to retrieve detailed information about a specific channel.
- revolt_get_current_user() — Tool to retrieve your own user information. Use when you need to fetch details about the authenticated user account.
- revolt_get_invite(target: string) — Tool to fetch detailed information about an invite by its code. Use when you have a valid invite code and need to retrieve invite details including server info, channel info, and member count.
- revolt_get_sync_unreads() — Tool to fetch information about unread state on channels. Use when you need to check which channels have unread messages or mentions.
- revolt_get_user_profile(target: string) — Tool to retrieve a user's profile data including bio and background. Use when you need profile-specific information beyond basic user data. Will fail if you do not have permission to access the target
- revolt_get_users_default_avatar(target: string) — Tool to fetch a user's default avatar image based on their ID. Use when you need to retrieve the default avatar picture for a specific user.
- revolt_get_users_dm(target: string) — Tool to open a DM with another user. Use when you need to start or access a direct message conversation. If the target is oneself, returns a saved messages channel.
- revolt_get_users_dms() — Tool to fetch all direct message conversations for the authenticated user. Use when you need to list all DM and group DM channels.
- revolt_pin_message(msg: string, target: string) — Tool to pin a message in a channel by its ID. Use when you need to highlight important messages for channel members.
- revolt_remove_message_reaction(msg: string, emoji: string, target: string, user_id?: string, remove_all?: boolean) — Tool to remove a reaction from a message. Use when you need to remove your own, someone else's, or all reactions of a given emoji from a message. Requires ManageMessages permission if removing others'
- revolt_send_channels_messages(flags?: integer, nonce?: string, embeds?: object[], target: string, content?: string, replies?: object[], masquerade?: object, attachments?: string[], interactions?: object, idempotency_key?: string) — Tool to send a message to a Revolt channel. Use when you need to post a text message, embed, or attachment to a specific channel. Call after authenticating with bot token.
- revolt_unblock_user(target: string) — Tool to unblock another user by their ID. Use when you need to remove a block on a specific user. The relationship status will change from 'Blocked' to 'None' after successful execution.
- revolt_unpin_message(channel_id: string, message_id: string) — Tool to unpin a message in a channel. Use when you need to remove a pinned message from the channel's pinned messages list.
- revolt_update_channels_messages(msg: string, embeds?: object[], target: string, content?: string) — Tool to edit a message that you've previously sent in a channel. Use when you need to update the content or embeds of an existing message. At least one of content or embeds must be provided.
- revolt_update_user(clear?: string[], avatar?: string, user_id: string, status_text?: string, profile_content?: string, profile_background?: string) — Tool to update user information. Use when you need to modify user profile or status fields. Call after authenticating with bot token.

## Example prompts
- "What can I do in Revolt?"
- "Show me a summary of my Revolt account"

## Links
Docs: https://mcp.ai/docs/mcps/revolt
Website: https://mcp.ai/mcps/revolt