How to Use the Billplz MCP in Windsurf

Q: How do I link Billplz to my Windsurf environment?

Add the server configuration to your mcpconfig.json file. Once you refresh the MCP panel, Cascade gains access to all eleven tools immediately.

Manage your payment collections inside Windsurf. Cascade chains Billplz tools to automate invoicing without manual prompts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Billplz MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate billing sequences in Windsurf

Cascade can trigger `create_collection` and `create_bill` in one go. You tell it the amount and the payer, and it handles the rest. This MCP Server lets the agent check your state with `list_collections` before firing off new requests. It prevents duplicate billing by verifying active records first.

Fetch transaction status without leaving Windsurf

Need to confirm a payment? Use `list_transactions` to pull the latest status for any specific bill. Cascade reads the output to update your project notes or dashboards. It connects directly to the payment gateway to fetch real-time data. You get the raw numbers inside your editor, ready for whatever logic you're building next.

Query bank data with Cascade

Call `get_fpx_banks` to see what payment methods are available for your users. The agent uses this to populate checkout forms or payment selection logic automatically. It also uses `get_bank_account` to verify your deposit settings. You'll know exactly where funds land without logging into the dashboard.

Setup guide

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

mcp_config.json

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

Add the server configuration to your mcp_config.json file. Once you refresh the MCP panel, Cascade gains access to all eleven tools immediately.

Yes. You can instruct Cascade to loop through a list of customers and call `create_bill` for each one. It manages the sequence and confirms completion for every entry.

Vinkius runs this in a V8 sandbox, keeping your API keys and transaction details isolated. Only the specific bill and collection data you request ever hits the agent.

Windsurf allows you to set trust levels for tools. Once you authorize the server, Cascade executes the commands you define without asking for a click each time.

The server returns an error message directly to the chat window. You can then ask Cascade to retry the operation or check the bill status using `get_bill`.

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