How to integrate Ably MCP with Atomic Agent

Connect Atomic Agent to Ably MCP. List all active channels and their details, get message history from 'support-chat' channel, and more using natural language, with authentication handled for you.

Ably logoAbly
Api Key

Ably is a real-time messaging platform for live chat and data sync in modern apps. It offers global scale and rock-solid reliability for seamless, instant experiences.

25 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,700+ apps through Composio, including Ably.

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 Ably account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Ably with

How Atomic Agent connects to Ably

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 Ably 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 Ably. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Ably 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 Ably MCP server, and what's possible with it?

The Ably MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Ably account. It provides structured and secure access to your channels, messages, presence data, application statistics, and push notifications, so your agent can publish messages, inspect active channels, review channel history, monitor presence, and manage push notifications on your behalf.

  • Channel messaging: Have your agent publish a message to one channel or send batches of messages across multiple channels.
  • Channel activity and history: Let the agent list active channels, retrieve channel details, review message history, and inspect earlier versions of a message.
  • Presence monitoring: Direct your agent to check who is currently present in one or more channels and review past presence activity.
  • Push notification management: Instruct your agent to send individual or batch push notifications, manage channel subscriptions, and register, update, inspect, or unregister receiving devices.
  • Application insights: Have your agent retrieve Ably service time and review application usage statistics.

Use Ably from Atomic Agent

With your account connected, ask Atomic Agent to work with Ably 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 Ably action and event your agent gets out of the box.

Query Batch Presence

Queries the presence states of multiple Ably channels in a single request, retrieving member presence details for the specified channels.

Query Batch Presence History

Query presence history for multiple Ably channels, with optional start and end times and forwards or backwards ordering.

Delete Channel Subscription

Unsubscribes a device or client from push notifications for a specified channel, or across all channels if no channel is provided.

Get Channel Details

Retrieves status and occupancy metadata for a specific Ably channel, including connection, presence, publisher, and subscriber metrics.

Get Channel History

Retrieves a page of message history for a specified Ably channel, with time range, limit, and direction filters.

Get Channel Presence

Tool to obtain the set of members currently present for a channel.

Get Message Versions

Retrieves a page of historical versions of a specific Ably channel message, including the original and subsequent updates or deletes.

Get Channel Presence History

This tool retrieves the history of presence messages for a specified channel in Ably.

Get Push Device Registration

Retrieves a device's push registration by device ID, including available platform, state, recipient, and metadata fields.

Get Ably Service Time

This tool retrieves the current server time from Ably's service in milliseconds since the epoch.

Get Application Stats

Retrieve a page of Ably application usage statistics by minute, hour, day or month, with optional time range, direction and limit.

List Channels

Tool to enumerate all active channels in the Ably application.

List Push Channels

Lists a page of Ably channels with at least one subscribed device for push notifications.

List Push Channel Subscriptions

Lists a page of push channel subscriptions filtered by channel, client ID, or device ID, with pagination links; at least one filter is required.

List Registered Push Devices

List a page of Ably push device registrations, optionally filtered by device ID or client ID.

Patch Push Device Registration

Partially update an existing Ably push device registration.

Batch Publish Messages

Tool to batch publish messages to multiple channels in parallel.

Publish Message to Channel

Publishes a message to a specified Ably channel with a string or JSON object payload and an optional event name and client ID.

Publish Push Notification

Tool to publish a push notification directly to device(s) via Ably's Push Notifications API.

Batch Publish Push Notifications

Tool to batch publish push notifications directly to specific recipients.

Register Push Device

Register an iOS, Android, or browser device with Ably to receive push notifications.

Request Access Token

Request an Ably access token with optional capabilities, client ID and lifetime.

Unregister All Push Devices

Unregister matching Ably push devices, optionally filtering by device ID or client ID, but not both.

Unregister Push Device

Unregister a single Ably push device by device ID.

Update Push Device Registration

Upsert an Ably push device registration, creating it or replacing an existing registration.

FAQ

Frequently asked questions

Start with Ably.It takes 30 seconds.

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

Start building