How to Use the Virtuagym MCP in Mastra AI

Q: Can I use Mastra AI to automate Virtuagym event listing?

Yes. You can define a multi-step process that first calls listevents to get all dates, then uses those dates to check for specific required resources, ensuring the schedule is complete before reporting it.

Q: What happens if Virtuagym training data fails with Mastra AI?

Mastra AI handles failures gracefully. If listtrainers encounters an issue, the workflow won't stop; it will execute predefined retry logic or escalate the failure to a human for review.

Q: Does Mastra AI support Virtuagym profile lookups?

It does. You can build reliable workflows around getmember and searchmembers. The system ensures that if the member record is incomplete, it notifies an admin rather than failing silently.

Build reliable, multi-step Virtuagym workflows 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 Virtuagym MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage memberships and check member status.

When a membership needs checking or updating, you can sequence calls. First, use `list_memberships` to see all available plans. Then, run `search_members` to verify the client's current plan and history. Mastra AI handles this workflow: if the search fails (e.g., invalid ID), it won't just crash; it will automatically retry with a different method or notify an admin.

Schedule events and manage member records.

Handling bookings is complex, but Mastra AI makes it robust. Use `list_events` to pull the schedule, then use `get_member` to verify the user exists. The agent framework ensures that if one step fails—say, payment processing—it triggers a defined fallback action. This built-in failure handling is crucial for any production system dealing with client data.

Configure workout and nutrition programs.

Setting up customized health plans requires multiple steps. You can use `list_workout_plans` alongside `list_nutrition_plans` to gather all necessary resources for a new client profile. The Mastra AI workflow engine allows you to build logic: 'If the user is over 40, then check these specific workout plans and suggest this nutrition plan.' It manages that entire decision tree.

Setup guide

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

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

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

Mastra AI builds reliable workflows for this. You can set up a sequence: check current status using `search_members`, then conditionally list new plans with `list_memberships`. If payment fails, the workflow handles retries automatically.

Yes. You can define a multi-step process that first calls `list_events` to get all dates, then uses those dates to check for specific required resources, ensuring the schedule is complete before reporting it.

Mastra AI handles failures gracefully. If `list_trainers` encounters an issue, the workflow won't stop; it will execute predefined retry logic or escalate the failure to a human for review.

It does. You can build reliable workflows around `get_member` and `search_members`. The system ensures that if the member record is incomplete, it notifies an admin rather than failing silently.

The server primarily touches membership status and fitness progress. Using Mastra AI means you can build auditable workflows that track exactly which pieces of data are accessed during a complex operation.

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