How to Use the Asaas MCP in Windsurf

Q: Can I manage Asaas subscriptions directly from Windsurf?

Yes. Your agent can use the listsubscriptions tool to pull all active subscription data from Asaas. You can then ask it to perform follow-up actions based on that data.

Let Windsurf's Cascade agent manage your Asaas customers and payments while you focus on the real work.

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 Windsurf

Create your Vinkius account to connect Asaas to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Customer & Payment Workflows

This server gives Windsurf's Cascade agent direct control over your Asaas account. Tell it to "Create a new customer and charge them for the initial setup fee," and it will chain `create_customer` and `create_payment` without you lifting a finger. No more manual data entry in the Asaas dashboard. Cascade can also handle reporting. Ask it to "Get me a list of all customers who haven't paid this month," and it will use `list_customers` and `list_payments` to figure it out. It plans the steps, executes them, and gives you the final answer.

Get Financial Overviews on Demand in Windsurf

Your agent can now pull financial data directly from Asaas. Instead of logging into another website, just ask Windsurf to `get_balance` for a quick cash flow check. You can also get a full history of money coming in and out. Use this to build internal reports or just stay on top of things. Ask Cascade to "List all subscriptions and recent transfers," and it will call `list_subscriptions` and `list_transfers` to give you a complete picture right inside your IDE.

Check Your Connection Status

This server includes a simple tool to confirm your agent is connected to Asaas. Just run `get_account_check` and you'll get an immediate confirmation. It's a quick sanity check before you start a complex multi-step task. This is especially useful when setting up a new project or debugging. Before you ask Cascade to create a dozen new subscriptions, you can make sure the connection to this MCP server is solid.

Setup guide

Set up Asaas MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Asaas MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Asaas payment history." If connected, Cascade will call the Asaas tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "asaas-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Windsurf's Cascade agent autonomously chains Asaas tools. You give it a goal, like "Onboard a new client," and it automatically runs `create_customer` then `create_payment` without needing step-by-step instructions.

Yes. Your agent can use the `list_subscriptions` tool to pull all active subscription data from Asaas. You can then ask it to perform follow-up actions based on that data.

You just need your Asaas account credentials. Install the server from the built-in MCP Marketplace in Windsurf, and Cascade will automatically find all the available tools like `list_customers` and `create_payment`.

This is an MCP server that connects to the public Asaas API. It's hosted and managed by Vinkius, providing a secure and standardized way for your AI client to interact with your Asaas account.

The server only accesses the data needed for its tools. This includes customer details for `create_customer`, payment amounts for `create_payment`, and lists of your subscriptions and transfers. All data passes through Vinkius's zero-trust, ephemeral environment.

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