How to Use the HelloAsso MCP in Windsurf

Q: Can Cascade pull member records from HelloAsso automatically?

Yes, Cascade chains the tools to do this. It runs listmyorganizations to grab your slug, finds the right form via listforms, and then pulls specific records with getmemberdetails.

Q: What happens if a payment lookup fails?

This MCP Server reads the error message returned by the getpaymentdetails tool. Cascade then adjusts its query parameters or alerts you if the payment ID does not exist in your organization.

Run French non-profit campaigns directly inside Windsurf using Cascade to chain forms, orders, and payments.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HelloAsso MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate checkout links in Windsurf

The `create_checkout_intent` tool generates a direct payment URL for your contributors by taking the amount in cents and your custom JSON body. Cascade reads your local campaign files, picks up the required amounts, and instantly requests the checkout link without you writing any API integration code. You get back a clean redirect URL that you can immediately send to donors. Because Cascade understands context, it can automatically write this link into your confirmation emails or update your database with the returned transaction details.

Audit campaign metrics with Cascade

The `list_payments` tool pulls every transaction received by your association in EUR cents. Cascade can run this tool, check the amounts, and then immediately call `get_payment_details` to verify specific donor names or payment dates. Instead of manual export steps, your IDE grabs the raw numbers directly. It can then draft a summary of your event revenue or write a local script to format the data for your accounting team.

Map your organization with this MCP Server

The `list_my_organizations` tool returns the administrative slugs you need to target with other queries. Cascade uses this tool first to discover your active organization profiles and then feeds that slug directly into `list_forms` to pull your donation, membership, and event campaigns. You don't have to copy-paste IDs between browser tabs. Windsurf handles the entire lookup flow in one go, mapping your forms to the right organization slug so you can query members using `get_member_details` right away.

Setup guide

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

mcp_config.json

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

Tell Cascade to generate a payment link with your target amount in cents. It will invoke the `create_checkout_intent` tool and hand you the raw redirect URL instantly.

Yes, Cascade chains the tools to do this. It runs `list_my_organizations` to grab your slug, finds the right form via `list_forms`, and then pulls specific records with `get_member_details`.

Cascade handles the pagination loops for you. When you ask this MCP Server for all transactions, it calls `list_payments` repeatedly until it gathers the complete list of payments in cents.

This MCP Server reads the error message returned by the `get_payment_details` tool. Cascade then adjusts its query parameters or alerts you if the payment ID does not exist in your organization.

Your sensitive donor names, order details, and payment histories stay inside the secure Vinkius sandbox. Windsurf talks to the HelloAsso MCP server over an encrypted local transport, meaning your financial data never touches external third-party 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