How to Use the Kiwify MCP in Mastra AI

Q: What's the best way to set up the Kiwify connection for Mastra AI?

Just add the MCP Server URL to your MCPClient configuration in Mastra AI. It will automatically discover and list all the available Kiwify tools for your agent to use.

Q: Can I require human approval for certain Kiwify actions in Mastra AI?

Yes. Mastra AI supports requireToolApproval. You could configure a workflow where an agent prepares to run deletenotificationwebhook but has to wait for a person to approve the action before it actually executes.

Build unstoppable Kiwify automation workflows with error handling and conditional logic using 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 Kiwify MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Sales Reconciliation

This agent automates your end-of-day accounting. It starts by calling `list_sales_history` to get all transactions within a time window. Then, for each sale, it uses `get_sale_details` to pull the itemized data needed for your internal ledger. The real power comes from Mastra AI's workflow engine. If a call to `get_sale_details` fails, Mastra can automatically retry. If it keeps failing after a few tries, the workflow can log the failed sale ID and notify an admin, so nothing gets missed.

Build Resilient Subscription Monitors

Use this to build a subscription health checker that runs on a schedule. The agent calls `list_active_subscriptions` and checks each one against your own customer database. It's a straightforward way to find sync issues between Kiwify and your CRM. With Mastra AI, you can add branching logic. If a subscription exists in Kiwify but not your CRM, the agent can trigger another process to create the missing record. This MCP Server gives your agent the tools to work with Kiwify data inside these complex, multi-step automations.

Manage Integration Endpoints Automatically

This lets you automate your integration plumbing. When you provision a new analytics service, your Mastra agent can use `create_notification_webhook` to register its endpoint with Kiwify. No manual setup needed. The agent can also perform its own health checks. It can call `list_configured_webhooks` to get all registered endpoints and then ping each one. If an endpoint is dead, the agent can automatically remove it with `delete_notification_webhook` to prevent failed deliveries from Kiwify.

Setup guide

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

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

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

You connect Mastra AI to this Kiwify MCP Server. This gives your Mastra agents a set of tools to interact with your Kiwify account—like listing sales or managing webhooks—inside your automated workflows.

Yes. Mastra AI has built-in retry logic with exponential backoff. If a tool call to this MCP server fails because of a network blip, your agent can retry automatically, which makes your Kiwify automation much more reliable.

Just add the MCP Server URL to your `MCPClient` configuration in Mastra AI. It will automatically discover and list all the available Kiwify tools for your agent to use.

Yes. Mastra AI supports `requireToolApproval`. You could configure a workflow where an agent prepares to run `delete_notification_webhook` but has to wait for a person to approve the action before it actually executes.

Your Kiwify keys are stored with Vinkius, not in your Mastra AI code. The agent communicates with our secure server, which handles authentication to Kiwify. We only process sales, product, and subscription data in-memory and never log or store it.

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