How to Use the Asaas MCP in Mastra AI

Build resilient, self-healing Brazilian payment workflows using Mastra AI and the Asaas 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 Asaas MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Self-healing billing workflows with Mastra AI

Mastra AI workflows trigger `create_payment` to charge customers and handle API failures automatically. If the Brazilian gateway returns a timeout, Mastra's workflow engine kicks in to retry the transaction before throwing an error. This setup keeps your subscription cash flow moving without manual intervention. The agent uses `list_payments` to check if a charge succeeded before moving to the next step of your onboarding workflow.

Human-in-the-loop approvals for this MCP Server

Your automated agents execute `list_transfers` only after receiving explicit human confirmation. You define the approval threshold in your TypeScript code, keeping sensitive financial movements safe. The agent prepares the transfer payload, pauses execution, and only finishes the transaction once an admin clicks approve. Mastra AI manages this state persistence so you don't have to write custom workflow coordination code.

Sync Asaas subscriptions with Mastra AI agents

Your workflows use `create_customer` the moment a lead signs up to spin up a recurring billing profile. This automated sequence ensures your internal database and billing platform stay perfectly in sync. By calling `list_subscriptions`, your Mastra agent monitors active accounts and flags delinquent payers. It can automatically downgrade users in your database when their subscription status changes in Brazil.

Setup guide

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

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

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

Install the Mastra MCP package and pass the Vinkius URL into your client configuration. You can then spread the tools directly into your agent's tool array, making `create_payment` instantly available to your workflow.

Yes. Mastra's built-in workflow engine lets you define retry policies for specific tools like `create_payment`. If the gateway returns a timeout, the workflow retries the call according to your backoff rules.

You can use Mastra's tool approval middleware. When the agent attempts to call a sensitive tool like `list_transfers`, the workflow halts and waits for an external signal before completing the transaction.

Yes, Mastra automatically detects the transport type. It connects to the Vinkius endpoint using SSE or Streamable HTTP to fetch financial data rapidly.

Completely. Vinkius runs the server inside an isolated sandbox, meaning customer details sent via `create_customer` are never cached or logged. Your Mastra AI agent communicates directly with the secure MCP endpoint, keeping sensitive financial profiles safe.

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