# HelloAsso MCP for AI Agents AI Agent Connect

> HelloAsso MCP connects your account to any AI agent to automate French non-profit management. You can track donations, manage membership plans, and generate payment links directly in your chat. It removes the need to manually export transaction data or hunt through the dashboard for campaign stats.

## Overview
- **Category:** event-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_SfzGezKXp8j291QYeSpOxZR6viiQTyBriJVIZgbU/ai-agent-connect
- **Tags:** nonprofit-management, donation-tracking, membership-management, ticketing, payment-collection, french-nonprofits

## Description

This HelloAsso MCP lets you manage your non-profit's finances and membership programs through a simple conversation with your AI client. Instead of jumping between tabs to check who paid for what, you can ask your agent for a summary of today's donations or see which membership plans are most popular. It handles the heavy lifting of tracking recurring payments and order history so you can focus on your mission. If you need to collect money, you can have your agent generate a specific payment link on the fly. It's a practical way to get a bird's-eye view of your organization's health without the headache of manual data entry. You'll find this is a huge time-saver when you're looking for the Vinkius catalog to round out your non-profit toolkit. It turns your AI into a dedicated coordinator that knows your campaign details and payer behavior.

## Tools

### get_member_details
Fetch specific information about a member using their unique ID. This helps you quickly look up a single person's status.

### get_order_details
Pull the full details of a specific order. Use this to see exactly what items or donations were included in a transaction.

### create_checkout_intent
Generate a redirect URL for a specific payment amount in EUR. Use this to quickly send payers to a checkout page.

### get_organization_details
Get the specific information for an organization based on its slug. This helps the agent understand which entity it's looking at.

### get_payment_details
Retrieve the data for a specific payment ID. Use this to check the status or amount of a single transaction.

### list_forms
Show all active campaigns like donations, memberships, or events. This gives your agent a list of everything you're currently offering.

### list_sold_items
List every individual item or ticket sold by an organization. Use this to see your inventory distribution.

### list_my_organizations
Find the slugs for all organizations you have access to. This is the first step for the agent to know where to look.

### list_orders
Show all orders grouped by session. This helps you see what people are buying or donating in bulk.

### list_payments
Show all payments received by an organization in EUR cents. Use this to track your overall cash flow.

### list_subscriptions
Show all recurring payment plans. This helps you monitor your stable, ongoing membership revenue.

## Prompt Examples

**Prompt:** 
```
How many donations did we get from the 'Save the Forest' campaign today?
```

**Response:** 
```
### Today's Campaign Summary
**Campaign:** Save the Forest

| Time | Donor | Amount |
| :--- | :--- | :--- |
| 09:15 AM | Jean Dupont | 50.00 EUR |
| 11:30 AM | Marie Curie | 120.00 EUR |
| 02:45 PM | Luc Bernard | 25.00 EUR |

**Total Today:** 195.00 EUR
```

**Prompt:** 
```
Can you make a link for a 100 EUR donation for the 'Emergency Fund'?
```

**Response:** 
```
I've prepared that for you. What is the slug for your organization?
```

**Prompt:** 
```
Who are our top 5 members by subscription amount?
```

**Response:** 
```
### Top 5 Members

* **Alice V.** - 500.00 EUR (Platinum Tier)
* **Bob S.** - 300.00 EUR (Gold Tier)
* **Charlie D.** - 200.00 EUR (Silver Tier)
* **Diana L.** - 150.00 EUR (Bronze Tier)
* **Edward M.** - 100.00 EUR (Bronze Tier
```

## Capabilities

### List all active non-profit forms
See every donation, membership, and event form your organization currently has live.

### Track daily donation totals
Get a quick summary of how much money came in today without checking a spreadsheet.

### Generate payment redirect links
Create a unique URL for a specific payment amount to share with your donors instantly.

### Monitor recurring membership plans
Check your stable revenue by listing all active subscription plans.

### Inspect individual order details
Look into the specifics of any transaction to see exactly what was purchased or donated.

### Retrieve specific member data
Pull details for a single member to help with community management and support.

## Use Cases

### Checking donation totals
A director asks for the total donations from a gala. The agent uses list_payments and list_orders to sum the amounts.

### Creating a custom link
A volunteer needs to collect 50 EUR for a specific cause. They ask the agent to make a link, which uses create_checkout_intent.

### Auditing memberships
A financial officer needs to see who hasn't renewed. The agent uses list_subscriptions and get_member_details to pull the list.

### Campaign overview
A manager wants to see all active forms. The agent uses list_forms to show every donation and event currently live.

## Benefits

- Stop manual CSV exports by using list_payments to get real-time financial summaries directly in your chat.
- Create payment links instantly with create_checkout_intent to send donors to the right page without leaving your workspace.
- Monitor recurring revenue more easily by using list_subscriptions to see your stable membership base.
- Get a bird's-eye view of your campaigns by using list_forms to see what's active across your entire organization.
- Speed up member support by using get_member_details to quickly find specific information about your community members.

## How It Works

The bottom line is you get a conversational dashboard for your non-profit's financial and membership data.

1. Subscribe to this Connector on Vinkius and grab your Client ID and Secret from your HelloAsso account.
2. Plug those credentials into your preferred AI client.
3. Ask your agent to summarize your recent payments or list your active campaigns.

## Frequently Asked Questions

**Can the HelloAsso MCP help me track donations for my French non-profit?**
Yes, it lets your AI agent pull live donation data so you can see totals without logging into your dashboard.

**How do I use HelloAsso to create payment links with an AI agent?**
You can ask your agent to generate a link for a specific amount. It will use the Connector to create a checkout intent and give you a URL to share.

**Can I see my membership renewals using the HelloAsso MCP?**
Yes, you can ask your agent to list all recurring subscriptions to see who is currently active.

**Does the HelloAsso MCP work for events and tickets?**
It does. Your agent can list all active forms, including those for event registrations and ticket sales.

**Is the HelloAsso MCP good for financial auditing?**
It's great for auditing because it can pull detailed order and payment history to show you exactly where your money is coming from.

**Can my AI agent see specific member info with HelloAsso?**
Yes, your agent can fetch details for specific members to help you manage your community more effectively.

**How does the HelloAsso MCP handle different organizations?**
It can manage multiple organizations. You can ask your agent to list all your associations and then switch between them.

**How do I find my HelloAsso API credentials?**
Log in to your HelloAsso account, go to **Mon Compte > Integrations & API**. You can generate your **Client ID** and **Client Secret** from the API section there.

**What is an organization 'slug'?**
The slug is the unique textual identifier for your association (e.g., in `helloasso.com/associations/my-asso`, the slug is `my-asso`). You can find it by using the `list_my_organizations` tool.

**Can I generate a payment link directly from the AI agent?**
Yes! Use the `create_checkout_intent` action. You must provide the association slug and a JSON string with the amount (in cents) and return URL. The agent will return a redirect link for the user.

**Is the integration secure for association data?**
Absolutely. The integration uses industry-standard OAuth 2.0 Client Credentials over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.