How to Use the Whereby MCP in Mastra AI

Q: How does Mastra AI handle scheduling meetings with Whereby?

Your agent uses createmeetingroom, supplying the required end date and mode. The system handles the creation of the transient room, which is ideal for automated workflows.

Q: What should I do if my workflow fails to delete a room using Mastra AI?

You must use deletemeetingroom. Be aware that this action is irreversible, so your workflow needs confirmation before executing it.

Q: Can the MCP Server list all available Whereby tools for Mastra AI?

Yes. You call mcpClient.listTools() to get a full manifest of every operation, allowing you to build complex, multi-step failure handling routines.

Q: Whereby and Mastra AI: What is the permanence of recording deletion?

Calling deletecloudrecording permanently removes the file. This action cannot be undone by any process connected to this MCP Server.

Build complex multi-step video calling workflows using Mastra AI's structured MCP Server calls.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Whereby MCP to Mastra AI

Create your Vinkius account to connect Whereby 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 Whereby with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Lifecycle Management of Video Rooms

Use `create_meeting_room` to spin up a new, transient video call. You pass an ISO 8601 end date and the desired mode—normal or group. When done with a room, use `delete_meeting_room`. This terminates any active session and removes the meeting room data.

Extracting Video Content Details

`get_recording_details` pulls download links and metadata for specific cloud recordings. You can also run `list_cloud_recordings` to get a full inventory of what's stored in the Whereby account. Need a room URL? Call `get_meeting_details` to fetch join information and check the expiration date.

Controlling Visual Branding

`update_room_theme` lets you change a meeting room's primary brand color using a hex code, provided you give it the correct room name. If the theme is wrong, `reset_room_theme` reverts it to default. The `get_room_theme` tool lets your workflow check what colors and logos are currently set for any given room.

Setup guide

Set up Whereby 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 Whereby 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: "whereby-mcp-client",
  servers: {
    "whereby-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Whereby 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 Whereby. 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 Whereby 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 Whereby MCP in Mastra AI

Your agent uses `create_meeting_room`, supplying the required end date and mode. The system handles the creation of the transient room, which is ideal for automated workflows.

The server manages video meeting details (URLs, expiration dates), theme settings (colors/logos), and cloud recording metadata.

You must use `delete_meeting_room`. Be aware that this action is irreversible, so your workflow needs confirmation before executing it.

Yes. You call `mcpClient.listTools()` to get a full manifest of every operation, allowing you to build complex, multi-step failure handling routines.

Calling `delete_cloud_recording` permanently removes the file. This action cannot be undone by any process connected to this MCP Server.

Use it with your favorite AI tools

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