# HelloAsso MCP > HelloAsso connects your AI agent directly to French non-profit systems, giving you full control over association management. You can manage payments, track memberships, and monitor campaign forms—all through natural conversation. Stop exporting CSVs; start asking questions about donations and orders right where you work. ## Overview - **Category:** event-management - **Price:** Free - **Tags:** nonprofit-management, donation-tracking, membership-management, ticketing, payment-collection, french-nonprofits ## Description This MCP lets you run your entire non-profit back office through plain chat. Instead of logging into the HelloAsso dashboard to manually check donation totals or membership status, you just talk to your agent. You can ask it to list all active campaigns for a specific organization, check on recurring subscription payments, or even generate a secure checkout link instantly. It handles everything from checking order details to fetching detailed payment records and tracking every single item sold. If your current workflow involves digging through multiple tabs or downloading CSVs just to answer simple questions, this changes that. By connecting HelloAsso via Vinkius, you treat your AI agent like an actual financial coordinator or community manager dedicated solely to your association's needs. ## Tools ### create_checkout_intent It generates a secure redirect link so someone can immediately make a payment for a specified amount. ### get_member_details This function fetches specific profile information for an individual member using their ID number. ### get_order_details It retrieves a full breakdown of all items, donations, and payments contained within one single order. ### get_organization_details You get detailed information about a specific non-profit using its unique slug identifier. ### get_payment_details This fetches comprehensive details and metadata for any payment recorded by the association, using a specific ID number. ### list_forms It lists all campaigns available (like donations or memberships) that an organization has set up. ### list_sold_items You get a list of every individual physical item, ticket, or membership tier sold by the association. ### list_my_organizations It lists all non-profit organizations where you have administrative rights so you can find the necessary slug for other tools. ### list_orders You get a summary list of every order placed, grouping together items and payments from one session. ### list_payments This returns a detailed list of all monetary transactions received by the organization over time. ### list_subscriptions It lists recurring payments, helping you monitor ongoing donation or membership plan status. ## Prompt Examples **Prompt:** ``` List all active campaigns for my association 'Protect Oceans'. ``` **Response:** ``` I've retrieved your forms for 'Protect Oceans' (slug: protect-oceans). You have 3 active campaigns: 'Annual Donation Drive', 'Membership 2024', and 'Gala Dinner Tickets'. Which one would you like to see statistics for? ``` **Prompt:** ``` Show me the last 5 payments received today. ``` **Response:** ``` Fetching today's payments... I found 5 recent transactions totaling 245.00 EUR. The largest was a 100.00 EUR donation from Jean Dupont. Should I list the individual items for each payment? ``` **Prompt:** ``` Generate a checkout link for a 50 EUR donation. ``` **Response:** ``` I've initiated the checkout process. I need your association's slug to complete the link. Once you provide it, I'll generate a redirect URL for a 50.00 EUR donation (5000 cents). What is the association slug? ``` ## Capabilities ### Check Association Structure You list all organizations where you have admin access and retrieve specific details about any given non-profit. ### Monitor Campaigns and Forms You view a complete list of all active and past forms, including donations, memberships, and event registrations for an organization. ### Track Financial Activity You access financial history to retrieve detailed payment metadata, listing all payments received or tracking specific donation totals. ### Manage Memberships and Subscriptions You track your membership base by retrieving individual member details and monitoring recurring donation plans. ### Process Orders and Sales Data You list all past orders and retrieve the specific items sold or donated within a single transaction session. ### Generate Payment Links You create secure, direct checkout links for immediate payment collection in chat. ## Use Cases ### Determining Campaign Success A director needs to know which campaign generated the most revenue last month. Instead of downloading three separate CSV files (donations, events, memberships) and reconciling them in Excel, they ask their agent to use `list_forms` first, then use `list_payments` across those forms to get a single total. ### Handling On-the-Fly Donations A community manager is at an event and needs a donor to pay right now. Instead of having to manually copy the association's payment link and amount, they ask their agent to `create_checkout_intent` for 100 EUR, getting the immediate redirect URL to share. ### Investigating a Missing Payment A financial officer notices an unusual transaction. They use the MCP to first `list_orders` to find the related order ID, then call `get_order_details` and finally `get_payment_details` using the specific payment ID to pinpoint exactly what went wrong. ### Checking Recurring Revenue A board member needs a quick status update on yearly memberships. Instead of navigating through the membership dashboard, they simply ask their agent about subscriptions; the MCP uses `list_subscriptions` to show the current recurring payment health. ## Benefits - You get immediate payment visibility. Instead of sifting through complicated reports, you simply ask your agent to list all payments or check a specific ID using `get_payment_details`. - Membership tracking is instant. You can retrieve individual member details using `get_member_details`, eliminating the need to look up member IDs in separate databases just to confirm status. - Campaign oversight improves dramatically. By calling `list_forms`, you see every active and past campaign (donations, events) without clicking through multiple dashboard sections. - Checkout links are one prompt away. Need a donation link? Use `create_checkout_intent` to generate the exact payment URL your supporters need right in the chat interface. - Complex sales tracking becomes simple. You can list all orders using `list_orders`, or drill down into individual items sold by calling `list_sold_items`. No more guessing how many units were purchased. - Financial history is consolidated. Your agent handles fetching donation totals and payment records via `list_payments` and `list_subscriptions`, giving you a clear, immediate overview. ## How It Works The bottom line is you get to manage complex association financials using plain language chat commands instead of navigating multiple web dashboards. 1. Subscribe to this MCP and enter your specific HelloAsso Client ID and Client Secret. 2. Your AI client authenticates the connection, making all associated tools immediately available for use. 3. You simply ask your agent questions like, 'What were the total payments last month?' or 'Generate a payment link for 75 EUR.' The MCP executes the necessary API calls in the background and returns simple answers. ## Frequently Asked Questions **How do I list all the campaigns for my non-profit using HelloAsso MCP?** You run the `list_forms` tool. This function immediately shows you every campaign type, like donations or memberships, that your association currently has active. **Can I generate a payment link without knowing all the details of the organization? Is HelloAsso MCP required?** No, you don't need to know every detail. You just use `create_checkout_intent`, providing the desired amount in cents, and the tool handles generating the necessary redirect URL. **How do I check a member’s status using HelloAsso MCP?** You call `get_member_details` with the specific member ID. The agent retrieves all current information about that membership, whether it's active or expired. **What is the difference between listing payments and listing orders in HelloAsso MCP?** Listing payments (`list_payments`) gives you a raw record of money received. Listing orders (`list_orders`) groups those payments with associated items, giving context to what was bought or donated. **Does HelloAsso MCP support multiple non-profit associations?** Yes. You start by running `list_my_organizations` to find the slug for every association you manage, and then use that slug with other tools to query each one separately.