How to Use the Gumroad MCP in Windsurf

Q: How do I connect my Gumroad store to Windsurf?

You add the MCP Server configuration to your mcpconfig.json file in Windsurf to link your store. Cascade detects the tools instantly, letting you run queries against your products and transactions.

Q: Can Windsurf Cascade process refunds on Gumroad automatically?

Yes, Cascade uses the refundsale tool to handle returns directly inside your Windsurf workspace. It looks up the sale details first to make sure you are refunding the correct transaction.

Q: Can I list all my active buyers using this setup?

The listpayers tool pulls your entire customer list directly into Cascade. You can filter them by product or purchase date to analyze customer behavior.

Run your entire Gumroad store autonomously inside the Windsurf IDE using Cascade's multi-step planning.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gumroad MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate license validation via Windsurf Cascade

The `verify_license` tool lets Windsurf Cascade check customer license keys right inside your active chat window. When a customer submits a support ticket containing a key, Cascade reads the text, extracts the key, and runs the verification check without you typing a single manual query. Cascade then maps the verified key against `get_sale` to confirm the purchase date and customer tier. If the key is invalid, Windsurf flags the discrepancy and drafts a response to the customer.

Run complex refund logic with this MCP Server

The `refund_sale` tool gives Windsurf Cascade the ability to process returns when specific conditions are met. You tell Cascade to find a transaction using `get_sale` and trigger the refund directly from your workspace. Cascade chains this with `list_sales` to locate the exact transaction ID. It executes the return, updates your internal records, and shows you the final receipt in one run.

Monitor subscription health in Cascade

The `list_subscribers` tool pulls your recurring revenue data straight into the Windsurf editor via our MCP setup. Cascade scans this active member list to find churn risks or expired memberships. It compares this list with `list_products` to see which tiers are losing traction. You get a clear picture of your subscription health without leaving your workspace.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "gumroad-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 Gumroad. 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 Gumroad 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 Gumroad MCP in Windsurf

You add the MCP Server configuration to your `mcp_config.json` file in Windsurf to link your store. Cascade detects the tools instantly, letting you run queries against your products and transactions.

Yes, Cascade uses the `refund_sale` tool to handle returns directly inside your Windsurf workspace. It looks up the sale details first to make sure you are refunding the correct transaction.

Your credential stays in your local Windsurf configuration file, keeping your sales and payout details private. The MCP Server communicates over a secure local transport.

The `list_payers` tool pulls your entire customer list directly into Cascade. You can filter them by product or purchase date to analyze customer behavior.

This MCP Server touches your customer emails, transaction histories, and license keys. All of this sensitive information stays within your local environment and is never sent to third-party tracking 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