How to Use the Amilia MCP in Mastra AI

Build automated recreation workflows in Mastra AI with direct access to Amilia account and program tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amilia MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated account auditing with Mastra AI

Chain `list_accounts` and `list_contacts` into your Mastra agent workflows. If an account lacks contact info, your agent flags it for review. Conditional logic handles the rest. You define the rules for what happens when data is missing, moving beyond simple queries.

Mastra AI agents managing program schedules

Use `list_activities` and `list_activity_occurrences` to build automated scheduling bots. They check availability and verify slots before confirming any changes. Your workflow engine manages the retries if the network blips. It keeps your operations running without manual oversight.

Registration workflows in Mastra AI

Connect `list_registrations` to your business logic. Agents parse the records to identify enrollment trends or identify families needing follow-up. Everything happens in the background. You set the triggers, and the agent processes the roster data while your team focuses on the actual camp activities.

Setup guide

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

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

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

You add the server URL to your Mastra agent configuration. Once connected, `list_accounts` and other tools become available as native actions for your workflow steps.

Absolutely. You can branch your workflow based on the output of `get_program_details`. For example, if a program is full, the agent can search for alternatives automatically.

Yes, they are designed to be dropped into any agent tool array. They behave like any other function, allowing for complex multi-step automation.

The server runs in an ephemeral Vinkius sandbox. It's designed to handle repeated requests and heavy data processing without leaking memory.

Every request is scoped to your specific API token. The server only touches the registration and contact data you explicitly query, ensuring no outside access to your private family records.

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