How to Use the FastSpring MCP in Windsurf

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

Open your /.codeium/windsurf/mcpconfig.json file and paste the server configuration under the mcpServers key. Alternatively, head to Settings, find the Cascade MCP Servers UI, and add the server URL there. Hit refresh in the MCP panel, and Cascade will immediately discover the 10 commerce tools.

Let Windsurf autonomously chain FastSpring subscription updates, order lookups, and customer account edits without manual intervention.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FastSpring MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously edit customer data using Windsurf Cascade

When a customer asks to update their billing email, Cascade doesn't just show you how to do it. It grabs the user info with `get_account_details`, modifies the payload, and executes the changes via `update_account_info` in a single autonomous chain. You don't have to write any boilerplate or trigger multiple manual steps. This MCP Server lets the IDE read real-time account records directly from your store database. Cascade handles the planning, verifies the current state with `list_accounts`, and updates the billing record before you even have a chance to context-switch.

Resolve subscription plan changes with Windsurf MCP Server

Handling mid-cycle plan upgrades usually requires running complex math and checking catalog alignments. Now, you can tell Cascade to upgrade a customer, and it uses `list_catalog_products` to match the exact SKU, then executes `update_subscription_plan` to swap the tier. The agent handles the plan transitions without you leaving the workspace. If a customer demands an immediate stop to their billing, the agent can run `cancel_subscription` to instantly stop the cycle. Cascade verifies the subscription status by running `get_subscription_details` first, ensuring no active billing records get left behind in your system.

Generate secure customer portal links in one run

Support agents spend too much time manually generating login tokens for customer dashboards. By calling `generate_auth_link` directly within Cascade, Windsurf creates a secure, temporary gateway for your users. The agent grabs the destination and hands back the exact URL without exposing raw credentials. You can also trace billing issues on the fly when Cascade runs `get_order_details` to check transaction histories. If a charge looks off, the agent inspects the order payload, checks for errors, and runs `charge_managed_subscription` if an outstanding balance needs to be collected immediately.

Setup guide

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

mcp_config.json

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

Open your `~/.codeium/windsurf/mcp_config.json` file and paste the server configuration under the `mcpServers` key. Alternatively, head to Settings, find the Cascade MCP Servers UI, and add the server URL there. Hit refresh in the MCP panel, and Cascade will immediately discover the 10 commerce tools.

Yes, that is Cascade's primary strength. If you ask it to fix a billing discrepancy, it will first call `get_subscription_details` to check the plan, then autonomously call `update_subscription_plan` if a correction is needed. You only provide the initial goal, and the agent chains the required API calls.

You can test the integration safely by pointing the configuration to a sandbox environment. Cascade will use the same tools like `list_catalog_products` or `get_order_details` against your sandbox API keys. This setup lets you verify subscription workflows before running them on live customer accounts.

Cascade stops the sequence immediately and displays the error returned by the API. If `charge_managed_subscription` fails due to an invalid token, the agent will report the failure to you instead of blindly proceeding with subsequent steps. You can then instruct it to regenerate the access token or inspect the account.

Your customer billing records and subscription states never touch external LLM servers directly. The integration runs within a secure Vinkius V8 Isolate sandbox, passing only the necessary tool inputs and outputs to your local IDE. Your API keys are kept encrypted and are never exposed to the model during tools execution.

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