How to Use the Gumroad MCP in Windsurf

Q: How do I configure the Gumroad MCP Server inside Windsurf?

Open your mcpconfig.json file in Windsurf or use the Cascade settings UI. Add the server configuration under the mcpServers key, then click refresh. Cascade instantly discovers the eight store tools.

Q: Can I run bulk updates on my digital products?

Yes. Cascade can loop through your catalog using listproducts and update pricing or details sequentially, saving you from clicking through the web dashboard.

Run your storefront from your IDE. Let Cascade chain Gumroad operations to manage sales and discounts without leaving Windsurf using this 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 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

Auto-generated promotions inside Windsurf

The `create_offer_code` tool lets your editor build discount codes directly in your workspace. Cascade takes your prompt, checks existing active codes with `list_offer_codes`, and writes a script to spin up new ones when sales dip. This isn't just about writing code. You tell Cascade to run a promo for your top-tier digital products, and it plans the entire execution. It pulls your items using `list_products` and handles the rest.

Automated subscriber audits with this MCP Server

This MCP Server uses `list_product_subscribers` to audit your active customer base without manual exports. Cascade inspects your subscriber list, finds inactive accounts, and pairs them with `get_product_details` to flag who needs a re-engagement nudge. You avoid hopping back and forth between web dashboards. The editor handles the heavy lifting, pulling live telemetry on your memberships directly into your current coding session.

Real-time sales reporting in Cascade

The `list_sales` tool pulls your latest checkout data straight into your active IDE window. Cascade chains this with `get_sale_details` to parse revenue spikes or track down specific order issues right when they happen. You get direct answers about your store's performance. Cascade loops through the raw JSON payload, calculates your margins, and displays the exact figures in your chat panel.

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-alternative-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

Open your mcp_config.json file in Windsurf or use the Cascade settings UI. Add the server configuration under the mcpServers key, then click refresh. Cascade instantly discovers the eight store tools.

Yes. You can tell Cascade to check your recent orders and generate a specific discount code if volume drops. It runs these tools in sequence without requiring intermediate prompts.

You provide your API token once in the Windsurf MCP configuration. The server handles the handshake securely, giving Cascade immediate access to run queries like get_user_profile.

Yes. Cascade can loop through your catalog using list_products and update pricing or details sequentially, saving you from clicking through the web dashboard.

Your Gumroad customer emails, subscriber records, and sales history stay entirely inside the Vinkius sandbox. This MCP Server processes transactions in memory without caching your financial data 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