How to Use the Alai MCP in Mastra AI

Q: How do I integrate Alai with Mastra AI?

Initialize an MCPClient with your Vinkius URL. Call mcpClient.listTools() and spread the resulting array directly into your agent's tool configuration.

Q: Can Mastra AI automatically retry failed Alai generations?

The framework handles connection drops natively. If the generatecontent request times out, the workflow engine waits and tries again based on your backoff settings.

Q: How do I list active projects using this integration?

Add listcampaigns to your agent's permitted actions. The agent will fetch the current database records and route them to the next step in your workflow.

Build reliable marketing automation workflows with Alai and 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 Alai MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Conditional Campaign Logic in Mastra AI

Alai executes complex marketing operations by connecting your headshot generation pipeline to an MCP Server inside Mastra's workflow engine. If a portrait fails quality checks, the agent automatically retries `generate_content` with a different template parameter. Handling API timeouts is a nightmare when generating large visual assets. Mastra's exponential backoff wraps around `get_generation` to ensure your system never drops a client request due to a temporary network hiccup.

Automated Asset Pipelines

Alai processes hundreds of profile photos at once for busy marketing teams. You map `list_assets` to a loop that feeds individual IDs into `get_asset` for bulk downloading and archiving. When a contract ends, privacy rules demand immediate file deletion. Your workflow triggers `delete_asset` across the entire campaign, logging each successful removal before marking the job complete.

Human-in-the-Loop Content Approval

Alai requires a final visual check for studio-quality business portraits. You configure `create_campaign` with Mastra's `requireToolApproval` flag so a manager can review the output before it goes live. The system pauses execution and sends an alert. Once the human clicks approve, the agent resumes the sequence and distributes the assets to the designated channels.

Setup guide

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

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

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

Initialize an `MCPClient` with your Vinkius URL. Call `mcpClient.listTools()` and spread the resulting array directly into your agent's tool configuration.

The framework handles connection drops natively. If the `generate_content` request times out, the workflow engine waits and tries again based on your backoff settings.

The client auto-detects the transport layer upon connection. It switches instantly between SSE and HTTP depending on the endpoint configuration.

Add `list_campaigns` to your agent's permitted actions. The agent will fetch the current database records and route them to the next step in your workflow.

Employee profile photos hit an ephemeral sandbox that executes the transformation and immediately dies. The MCP integration ensures zero-trust data handling, meaning no biometric information survives past the active session.

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