How to Use the Zip MCP in Mastra AI

Q: How does Mastra AI handle Zip order status changes?

Your workflow simply calls getziporderstatus repeatedly. If the state moves from 'Authorized' to 'Captured', your conditional branch executes the next required step automatically.

Q: Can I implement complex refund logic with Mastra AI and Zip?

Absolutely. You can set up a failure path that calls refundzippayment only if, for example, the order status is confirmed as 'Captured' but the external system reports an issue.

Q: What tools are available for Zip payments in Mastra AI?

The server provides a full suite: createzipcheckout, authorizeziporder, and capturezippayment. You can chain these actions together reliably.

Q: Does this MCP Server support retries for Zip payments with Mastra AI?

Yes. If the initial call to confirmziporder times out, you configure your workflow engine to automatically retry that step using exponential backoff.

Build complex Zip checkout workflows with Mastra AI's reliable multi-step agent framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zip MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Workflow Zip Authorizations for Mastra AI

Start a payment sequence by calling `authorize_zip_order`. If the initial authorization fails, your workflow can automatically retry with different parameters or methods. This prevents dead-end transactions.

Managing Zip Order Lifecycle via MCP Server

You'll use `get_zip_merchant_config` to pull necessary settings at the start of your process. Then, track the order state using `get_zip_order_status`, ensuring continuity across steps.

Automated Zip Payment Voiding with Mastra AI

If a payment is authorized but never captured, you can use `void_zip_payment`. This function gracefully cleans up the authorization without needing manual intervention or human approval.

Setup guide

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

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

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

Your workflow simply calls `get_zip_order_status` repeatedly. If the state moves from 'Authorized' to 'Captured', your conditional branch executes the next required step automatically.

Absolutely. You can set up a failure path that calls `refund_zip_payment` only if, for example, the order status is confirmed as 'Captured' but the external system reports an issue.

The server provides a full suite: `create_zip_checkout`, `authorize_zip_order`, and `capture_zip_payment`. You can chain these actions together reliably.

Yes. If the initial call to `confirm_zip_order` times out, you configure your workflow engine to automatically retry that step using exponential backoff.

This server manages payment amounts, currencies, order IDs, and the overall transaction status. The workflows operate entirely on these financial types of data.

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