How to Use the Kiwify MCP in Windsurf

Q: How do I connect the Kiwify MCP Server to Windsurf?

Open your global configuration file at /.codeium/windsurf/mcpconfig.json and add the server to the mcpServers object. Once saved, the MCP tools register instantly so Cascade can access your store data.

Q: How can I view my registered endpoints?

Ask Cascade to list your current integrations. It runs listconfiguredwebhooks behind the scenes and displays the active URLs directly in your chat interface.

Get live sales data and manage webhooks automatically inside Windsurf using Cascade's autonomous multi-step execution.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Kiwify sales reporting with Windsurf Cascade

The `list_sales_history` tool pulls Kiwify transaction logs directly into your Windsurf workspace. Cascade analyzes this raw Brazilian e-commerce data to find drop-offs and calculate conversion rates without requiring manual exports. You just tell Cascade to audit recent Kiwify revenue, and it handles the rest. It chains `get_sale_details` across specific transaction IDs to flag failed payments, building a clean Markdown report inside Windsurf in seconds.

Track Kiwify recurring subscriptions in Windsurf

The `list_active_subscriptions` tool pulls real-time Kiwify customer data directly into your active Windsurf coding context. This MCP integration helps you monitor recurring revenue trends and pinpoint cancellation rates instantly. Instead of bouncing between tabs, you ask Cascade to find at-risk Kiwify accounts. It runs the query, identifies accounts nearing renewal, and formats the list inside Windsurf so you can plan retention campaigns immediately.

Manage Kiwify notification webhooks via Windsurf

The `create_notification_webhook` tool registers HTTP endpoints to track Kiwify checkout events instantly. Cascade uses this to set up local testing tunnels, routing live transaction events directly to your local Windsurf development server. When you need to clean up your environment, Cascade invokes `delete_notification_webhook` based on your Windsurf chat prompts. It reads your current live Kiwify endpoints using `list_configured_webhooks` and removes stale connections.

Setup guide

Set up Kiwify 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 Kiwify 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 Kiwify payment history." If connected, Cascade will call the Kiwify tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "kiwify-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 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 Windsurf

Open your global configuration file at `~/.codeium/windsurf/mcp_config.json` and add the server to the `mcpServers` object. Once saved, the MCP tools register instantly so Cascade can access your store data.

Cascade operates based on the instructions you provide in the chat panel. It chains tools like `list_products` to answer your questions but requires your confirmation before executing state-changing operations.

When an API limit occurs, Cascade reads the error payload returned by the server. It automatically backs off, waits, and retries the request to ensure your sales reports generate completely.

Ask Cascade to list your current integrations. It runs `list_configured_webhooks` behind the scenes and displays the active URLs directly in your chat interface.

All Brazilian market transaction records, buyer emails, and billing history fetched via `get_sale_details` remain inside your local environment. Vinkius runs the MCP server in a secure, isolated sandbox, meaning your customer data is never cached or stored on external servers.

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