How to integrate Sendbird MCP with Atomic Agent

Connect Atomic Agent to Sendbird MCP. Add users to a group chat channel, ban a disruptive user from group chat, and more using natural language, with authentication handled for you.

Sendbird logoSendbird
Api Key

Sendbird is a developer platform for adding chat, voice, and video to apps. It helps businesses deliver real-time, in-app communication experiences.

37 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Sendbird.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Sendbird account. See the Atomic Agent documentation for installation instructions.

Also integrate Sendbird with

How Atomic Agent connects to Sendbird

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Sendbird to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Sendbird. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Sendbird account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Sendbird MCP server, and what's possible with it?

The Sendbird MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Sendbird account. It provides structured and secure access to your in-app chat, voice, and video features, so your agent can perform actions like creating group channels, managing users, moderating conversations, and tracking unread message counts on your behalf.

  • Group channel management: Let your agent create new group channels, add or ban members, and delete channels as needed to keep conversations organized and secure.
  • User account administration: Automatically register new users or remove users from your Sendbird application, simplifying user lifecycle management.
  • Message moderation and cleanup: Empower your agent to delete specific messages—helping enforce community guidelines and remove unwanted content instantly.
  • Unread count and status tracking: Retrieve up-to-date counts of unread messages, mentions, and channel invitations for any user to surface important conversations.
  • Channel preference insights: Access and update user count preferences in group channels, tailoring notification and message delivery based on user needs.

Use Sendbird from Atomic Agent

With your account connected, ask Atomic Agent to work with Sendbird in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

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

Add Members To Group Channel

Tool to add members to a group channel.

Ban User from Group Channel

Tool to ban a user from a group channel.

Create Group Channel

Tool to create a new group channel.

Create Sendbird User

Creates a new user in Sendbird.

Delete Group Channel

Permanently deletes a Sendbird group channel.

Delete Message

Permanently deletes a specific message from a Sendbird group channel.

Delete Sendbird User

Tool to delete a Sendbird user.

Get Count Preference Of Channel

Tool to retrieve a user's count preference for a specific group channel.

Get User Group Channel Count by Join Status

Retrieves the number of group channels for a user, categorized by join status (joined, invited, etc.

Sendbird Get Unread Item Count

Tool to retrieve a user's unread item counts including unread messages, mentions, and pending invitations across group channels.

Issue Session Token

Issues a session token for authenticating a Sendbird user.

Leave Group Channels

Tool to leave group channels for a user.

List Banned Members

Tool to list banned members in a group channel.

Sendbird List Group Channel Messages

Tool to list (paginate) messages in a group channel when you only know the channel_url.

List Group Channels

Tool to list group channels.

List Group Channel Members

Tool to list members of a group channel.

List Operators by Custom Channel Type

Tool to list operators of a channel by custom channel type.

List Group Channel Operators

Tool to list operators of a group channel.

List Open Channel Operators

Tool to list operators of an open channel.

List Sendbird Users

Retrieves a paginated list of users from your Sendbird application.

Mark All User Messages As Read

Tool to mark all of a user's messages as read in group channels.

Mute User

Tool to mute a user in a group channel.

Register Operators by Custom Channel Type

Registers one or more users as operators for all channels with a specified custom channel type.

Register Group Channel Operators

Tool to register one or more users as operators in a Sendbird group channel.

Register Operators to Open Channel

Tool to register operators to an open channel.

Revoke All Session Tokens

Tool to revoke all session tokens for a user.

Send Message

Tool to send a message to a group channel.

Unban User from Group Channel

Tool to unban a user from a group channel.

Unmute User

Tool to unmute a user in a group channel.

Unregister Operators Custom Channel Type

Tool to unregister operators from channels by custom channel type.

Update Count Preference Of Channel

Tool to update a user's unread count preference for a specific group channel.

Update Group Channel

Tool to update group channel information.

Sendbird Update Message

Tool to update an existing group channel message in Sendbird.

Update Sendbird User

Tool to update a user's information.

Sendbird View Group Channel

Tool to view information about a specific group channel.

Sendbird View Message

Tool to view a specific message in a group channel.

View User

Tool to retrieve information about a specific Sendbird user.

FAQ

Frequently asked questions

With a standalone Sendbird MCP server, the agents and LLMs can only access a fixed set of Sendbird tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Sendbird and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Sendbird tools.

Yes, absolutely. You can configure which Sendbird scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Sendbird data and credentials are handled as safely as possible.

Start with Sendbird.It takes 30 seconds.

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

Start building