# myClub MCP

> myClub MCP Server handles all sports club administration tasks through your AI agent. It lets you manage member profiles, track achievements (merits), list upcoming events, and process financial records by retrieving specific invoices or running full member directory reports. Stop jumping between dashboards to coordinate practices, check who owes dues, or build membership rosters—your agent does it all in one place.

## Overview
- **Category:** event-management
- **Price:** Free
- **Tags:** club-management, member-directory, event-coordination, sports-administration, billing-management, community-engagement

## Description

**myClub MCP Server** handles all your sports club administration tasks through your AI agent. You won't have to jump between five different dashboards just to coordinate practices, check who owes dues, or build membership rosters—your agent runs it all in one spot.

Here’s the rundown of what this server lets you do:

**Managing Membership Records**
You can run `list_members` to pull a complete directory listing of every person registered with the club. Need details on just one guy? You use `get_member` to get all the profile information, including their contact info and current membership tier.

To track status, you've got tools for merits and cards. You can run `list_merits` to see every point or achievement a member has racked up. For physical records, `list_cards` retrieves details on any current or expired member achievement cards. It’s all right there.

**Coordinating Events**
For scheduling, you got two ways to look at it. If you need an overview of what's coming up—practices, games, tournaments—you run `list_events` and get structured data across a date range. Need the deep dive on one specific day? You use `get_event`, supplying just an ID, and pull all the precise details for that single club event.

**Handling Finances and Billing**
This server lets you manage the money side of things too. To check overall billing status across the board, you run `list_invoices` to get a list view of multiple invoices. If you know the exact number, use `get_invoice`; it pulls the full record and tells you the payment status for that one specific account.

It’s simple: your agent takes over all the manual data fetching. You don't waste time cross-referencing spreadsheets or logging into multiple portals just to ask basic questions like, 'Who is active this month?' or 'What did John earn last year?' Your AI client accesses every piece of operational data—member profiles, event schedules, financial records, and achievements—directly through these tools. You'll find your workflow stays tight and focused.

## Tools

### get_event
Retrieves specific details about a single club event using an ID.

### get_invoice
Pulls the full record and payment status for one specific invoice number.

### get_member
Gets all details for a single member, including contact info and membership tier.

### list_cards
Retrieves a list of current or expired member achievement cards.

### list_events
Shows an overview of all scheduled events for the club in date ranges.

### list_invoices
Generates a list view of multiple invoices, useful for checking overall billing status.

### list_members
Provides a complete directory listing of every member registered with the club.

### list_merits
Lists all earned merits or points associated with a member's profile.

## Prompt Examples

**Prompt:** 
```
List all active members in the club.
```

**Response:** 
```
Fetching members... I've found 45 active members. Here are the first few...
```

**Prompt:** 
```
Show upcoming events for this month.
```

**Response:** 
```
Retrieving events... You have a soccer practice on Friday and a tournament next Sunday.
```

## Capabilities

### Retrieve Member Details
Fetches the full profile information for one specified club member.

### List All Members
Gathers a complete list of every active and inactive member in the club directory.

### Track Event Schedules
Retrieves structured data about upcoming or past practices, games, and organized events.

### Manage Financial Records
Accesses and lists club invoices to check payment status and due dates.

### Review Member Achievements
Lists a member's accumulated merits or card details within the club system.

## Use Cases

### The Annual Roster Audit
A club administrator needs a list of all members who haven't paid dues in the last six months. They ask their agent to run `list_members` and then filter that list against data retrieved from `list_invoices`. The agent handles the two-step data pull, providing a clean report of non-paying accounts.

### Pre-Game Logistics Check
The event coordinator needs to confirm if enough members are registered for an upcoming tournament. They ask their agent to run `list_events` (to get the date/time) and then use `get_member` multiple times based on the expected roster, confirming required player availability.

### Processing a Membership Transfer
A member is moving but needs to prove their years of service. They ask their agent to retrieve both `list_merits` and `get_member` details. The agent compiles the full history into a single document for transfer records.

### Billing Discrepancy Check
The treasurer notices a missing charge on an invoice. They ask their agent to run `list_invoices` first, spot the correct ID, and then use `get_invoice` immediately to pull the full transaction details for review.

## Benefits

- Automate membership checks. Instead of manually checking a roster or database for details, your agent uses `get_member` to pull the full profile immediately when you need it. You get clean JSON data right into your workflow.
- Simplify billing cycles. Don't wait for paper statements. Use `list_invoices` and `get_invoice` to instantly verify payment status or identify outstanding dues across the whole club.
- Keep track of logistics. Never miss a practice time again. `list_events` gives you an overview of all upcoming activities, letting your agent cross-reference dates with member availability.
- Streamline roster building. The old way was compiling spreadsheets from multiple sources. Now, just run `list_members` to get the complete, authoritative club directory for any report or mailing.
- Track performance and loyalty. You can instantly see a member's history by calling `list_merits` or checking their card status using `list_cards`. This helps you recognize long-term commitment.

## How It Works

The bottom line is that your AI client executes multiple club management actions using one unified API connection.

1. First, you subscribe to the myClub server and provide it with your unique myClub API Token and your club's Subdomain.
2. Next, you instruct your AI agent (via natural language) what data you need—for instance, 'List all members who have an invoice due this month.'
3. The agent runs the necessary tools (`list_members`, `list_invoices`) in sequence and returns a consolidated report to you.

## Frequently Asked Questions

**How do I check a member's dues using the get_invoice tool?**
You use `get_invoice` by providing the unique invoice ID. This pulls all payment details, including due dates and associated membership fees. It’s best to run `list_invoices` first if you don't have a specific number.

**Can I list all club members and their achievements at once?**
No single tool does that, but your agent can combine them. You call `list_members` to get the roster, then loop through those IDs running `list_merits` for each one to build a comprehensive report.

**What is the best way to find out about upcoming events?**
Use the `list_events` tool. It gives you an overview of all scheduled activities in date ranges, allowing you to filter for specific types like 'practices' or 'tournaments'.

**Does myClub MCP Server let me see member details by name?**
Yes, the `get_member` tool handles fetching full member profiles. While it usually requires an ID, you can often pass identifying information to your agent so it finds and then retrieves the correct record.

**If I need a report on billing, should I use list_invoices or get_invoice?**
Use `list_invoices` when you need an overview—like 'show me all invoices for Q3.' Use `get_invoice` when you know the specific ID and just want to view that single transaction's details.

**Before I run a tool like `list_members`, what credentials do I need to set up the myClub connection?**
You must provide your specific myClub API Token and Subdomain when connecting. These two pieces of information let your agent access data only for your club, keeping everything secure.

**When I use `list_events`, can I narrow down the results to a certain date or category?**
Yes, you pass filters (like start date or event type) directly into the `list_events` call. This stops your agent from pulling through months of irrelevant data and keeps the response focused.

**If I use `get_event`, how do I find out which members were actually participating?**
The output from `get_event` includes a list of member IDs for that specific event. You then take those IDs and feed them into the `get_member` tool to pull up detailed profiles.

**Where do I find my API Token?**
Log in to your club's myClub site, and navigate to Settings > API to generate a token. You may need admin permissions.

**What is the subdomain?**
The subdomain is the part before '.myclub.fi' in your URL. For example, if you use 'https://demo.myclub.fi', your subdomain is 'demo'.