How to Use the Ably MCP in Mastra AI

Give your Mastra AI workflows reliable access to Ably. This MCP Server lets your agents manage messaging with built-in retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ably MCP to Mastra AI

Create your Vinkius account to connect Ably to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Ably with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate message broadcasting workflows

Workflows rely on `publish_message` to send critical alerts when a specific condition triggers in your logic. If an initial check fails, Mastra catches the error and retries the publish action with exponential backoff. For larger operations, agent branches format payloads and hand them to `batch_publish`. This hits multiple channels at once, and you can require human approval before the MCP server actually fires the request.

Build conditional logic on Ably presence

Your agent uses `get_presence` to check if a support rep is online before routing an urgent ticket. If the channel is empty, the workflow automatically branches to a fallback notification system. You can also monitor system health. Call `get_stats` to pull application usage metrics, then write a conditional step that alerts your DevOps team if connection limits are approaching.

Manage token revocation via Mastra AI MCP Server

Security workflows trigger `revoke_tokens` to instantly kill active sessions when suspicious behavior is detected. The agent handles the immediate invalidation without waiting for manual admin intervention. You need an API key with revocable access enabled for this to work. Once configured, your workflow isolates compromised users and logs the exact time of token expiry.

Setup guide

Set up Ably MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Ably tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "ably-mcp-client",
  servers: {
    "ably-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Ably Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Ably tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Ably transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Ably. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Ably now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Ably MCP in Mastra AI

Use new MCPClient and pass your Vinkius server URL in the servers object. Mastra automatically detects the streamable HTTP transport. Spread mcpClient.listTools() into your agent configuration.

You can set requireToolApproval for any destructive or high-impact action. The workflow pauses and waits for a human to confirm the push payload before execution.

The framework's workflow engine catches the failure. It automatically retries the publish tool using exponential backoff based on your configuration.

Your agent calls the message history tool to read past events. It then parses that data to decide which path a workflow should take next.

Your channel metadata and token revocation requests run inside a zero-trust Vinkius sandbox. The environment processes the API keys and user IDs to complete the step, then immediately wipes the memory. We keep zero logs of your real-time traffic.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript