How to integrate Ably MCP with Atomic Agent

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 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.

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.

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 real-time messaging infrastructure, so your agent can manage channels, monitor presence, analyze usage, and handle messaging workflows for your applications.

• Channel management and creation: Seamlessly create, initialize, or retrieve real-time messaging channels so your agent can orchestrate chat, data sync, and collaboration features on demand.
• Presence tracking and analytics: Ask your agent to query current presence states or review historical presence data across multiple channels, gaining insights into user activity and engagement patterns.
• Message history and audit: Retrieve detailed message histories from any channel, enabling your agent to audit communication, recover missed messages, or analyze message flows for debugging and compliance.
• Push notification subscription management: Let your agent list, manage, or unsubscribe devices from push notification channels, ensuring targeted and controlled delivery of real-time alerts to clients.
• Application statistics and monitoring: Have your agent fetch in-depth usage metrics—like message counts, channel activity, and API request stats—so you can monitor health, optimize performance, and manage resources with confidence.

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.