How to Use the Evolio MCP in Mastra AI

Q: How do I initialize the Evolio server in Mastra AI?

Instantiate a new MCPClient and pass the Evolio endpoint URL in the servers object. Then call listTools() and spread them into your agent's tool array.

Q: How do I chain Evolio client creation and case assignment in Mastra AI?

Write a workflow that first executes getclient to verify they exist, then passes that ID directly into createcase in the next conditional branch.

Q: Is client data secure when running Mastra AI workflows?

Sensitive coaching tasks and progress metrics processed by gettask run through a zero-trust architecture. The managed environment authenticates via a single endpoint token and never logs the payload contents to disk.

Wire up resilient coaching workflows and automated task branching using Mastra AI and the Evolio MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Evolio MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Conditional Case Routing

The `list_cases_by_status` and `update_case` tools let your Mastra AI agent evaluate coaching progress and route logic accordingly. If a case sits idle for two weeks, the workflow engine automatically branches to a re-engagement sequence. You define the exact triggers. The agent checks `get_task`, and if the client missed their homework, it loops back and creates a follow-up via `create_task` with built-in exponential backoff if the API limits out.

Automate Evolio MCP Server Pipelines

Onboarding a new coaching client requires calling `create_case` followed by multiple `create_task` executions. Mastra handles this multi-step process without dropping data if a step fails. If the connection blips during `list_client_files`, the framework just retries the specific tool call. You stop writing custom error handling and let the agent manage the state.

Require Approval for Updates

Turn on `requireToolApproval` in Mastra before executing destructive actions like `update_case`. The workflow pauses, alerts an admin, and waits for human sign-off. Use `check_evolio_status` as an initial health check before kicking off massive syncs with `list_cases`. Your pipelines run predictably and fail gracefully.

Setup guide

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

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

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

Instantiate a new `MCPClient` and pass the Evolio endpoint URL in the servers object. Then call `listTools()` and spread them into your agent's tool array.

Yes. The framework includes automatic retries with exponential backoff. If the API times out, it tries again before failing the entire workflow.

Write a workflow that first executes `get_client` to verify they exist, then passes that ID directly into `create_case` in the next conditional branch.

Mastra auto-detects the transport layer. It negotiates Streamable HTTP or SSE automatically based on what the server endpoint supports.

Sensitive coaching tasks and progress metrics processed by `get_task` run through a zero-trust architecture. The managed environment authenticates via a single endpoint token and never logs the payload contents to disk.

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