How to Use the ChargeDesk MCP in Windsurf

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

Open your /.codeium/windsurf/mcpconfig.json file and add the Vinkius URL under the mcpServers key. Cascade immediately registers the billing tools upon save.

Q: How does ChargeDesk handle multiple payment gateways in Windsurf?

The listconnectedgateways tool queries all your active processors at once. Windsurf displays the unified billing data, saving you from switching between different processor dashboards.

Q: Can I filter subscriptions by active status?

Yes, listchargedesksubscriptions returns the status for all records. You can ask Cascade to filter this list to show only active or inactive subscriptions.

Run billing lookups and issue refunds directly 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 ChargeDesk MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull customer histories inside Windsurf

The `get_customer_details` and `list_chargedesk_customers` tools let Cascade pull complete customer profiles right where you write your code. Cascade automatically scans your open files to find the customer ID, runs the lookup, and presents the subscription status without you prompting each step. You don't need to hop between payment processor tabs anymore. Cascade handles the raw payload parsing and links the billing state directly to your local debugging session.

Run autonomous refunds with Windsurf Cascade

The `refund_chargedesk_payment` and `get_charge_details` tools give Cascade the ability to reverse disputed transactions when you ask it to resolve support tickets. You tell Cascade to handle a refund request, and it locates the charge, checks the gateway, and processes the refund autonomously. This MCP Server configuration allows Cascade to trace the transaction across multiple connected gateways. It displays the final API confirmation directly in your chat panel once the gateway registers the reversal.

Inspect active gateways and webhooks

The `list_connected_gateways` and `list_chargedesk_webhooks` tools expose your payment infrastructure to Windsurf. Cascade uses these tools to map out how your app receives payment events during local integration testing. Instead of hardcoding dummy webhooks, Cascade reads the live configurations directly. This MCP utility maps out the webhooks to validate that your local event handlers match the active webhooks registered on your account.

Setup guide

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

mcp_config.json

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

Open your `~/.codeium/windsurf/mcp_config.json` file and add the Vinkius URL under the `mcpServers` key. Cascade immediately registers the billing tools upon save.

Yes, but Cascade requires you to approve any write actions like `refund_chargedesk_payment` before execution. Cascade plans the refund sequence, but you click the final confirmation button.

The `list_connected_gateways` tool queries all your active processors at once. Windsurf displays the unified billing data, saving you from switching between different processor dashboards.

Yes, `list_chargedesk_subscriptions` returns the status for all records. You can ask Cascade to filter this list to show only active or inactive subscriptions.

Your customer billing data, including charge amounts and email addresses, stays completely private. Vinkius runs this MCP Server in an isolated sandbox, and your API keys never touch Windsurf's training models.

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