How to Use the HelloAsso MCP in Vercel AI SDK

Q: How do I create a payment link for HelloAsso using the Vercel AI SDK?

Your agent needs to call the createcheckoutintent tool. You'll pass the amount and other details in the bodyjson parameter, and the tool returns a redirect URL for the payer. The Vercel AI SDK makes it easy to then display this link in your UI.

Q: Can my agent find the right organization slug to use with HelloAsso and the Vercel AI SDK?

Yes. The first step for your agent should be to call listmyorganizations. This tool returns all the organizations you have access to, including the slug for each one, which you'll need for most other tool calls.

Stream HelloAsso payment and member data directly into your app with the Vercel AI SDK. Forget loading spinners.

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 Vercel AI SDK

Create your Vinkius account to connect HelloAsso to Vercel AI SDK 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Real-Time Donation Dashboards

Hook up your AI client to `list_payments` and watch donation data stream into your UI. The AI SDK pipes results from this MCP Server right into your React or Svelte components. You're not waiting for a full list to load; you render each payment as it arrives from the server. This is perfect for live event dashboards or fundraising trackers where you want to show momentum. Your users see the numbers tick up in real time, which is way more engaging than a static, refreshed list.

Create Instant Order Lookups

Let users ask about their purchase history right inside your application. Your agent uses `get_order_details` and `get_payment_details` to pull specific transaction records from HelloAsso. No more redirecting to an external site to check order status. The Vercel AI SDK renders the details as they're received, so the user sees ticket info, payment status, and item breakdowns appear on their screen without a page refresh. It feels fast and integrated.

Dynamic Campaign Forms with the Vercel AI SDK

Stop hardcoding links to your campaigns. Have your agent call `list_forms` to get all your current HelloAsso campaigns—Donations, Memberships, Events, you name it. Your agent can then help users find the right form based on what they ask for. Because the results stream, you can build interactive search UIs that update instantly as the user types. It's a clean way to connect users to the exact form they need without maintaining a static list of links.

Setup guide

Set up HelloAsso MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all HelloAsso tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent HelloAsso transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Your agent needs to call the `create_checkout_intent` tool. You'll pass the amount and other details in the `body_json` parameter, and the tool returns a redirect URL for the payer. The Vercel AI SDK makes it easy to then display this link in your UI.

Yes. The first step for your agent should be to call `list_my_organizations`. This tool returns all the organizations you have access to, including the `slug` for each one, which you'll need for most other tool calls.

An order is the whole transaction, like a shopping cart session. `list_orders` gives you that top-level view. `list_sold_items` shows the individual things inside those orders, like a specific event ticket or a particular membership tier.

This server handles the authentication and API boilerplate for you. You just connect your Vercel AI SDK client with one token and start calling tools like `list_subscriptions`. It saves you from writing and maintaining a bunch of API client code.

Your data is only passed through this MCP server when your agent makes a specific call. The server is ephemeral and doesn't store your HelloAsso data, which includes payment details, order histories, and member information. All authentication is handled by Vinkius tokens.

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