{
  "info": {
    "name": "Ably — mcp.ai",
    "description": "REST API for the Ably MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/ably",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "ably_batch_presence",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/batch/presence",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "batch",
            "presence"
          ]
        },
        "description": "This tool enables querying the presence states of multiple channels in a single API request. The API retrieves the member presence details of the specified channels in parallel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channels\": \"\",\n  \"separator\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_batch_presence_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/batch/presence/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "batch",
            "presence",
            "history"
          ]
        },
        "description": "This tool enables querying presence history for multiple channels in a single API request. It uses the GET endpoint at https://rest.ably.io/presence to retrieve the member presence history details of ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end\": 0,\n  \"limit\": 0,\n  \"start\": 0,\n  \"channels\": \"\",\n  \"direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_delete_channel_subscription",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/channel/subscription",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "channel",
            "subscription"
          ]
        },
        "description": "This tool allows you to unsubscribe devices or clients from push notifications for specific channels. The operation is asynchronous, so immediate requests after deletion may briefly still return the s",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channel\": \"\",\n  \"client_id\": \"\",\n  \"device_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_channel_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/channel/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "channel",
            "details"
          ]
        },
        "description": "This tool retrieves metadata and details for a specific channel in Ably. It returns a ChannelDetails object containing information about the channel's status, occupancy, and other metadata. The endpoi",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channel_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_channel_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/channel/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "channel",
            "history"
          ]
        },
        "description": "This tool retrieves the message history for a specified Ably channel. It uses the GET /channels/{channelId}/messages endpoint to return a paginated list of messages in chronological order, subject to ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end\": 0,\n  \"limit\": 0,\n  \"start\": 0,\n  \"direction\": \"\",\n  \"channel_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_channel_presence",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/channel/presence",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "channel",
            "presence"
          ]
        },
        "description": "Tool to obtain the set of members currently present for a channel. Use when you need to check which clients are currently connected and active on a specific Ably channel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"format\": \"\",\n  \"clientId\": \"\",\n  \"channel_id\": \"\",\n  \"connectionId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_message_versions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/message/versions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "message",
            "versions"
          ]
        },
        "description": "Tool to retrieve all historical versions of a specific message from an Ably channel. Use when you need to track message history, including the original message and all subsequent updates or delete ope",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"serial\": \"\",\n  \"channel_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_presence_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/presence/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "presence",
            "history"
          ]
        },
        "description": "This tool retrieves the history of presence messages for a specified channel in Ably. It allows you to query presence events on a channel within a given time period.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end\": 0,\n  \"limit\": 0,\n  \"start\": 0,\n  \"direction\": \"\",\n  \"channel_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_push_device",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/push/device",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "push",
            "device"
          ]
        },
        "description": "Tool to get the full details of a device registration for push notifications. Use when you need to retrieve information about a specific device registered for push notifications, including its platfor",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"format\": \"\",\n  \"device_id\": \"\",\n  \"X_Ably_Version\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_service_time",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/service/time",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "service",
            "time"
          ]
        },
        "description": "This tool retrieves the current server time from Ably's service in milliseconds since the epoch. It is particularly useful for time synchronization and generating valid TokenRequest timestamps to prev",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_get_stats",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/stats",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "stats"
          ]
        },
        "description": "This tool retrieves your application's usage statistics from Ably. The stats endpoint returns a paginated list of your application's usage statistics by minute, hour, day, or month. It supports option",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end\": 0,\n  \"unit\": \"\",\n  \"limit\": 0,\n  \"start\": 0,\n  \"direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_list_channels",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/channels",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "channels"
          ]
        },
        "description": "Tool to enumerate all active channels in the Ably application. Use when you need to discover available channels or monitor channel activity. Returns paginated results and is heavily rate-limited. Can ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"by\": \"\",\n  \"limit\": 0,\n  \"format\": \"\",\n  \"prefix\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_list_push_channel_subscriptions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/push/channel/subscriptions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "push",
            "channel",
            "subscriptions"
          ]
        },
        "description": "This tool retrieves a list of all push notification channel subscriptions. It allows you to view all active push notification subscriptions for channels in your Ably application. Allows filtering by c",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"channel\": \"\",\n  \"client_id\": \"\",\n  \"device_id\": \"\",\n  \"concat_filters\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_list_push_channels",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/push/channels",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "push",
            "channels"
          ]
        },
        "description": "Tool to list all channels with at least one subscribed device. Use when you need to discover which channels have active push notification subscriptions in your Ably application.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"format\": \"\",\n  \"x_ably_version\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_list_registered_push_devices",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/registered/push/devices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "registered",
            "push",
            "devices"
          ]
        },
        "description": "Tool to list all devices registered for receiving push notifications in your Ably application. Use when you need to view, filter, or audit push notification device registrations. Supports filtering by",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"format\": \"\",\n  \"clientId\": \"\",\n  \"deviceId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_patch_push_device_registration",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/patch/push/device/registration",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "patch",
            "push",
            "device",
            "registration"
          ]
        },
        "description": "Tool to partially update specific attributes of an existing device registration in Ably's push notification system. Use when you need to modify device properties like formFactor, clientId, platform, o",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"format\": \"\",\n  \"clientId\": \"\",\n  \"deviceId\": \"\",\n  \"metadata\": {},\n  \"platform\": \"\",\n  \"pushState\": \"\",\n  \"formFactor\": \"\",\n  \"deviceSecret\": \"\",\n  \"xAblyVersion\": \"\",\n  \"pushRecipient\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_publish_batch_messages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/publish/batch/messages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "publish",
            "batch",
            "messages"
          ]
        },
        "description": "Tool to batch publish messages to multiple channels in parallel. Use when you need to send the same set of messages to multiple channels simultaneously for efficient broadcasting.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channels\": \"\",\n  \"messages\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_publish_message_to_channel",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/publish/message/to/channel",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "publish",
            "message",
            "to",
            "channel"
          ]
        },
        "description": "This tool will allow users to publish a message to a specified Ably channel using a POST request. It covers the essentials like channel name, message data, optional event name/type, and additional met",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"client_id\": \"\",\n  \"channel_id\": \"\",\n  \"event_name\": \"\",\n  \"message_id\": \"\",\n  \"message_data\": \"\",\n  \"push_notification\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_publish_push_notification",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/publish/push/notification",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "publish",
            "push",
            "notification"
          ]
        },
        "description": "Tool to publish a push notification directly to device(s) via Ably's Push Notifications API. Use when you need to send push notifications to specific devices identified by device ID, client ID, or pla",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"push\": {},\n  \"recipient\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_publish_push_notifications_batch",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/publish/push/notifications/batch",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "publish",
            "push",
            "notifications",
            "batch"
          ]
        },
        "description": "Tool to batch publish push notifications directly to specific recipients. Use when you need to send multiple push notifications efficiently in a single request. Supports up to 10,000 notifications per",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"items\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_register_push_device",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/register/push/device",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "register",
            "push",
            "device"
          ]
        },
        "description": "Tool to register a device for receiving push notifications in Ably. Use when you need to enable push notifications for a specific device across various platforms including iOS (APNs), Android (FCM/GCM",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"metadata\": {},\n  \"platform\": \"\",\n  \"client_id\": \"\",\n  \"push_state\": \"\",\n  \"form_factor\": \"\",\n  \"device_secret\": \"\",\n  \"push_recipient\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_request_access_token",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/request/access/token",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "request",
            "access",
            "token"
          ]
        },
        "description": "Request an access token for Ably authentication. Use this when you need to generate a token with specific capabilities and client identifiers for secure authentication. The token can be used to authen",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ttl\": 0,\n  \"nonce\": \"\",\n  \"key_name\": \"\",\n  \"client_id\": \"\",\n  \"timestamp\": 0,\n  \"capability\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_unregister_all_push_devices",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/unregister/all/push/devices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "unregister",
            "all",
            "push",
            "devices"
          ]
        },
        "description": "Tool to unregister matching devices for push notifications. Use when you need to remove device registrations from Ably's push notification system. You can filter by deviceId or clientId, but not both ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"client_id\": \"\",\n  \"device_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_unregister_push_device",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/unregister/push/device",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "unregister",
            "push",
            "device"
          ]
        },
        "description": "Tool to unregister a single device from push notifications in Ably. Use when you need to remove a device's push notification registration. This permanently removes the device from receiving push notif",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"format\": \"\",\n  \"device_id\": \"\",\n  \"X-Ably-Version\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ably_update_push_device",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/push/device",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "push",
            "device"
          ]
        },
        "description": "Tool to update (upsert) a device registration for push notifications in Ably. Use when registering a new device or updating an existing device's push notification configuration. This is an upsert oper",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"metadata\": {},\n  \"platform\": \"\",\n  \"client_id\": \"\",\n  \"device_id\": \"\",\n  \"push_state\": \"\",\n  \"form_factor\": \"\",\n  \"device_secret\": \"\",\n  \"push_recipient\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}