Ably MCP by usefulapi is an MCP server published by io.usefulapi, hosted at ably.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 15 tools, including ably_get_channel_history, ably_get_presence, ably_get_presence_history, ably_get_channel_details, ably_list_channels.
MCP server for Ably — channel history, presence, occupancy, stats, publish, and app management.
4,077 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Retrieve historical messages published to a channel, newest-first by default. REST: GET /channels/{channel}/messages.
| Parameter | Type | Description |
|---|---|---|
| end | integer | Latest message time, ms since epoch (inclusive). |
| limit | integer | Max messages (<=1000). Default 100. |
| start | integer | Earliest message time, ms since epoch (inclusive). |
| channel * | string | Channel name, e.g. 'chat:room1'. |
| direction | string | forwards (oldest-first) or backwards (newest-first, default). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "ably_get_channel_history",
"title": "Get channel message history",
"description": "Retrieve historical messages published to a channel, newest-first by default. REST: GET /channels/{channel}/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"channel"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Latest message time, ms since epoch (inclusive)."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max messages (<=1000). Default 100.",
"exclusiveMinimum": 0
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Earliest message time, ms since epoch (inclusive)."
},
"channel": {
"type": "string",
"description": "Channel name, e.g. 'chat:room1'."
},
"direction": {
"enum": [
"forwards",
"backwards"
],
"type": "string",
"description": "forwards (oldest-first) or backwards (newest-first, default)."
}
}
},
"annotations": {
"title": "Get channel message history",
"readOnlyHint": true
}
}List the members currently present on a channel (who is online now). REST: GET /channels/{channel}/presence.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max members (<=1000). Default 100. |
| channel * | string | Channel name. |
| clientId | string | Filter to a specific clientId. |
| connectionId | string | Filter to a specific connectionId. |
{
"name": "ably_get_presence",
"title": "Get channel presence set",
"description": "List the members currently present on a channel (who is online now). REST: GET /channels/{channel}/presence.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"channel"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max members (<=1000). Default 100.",
"exclusiveMinimum": 0
},
"channel": {
"type": "string",
"description": "Channel name."
},
"clientId": {
"type": "string",
"description": "Filter to a specific clientId."
},
"connectionId": {
"type": "string",
"description": "Filter to a specific connectionId."
}
}
},
"annotations": {
"title": "Get channel presence set",
"readOnlyHint": true
}
}Retrieve historical presence events (enter/leave/update) for a channel. REST: GET /channels/{channel}/presence/history.
| Parameter | Type | Description |
|---|---|---|
| end | integer | Latest event time, ms since epoch (inclusive). |
| limit | integer | Max events (<=1000). Default 100. |
| start | integer | Earliest event time, ms since epoch (inclusive). |
| channel * | string | Channel name. |
| direction | string | forwards or backwards (default backwards). |
{
"name": "ably_get_presence_history",
"title": "Get channel presence history",
"description": "Retrieve historical presence events (enter/leave/update) for a channel. REST: GET /channels/{channel}/presence/history.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"channel"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Latest event time, ms since epoch (inclusive)."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max events (<=1000). Default 100.",
"exclusiveMinimum": 0
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Earliest event time, ms since epoch (inclusive)."
},
"channel": {
"type": "string",
"description": "Channel name."
},
"direction": {
"enum": [
"forwards",
"backwards"
],
"type": "string",
"description": "forwards or backwards (default backwards)."
}
}
},
"annotations": {
"title": "Get channel presence history",
"readOnlyHint": true
}
}Get status and occupancy metrics for a single channel (connections, publishers, subscribers, presence members). REST: GET /channels/{channel}.
| Parameter | Type | Description |
|---|---|---|
| channel * | string | Channel name. |
{
"name": "ably_get_channel_details",
"title": "Get channel details / occupancy",
"description": "Get status and occupancy metrics for a single channel (connections, publishers, subscribers, presence members). REST: GET /channels/{channel}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"channel"
],
"properties": {
"channel": {
"type": "string",
"description": "Channel name."
}
}
},
"annotations": {
"title": "Get channel details / occupancy",
"readOnlyHint": true
}
}Enumerate channels that are currently active in the app. Requires the API key to have the 'channel-metadata' capability. REST: GET /channels.
| Parameter | Type | Description |
|---|---|---|
| by | string | Return channel ids only ('id', default) or full details ('value'). |
| limit | integer | Max channels per page (<=1000). Default 100. |
| prefix | string | Only return channels whose name starts with this prefix. |
{
"name": "ably_list_channels",
"title": "List active channels",
"description": "Enumerate channels that are currently active in the app. Requires the API key to have the 'channel-metadata' capability. REST: GET /channels.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"by": {
"enum": [
"id",
"value"
],
"type": "string",
"description": "Return channel ids only ('id', default) or full details ('value')."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max channels per page (<=1000). Default 100.",
"exclusiveMinimum": 0
},
"prefix": {
"type": "string",
"description": "Only return channels whose name starts with this prefix."
}
}
},
"annotations": {
"title": "List active channels",
"readOnlyHint": true
}
}Retrieve message/connection/channel usage statistics for the app tied to the API key, bucketed by time. REST: GET /stats.
| Parameter | Type | Description |
|---|---|---|
| end | integer | End of range, ms since epoch (inclusive). |
| unit | string | Bucket size: minute | hour | day | month. Default minute. |
| limit | integer | Max buckets (<=1000). Default 100. |
| start | integer | Start of range, ms since epoch (inclusive). |
| direction | string | forwards or backwards (default backwards). |
{
"name": "ably_get_stats",
"title": "Get app statistics",
"description": "Retrieve message/connection/channel usage statistics for the app tied to the API key, bucketed by time. REST: GET /stats.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "End of range, ms since epoch (inclusive)."
},
"unit": {
"enum": [
"minute",
"hour",
"day",
"month"
],
"type": "string",
"description": "Bucket size: minute | hour | day | month. Default minute."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max buckets (<=1000). Default 100.",
"exclusiveMinimum": 0
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start of range, ms since epoch (inclusive)."
},
"direction": {
"enum": [
"forwards",
"backwards"
],
"type": "string",
"description": "forwards or backwards (default backwards)."
}
}
},
"annotations": {
"title": "Get app statistics",
"readOnlyHint": true
}
}Return the current Ably service time in ms since epoch. Useful for aligning start/end windows to the server clock. REST: GET /time.
No parameters.
{
"name": "ably_get_service_time",
"title": "Get Ably service time",
"description": "Return the current Ably service time in ms since epoch. Useful for aligning start/end windows to the server clock. REST: GET /time.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get Ably service time",
"readOnlyHint": true
}
}WRITE: publish a message to a channel. Every connected subscriber receives it in real time. This is a real, outward-facing side effect — confirm the channel and payload before calling. REST: POST /channels/{channel}/messages.
| Parameter | Type | Description |
|---|---|---|
| data * | string | Message payload (string; send JSON as a stringified value). |
| name | string | Optional event name for the message. |
| channel * | string | Channel name to publish to, e.g. 'chat:room1'. |
| clientId | string | Optional clientId to attribute the message to. |
{
"name": "ably_publish_message",
"title": "Publish a message to a channel",
"description": "WRITE: publish a message to a channel. Every connected subscriber receives it in real time. This is a real, outward-facing side effect — confirm the channel and payload before calling. REST: POST /channels/{channel}/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"channel",
"data"
],
"properties": {
"data": {
"type": "string",
"description": "Message payload (string; send JSON as a stringified value)."
},
"name": {
"type": "string",
"description": "Optional event name for the message."
},
"channel": {
"type": "string",
"description": "Channel name to publish to, e.g. 'chat:room1'."
},
"clientId": {
"type": "string",
"description": "Optional clientId to attribute the message to."
}
}
},
"annotations": {
"title": "Publish a message to a channel",
"readOnlyHint": false,
"destructiveHint": true
}
}Return details about the configured control token: the account and user it belongs to and its capabilities. Good first call to confirm control-plane access. Control API: GET /me.
No parameters.
{
"name": "ably_whoami",
"title": "Get control token / account info",
"description": "Return details about the configured control token: the account and user it belongs to and its capabilities. Good first call to confirm control-plane access. Control API: GET /me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get control token / account info",
"readOnlyHint": true
}
}List all apps in the account (id, name, status, tls-only). Account id is resolved automatically from the control token when ABLY_ACCOUNT_ID is unset. Control API: GET /accounts/{account_id}/apps.
| Parameter | Type | Description |
|---|---|---|
| account_id | string | Override the account id (defaults to the token's account). |
{
"name": "ably_list_apps",
"title": "List Ably apps",
"description": "List all apps in the account (id, name, status, tls-only). Account id is resolved automatically from the control token when ABLY_ACCOUNT_ID is unset. Control API: GET /accounts/{account_id}/apps.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"account_id": {
"type": "string",
"description": "Override the account id (defaults to the token's account)."
}
}
},
"annotations": {
"title": "List Ably apps",
"readOnlyHint": true
}
}List the API keys for an app, including their capabilities (but not the full secret). Control API: GET /apps/{app_id}/keys.
| Parameter | Type | Description |
|---|---|---|
| app_id * | string | App id (from ably_list_apps). |
{
"name": "ably_list_keys",
"title": "List an app's API keys",
"description": "List the API keys for an app, including their capabilities (but not the full secret). Control API: GET /apps/{app_id}/keys.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"app_id"
],
"properties": {
"app_id": {
"type": "string",
"description": "App id (from ably_list_apps)."
}
}
},
"annotations": {
"title": "List an app's API keys",
"readOnlyHint": true
}
}List the channel namespaces (channel-rule prefixes) configured for an app, e.g. persistence and push settings. Control API: GET /apps/{app_id}/namespaces.
| Parameter | Type | Description |
|---|---|---|
| app_id * | string | App id (from ably_list_apps). |
{
"name": "ably_list_namespaces",
"title": "List an app's channel namespaces",
"description": "List the channel namespaces (channel-rule prefixes) configured for an app, e.g. persistence and push settings. Control API: GET /apps/{app_id}/namespaces.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"app_id"
],
"properties": {
"app_id": {
"type": "string",
"description": "App id (from ably_list_apps)."
}
}
},
"annotations": {
"title": "List an app's channel namespaces",
"readOnlyHint": true
}
}List the Ably Queues (AMQP/STOMP message queues) provisioned for an app, with their state and messaging stats. Control API: GET /apps/{app_id}/queues.
| Parameter | Type | Description |
|---|---|---|
| app_id * | string | App id (from ably_list_apps). |
{
"name": "ably_list_queues",
"title": "List an app's queues",
"description": "List the Ably Queues (AMQP/STOMP message queues) provisioned for an app, with their state and messaging stats. Control API: GET /apps/{app_id}/queues.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"app_id"
],
"properties": {
"app_id": {
"type": "string",
"description": "App id (from ably_list_apps)."
}
}
},
"annotations": {
"title": "List an app's queues",
"readOnlyHint": true
}
}List the integration rules (reactor rules: webhooks, AWS Lambda/SQS/Kinesis, Kafka, Pulsar, etc.) configured for an app. Control API: GET /apps/{app_id}/rules.
| Parameter | Type | Description |
|---|---|---|
| app_id * | string | App id (from ably_list_apps). |
{
"name": "ably_list_rules",
"title": "List an app's integration rules",
"description": "List the integration rules (reactor rules: webhooks, AWS Lambda/SQS/Kinesis, Kafka, Pulsar, etc.) configured for an app. Control API: GET /apps/{app_id}/rules.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"app_id"
],
"properties": {
"app_id": {
"type": "string",
"description": "App id (from ably_list_apps)."
}
}
},
"annotations": {
"title": "List an app's integration rules",
"readOnlyHint": true
}
}Retrieve aggregated usage statistics across the whole account, bucketed by time. Account id is resolved from the control token when ABLY_ACCOUNT_ID is unset. Control API: GET /accounts/{account_id}/stats.
| Parameter | Type | Description |
|---|---|---|
| end | integer | End of range, ms since epoch (inclusive). |
| unit | string | Bucket size: minute | hour | day | month. Default minute. |
| limit | integer | Max buckets (<=1000). Default 100. |
| start | integer | Start of range, ms since epoch (inclusive). |
| account_id | string | Override the account id (defaults to the token's account). |
{
"name": "ably_get_account_stats",
"title": "Get account-level statistics",
"description": "Retrieve aggregated usage statistics across the whole account, bucketed by time. Account id is resolved from the control token when ABLY_ACCOUNT_ID is unset. Control API: GET /accounts/{account_id}/stats.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "End of range, ms since epoch (inclusive)."
},
"unit": {
"enum": [
"minute",
"hour",
"day",
"month"
],
"type": "string",
"description": "Bucket size: minute | hour | day | month. Default minute."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max buckets (<=1000). Default 100.",
"exclusiveMinimum": 0
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start of range, ms since epoch (inclusive)."
},
"account_id": {
"type": "string",
"description": "Override the account id (defaults to the token's account)."
}
}
},
"annotations": {
"title": "Get account-level statistics",
"readOnlyHint": true
}
}Tools for Ably, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of our live channels have people connected right now?"; "Show the last 20 messages sent on our orders channel today."; "How many messages did our app handle each day this past week?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Ably data. Free plan: 50 tool calls per month. Run ably_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run ably_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run ably_upgrade without a plan: it returns both plans, each with a payment link for the user to open. ably_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.