How to Use the AMcards MCP in Mastra AI

Q: How do I add AMcards to my Mastra AI agent using MCP?

Install @mastra/mcp and instantiate the client pointing to your Vinkius URL. Spread the tools from the client directly into your agent configuration.

Q: Can Mastra AI handle physical card delivery failures with AMcards?

Yes. Mastra uses workflow retries to replay sendgreetingcard calls if the AMcards API experiences temporary downtime.

Q: Does this server support human-in-the-loop for printing?

Yes. Use Mastra's approval features to intercept sendgreetingcard calls so a human must approve the physical mail before it prints.

Build resilient TypeScript workflows that send physical greeting cards using Mastra AI and this managed 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 AMcards MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build card workflows with Mastra AI and MCP

This MCP Server exposes physical mailing actions to your Mastra agent workflows, starting with `send_greeting_card`. You write automated scripts that send physical cards when a customer registers or hits a milestone. If the initial API call fails, Mastra handles the retry logic using exponential backoff. Your workflow won't drop the card request just because a network hiccup occurred.

Automate multi-step physical drip sequences

Control your automated print mailings using `trigger_drip_campaign` and verify active setups with `list_drip_campaigns`. Your Mastra agent evaluates customer data and starts the right campaign without manual oversight. You can set up human-in-the-loop approvals using Mastra's tool approval setting. This stops the agent from mailing physical cards until a manager clicks approve in your dashboard.

Real-time health checks and webhook audits

Check your system status using `check_api_health` and inspect active endpoints via `list_configured_webhooks`. Mastra workflows use these tools to confirm the print queue is active before queueing new jobs. This prevents silent failures. If the health check fails, your Mastra workflow routes the issue to your admin notification channel instead of wasting API tokens.

Setup guide

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

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

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

Install `@mastra/mcp` and instantiate the client pointing to your Vinkius URL. Spread the tools from the client directly into your agent configuration.

Yes. Mastra uses workflow retries to replay `send_greeting_card` calls if the AMcards API experiences temporary downtime.

You can filter tools during the client initialization or use Mastra's internal middleware to restrict access to tools like `trigger_drip_campaign`.

Yes. Use Mastra's approval features to intercept `send_greeting_card` calls so a human must approve the physical mail before it prints.

Recipient mailing addresses and physical names are sent directly to the printing API over TLS. Vinkius runs this server in ephemeral sandboxes, meaning zero customer data persists in the connection layer.

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