How to Use the Flock MCP in Mastra AI

Q: Can I audit Flock access with Mastra AI?

Yes. You can run groupslistprivate periodically to check for permission drift. It returns the current state of your private group boundaries.

Q: Does Mastra AI support FlockML formatting?

It does. You pass your FlockML string to chatsendmessage, and the tool handles the conversion to ensure the message renders correctly.

Q: Can I automate channel management in Flock with Mastra AI?

You can. Use channelslistpublic to audit active channels and channelsgetinfo to pull descriptions for your agent's knowledge base.

Build reliable Flock workflows that handle failures automatically with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Flock MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Flock messaging workflows

Chain your logic using `chat_send_message`. If the API hits a limit, your workflow engine handles the retry logic for you. It ensures your alerts actually arrive. You define the flow, and the server manages the execution state.

Secure Flock group management

Verify access boundaries with `groups_get_info` before performing actions. It returns deep internal credentials to confirm the agent has the right clearance. This prevents unauthorized actions. You only act once the tool validates the group permissions.

Dynamic roster lookups for agents

Use `roster_list_directory` to find personnel in real-time. The agent queries the directory to find the right person for an escalation. It automates the search. The agent finds the target UUID and acts immediately without manual intervention.

Setup guide

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

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

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

You configure exponential backoff in your agent workflow. It monitors the `chat_send_message` response and waits if the API rate limit is exceeded.

Yes. You can run `groups_list_private` periodically to check for permission drift. It returns the current state of your private group boundaries.

It does. You pass your FlockML string to `chat_send_message`, and the tool handles the conversion to ensure the message renders correctly.

The server uses a zero-trust model. It only accesses the specific identity metadata you explicitly authorize through the tool set.

You can. Use `channels_list_public` to audit active channels and `channels_get_info` to pull descriptions for your agent's knowledge base.

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

Mastra AI sdk-typescript

Start using the Flock MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started