Revolt MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Revolt MCP or direct API to send messages, manage channels, fetch chat history, and automate notifications through natural language.

Revolt logoRevolt
Api Key

Revolt is a free, open-source chat platform for secure, customizable group and 1:1 messaging. Enjoy privacy-first conversations and seamless team collaboration without vendor lock-in.

26 Tools

Try Revolt now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Revolt
Try asking
TOOLS

Supported Tools

Every Revolt action and event your agent gets out of the box.

Acknowledge Policy Changes

Tool to acknowledge platform policy changes.

Add Reaction to Message

Tool to add a reaction to a message in a channel.

Block User

Tool to block another user by their ID.

Create Sync Settings

Tool to upload and save settings data to Revolt's sync storage.

Delete Message

Tool to delete a message you've sent or one you have permission to delete.

Bulk Delete Messages

Tool to bulk delete multiple messages from a channel.

Fetch Owned Bots

Tool to fetch all bots that you have control over.

Fetch Sync Settings

Tool to fetch settings from server filtered by keys.

Fetch user

Tool to fetch detailed information about a user.

Fetch User Flags

Tool to fetch flags associated with a specific user.

Get API Info

Tool to fetch the server configuration for this Revolt instance.

Get Channel

Tool to fetch a channel by its ID.

Get Current User

Tool to retrieve your own user information.

Get Invite

Tool to fetch detailed information about an invite by its code.

Get Sync Unreads

Tool to fetch information about unread state on channels.

Get User Profile

Tool to retrieve a user's profile data including bio and background.

Get User's Default Avatar

Tool to fetch a user's default avatar image based on their ID.

Open DM with User

Tool to open a DM with another user.

Get User DMs

Tool to fetch all direct message conversations for the authenticated user.

Pin Message

Tool to pin a message in a channel by its ID.

Remove Message Reaction

Tool to remove a reaction from a message.

Send Channel Message

Tool to send a message to a Revolt channel.

Unblock User

Tool to unblock another user by their ID.

Unpin Message

Tool to unpin a message in a channel.

Update Channel Message

Tool to edit a message that you've previously sent in a channel.

Update User

Tool to update user information.

SETUP GUIDE

Connect Revolt MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Fetch user details for user ID 12345' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Revolt API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Revolt Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Fetch detailed profile for user ID 8df7a2'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Revolt actions with your Agent

Why Use Composio?

AI Native Revolt Integration

  • Supports both Revolt MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for sending, receiving, and managing Revolt messages and channels

Managed Auth

  • Built-in API key management for Revolt with secure storage
  • Central place to manage, scope, and revoke Revolt access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Revolt
  • Scoped, least privilege access to Revolt resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Revolt requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Revolt.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Revolt tool your agent needs.Free to start.

Start building