Hello Club MCP by usefulapi
Read Hello Club members, events, bookings and transactions; add members and charges.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Befunde (2)
- LOWTool 'hello_club_list_membership_types' name length outside 3-30 rangein hello_club_list_membership_types
- LOWTool 'hello_club_list_event_attendees' name length outside 3-30 rangein hello_club_list_event_attendees
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~5,427Tokens (Tool-Definitionen)
~3.1 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (4.24% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"hello-club": {
"url": "https://hello-club.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://hello-club.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (14)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢hello_club_list_members(search, gender, role, is_staff, has_money_owing, ...)
List or search the club's members (people and staff) with contact details, roles, memberships (subscriptions), account credit and amount owing. Filter by free text, gender, role, staff, money owing, account credit, current subscription state, ending subscriptions or a membership type. GET /member.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search (name, email, member number...).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"gender": {
"description": "Filter on gender.",
"type": "string",
"enum": [
"female",
"male",
"diverse",
"hidden",
"unknown"
]
},
"role": {
"description": "Filter on role.",
"type": "string",
"enum": [
"admin",
"viewer",
"eventManager",
"member"
]
},
"is_staff": {
"description": "Only staff members (true) or only non-staff (false).",
"type": "boolean"
},
"has_money_owing": {
"description": "Only members with unpaid transactions (true) or without (false).",
"type": "boolean"
},
"has_account_credit": {
"description": "Only members with account credit (true) or without (false).",
"type": "boolean"
},
"with_current_subscription": {
"description": "Only members with a current membership subscription.",
"type": "boolean"
},
"without_current_subscription": {
"description": "Only members without a current membership subscription.",
"type": "boolean"
},
"subscription_ending": {
"description": "Members whose subscription ends within the next hour/day/week/month/year.",
"type": "string",
"enum": [
"hour",
"day",
"week",
"month",
"year"
]
},
"subscription_ended": {
"description": "Members whose subscription ended within the past hour/day/week/month/year.",
"type": "string",
"enum": [
"hour",
"day",
"week",
"month",
"year"
]
},
"membership_id": {
"description": "Membership type id (hello_club_list_membership_types), used together with one of the subscription filters.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"signed_up_since": {
"description": "Sign-up date threshold.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"updated_since": {
"description": "Only members updated on or after this timestamp.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"fields": {
"description": "Only return these fields of each item (e.g. [\"id\",\"firstName\",\"lastName\",\"email\"]). Smaller replies are faster.",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_get_member(member_id)
One member by id: profile, contact details, roles, subscriptions, account credit, amount owing, custom fields. Password hashes and payment-provider data are not returned. GET /member/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"member_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "Hello Club member id (24 hex characters) - find it with hello_club_list_members."
}
},
"required": [
"member_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_list_membership_types
The membership types (plans) the club sells: name, fee, term, age limits, renewal rules and access. GET /membership.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_get_membership_type(membership_id)
One membership type by id. GET /membership/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"membership_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "Membership type id."
}
},
"required": [
"membership_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_list_events(from_date, to_date, search, is_recurring, is_hidden, ...)
List or search events and classes (sessions, courses, tournaments) with dates, activity, area, organiser, capacity and attendance rules. Filter by date range, recurring, hidden, public, has attendees, has spaces left, rule type, activity, area or organiser. GET /event.
Eingabe-Schema
{
"type": "object",
"properties": {
"from_date": {
"description": "Events from this date on (use together with to_date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"to_date": {
"description": "Events up to this date (use together with from_date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"search": {
"description": "Free-text search.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"is_recurring": {
"description": "Only recurring events (true) or one-off events (false).",
"type": "boolean"
},
"is_hidden": {
"description": "Only hidden events (true) or visible ones (false).",
"type": "boolean"
},
"is_public": {
"description": "Only public events (true) or member-only ones (false).",
"type": "boolean"
},
"has_attendees": {
"description": "Only events with at least one attendee.",
"type": "boolean"
},
"has_spaces_left": {
"description": "Only events that still have places left.",
"type": "boolean"
},
"rule_type": {
"description": "Only events with this attendance rule type.",
"type": "string",
"enum": [
"free",
"fee",
"coupon",
"membership"
]
},
"activity_id": {
"description": "Only events of this activity id.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"area_id": {
"description": "Only events in this area id.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"organiser_id": {
"description": "Only events organised by this member id.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"membership_id": {
"description": "Only events that can be attended with this membership type id.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"category_id": {
"description": "Only events in this category id.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"fields": {
"description": "Only return these fields of each item (e.g. [\"id\",\"firstName\",\"lastName\",\"email\"]). Smaller replies are faster.",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_get_event(event_id)
One event by id: dates, recurrence, activity, area, organiser, capacity, attendance rules, questions. GET /event/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "Event id - find it with hello_club_list_events."
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_list_event_attendees(event_id, member_id, guest_id, limit, offset, ...)
List who is signed up to events: member or guest, event, sign-up date, paid state, whether they attended. Filter by event, member or guest. GET /eventAttendee.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"description": "Only attendees of this event.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"member_id": {
"description": "Only attendances of this member.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"guest_id": {
"description": "Only attendances of this guest.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"fields": {
"description": "Only return these fields of each item (e.g. [\"id\",\"firstName\",\"lastName\",\"email\"]). Smaller replies are faster.",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_list_bookings(from_date, to_date, search, member_id, activity_id, ...)
List resource bookings (courts, rooms, lanes): owner, activity, area, start/end, paid state, recurrence. Filter by date range, member, activity, mode, area, recurring, paid or removed. GET /booking.
Eingabe-Schema
{
"type": "object",
"properties": {
"from_date": {
"description": "Bookings from this date on (use together with to_date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"to_date": {
"description": "Bookings up to this date (use together with from_date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"search": {
"description": "Free-text search.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"member_id": {
"description": "Only bookings that include this member.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"activity_id": {
"description": "Only bookings of this activity.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"mode_id": {
"description": "Only bookings of this mode.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"area_id": {
"description": "Only bookings of this area.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"is_recurring": {
"description": "Only recurring bookings (true) or one-off bookings (false).",
"type": "boolean"
},
"is_paid": {
"description": "Only paid (true) or unpaid (false) bookings.",
"type": "boolean"
},
"is_removed": {
"description": "Only removed (true) or active (false) bookings.",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"fields": {
"description": "Only return these fields of each item (e.g. [\"id\",\"firstName\",\"lastName\",\"email\"]). Smaller replies are faster.",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_list_transactions(member_id, type, is_paid, is_credit, date_field, ...)
List the club's financial transactions (invoices, charges, credits): member, type, amount, tax, due and payment dates, paid state. Filter by member, type, paid, credit or a date range on date / dueDate / paymentDate. GET /transaction.
Eingabe-Schema
{
"type": "object",
"properties": {
"member_id": {
"description": "Only transactions of this member.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"type": {
"description": "Transaction type.",
"type": "string",
"enum": [
"accountCredit",
"activity",
"booking",
"coupon",
"deposit",
"donation",
"event",
"interclub",
"other",
"purchase",
"resource",
"subscription"
]
},
"is_paid": {
"description": "Only paid (true) or unpaid (false) transactions.",
"type": "boolean"
},
"is_credit": {
"description": "Only credit (true) or charge (false) transactions.",
"type": "boolean"
},
"date_field": {
"description": "Which date from_date / to_date apply to (default date).",
"type": "string",
"enum": [
"date",
"dueDate",
"paymentDate"
]
},
"from_date": {
"description": "From this date on (use together with to_date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"to_date": {
"description": "Up to this date (use together with from_date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"fields": {
"description": "Only return these fields of each item (e.g. [\"id\",\"firstName\",\"lastName\",\"email\"]). Smaller replies are faster.",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_get_transaction(transaction_id)
One transaction by id: member, type, amount, tax, details, dates, paid state. GET /transaction/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"transaction_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "Transaction id - find it with hello_club_list_transactions."
}
},
"required": [
"transaction_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_list_check_ins(member_id, type, is_unknown, search, limit, ...)
List check-in logs (members arriving at the club): who, when, how (type). Filter by member or type, or only unknown people. GET /checkInLog.
Eingabe-Schema
{
"type": "object",
"properties": {
"member_id": {
"description": "Only check-ins of this member.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"type": {
"description": "Check-in type (as recorded by the club).",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"is_unknown": {
"description": "Only check-ins of unknown people (true).",
"type": "boolean"
},
"search": {
"description": "Free-text search.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"fields": {
"description": "Only return these fields of each item (e.g. [\"id\",\"firstName\",\"lastName\",\"email\"]). Smaller replies are faster.",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hello_club_list_access_logs(from_date, to_date, member_id, event_id, door, ...)
List door / access-control logs in a date range: member, door, event, whether it was an override or an unknown person. GET /accessLog.
Eingabe-Schema
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Start of the range (required)."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "End of the range (required)."
},
"member_id": {
"description": "Only entries of this member.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"event_id": {
"description": "Only entries for this event.",
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$"
},
"door": {
"description": "Only entries for this door id.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"is_override": {
"description": "Only manual overrides (true).",
"type": "boolean"
},
"is_unknown": {
"description": "Only unknown people (true).",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"fields": {
"description": "Only return these fields of each item (e.g. [\"id\",\"firstName\",\"lastName\",\"email\"]). Smaller replies are faster.",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$"
}
}
},
"required": [
"from_date",
"to_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡hello_club_create_member(first_name, last_name, email, mobile, phone, ...)
WRITE: create a new member in the club (first and last name required; email, mobile, phone and gender optional). Creates a real member record in the club's database; it does not assign a membership or send an invoice. Not idempotent: calling twice creates two members, so search with hello_club_list_members first. POST /member.
Eingabe-Schema
{
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "First name."
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Last name."
},
"email": {
"description": "Email address.",
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"mobile": {
"description": "Mobile phone number.",
"type": "string",
"minLength": 3,
"maxLength": 40
},
"phone": {
"description": "Other phone number.",
"type": "string",
"minLength": 3,
"maxLength": 40
},
"gender": {
"description": "Gender.",
"type": "string",
"enum": [
"female",
"male",
"other"
]
}
},
"required": [
"first_name",
"last_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hello_club_create_transaction(member_id, type, amount, details, is_credit, ...)
WRITE: create a financial transaction for a member (a charge, or a credit when is_credit is true), e.g. an invoice line or a manual adjustment. This changes the member's amount owing / account credit in the club's books and, with notify_by_email, emails the member. Not idempotent: calling twice creates two transactions. Confirm member, amount and type with the user first. POST /transaction.
Eingabe-Schema
{
"type": "object",
"properties": {
"member_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "Member the transaction is for."
},
"type": {
"type": "string",
"enum": [
"accountCredit",
"activity",
"booking",
"coupon",
"deposit",
"donation",
"event",
"interclub",
"other",
"purchase",
"resource",
"subscription"
],
"description": "Transaction type (use 'other' for a manual charge)."
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "Amount in the club's currency, a positive number (tax inclusive)."
},
"details": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Description shown on the invoice."
},
"is_credit": {
"description": "True = a credit to the member instead of a charge (default false).",
"type": "boolean"
},
"date": {
"description": "Transaction date (default: now).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"due_date": {
"description": "Payment due date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})?)?$"
},
"notify_by_email": {
"description": "Email the member about this transaction (default false).",
"type": "boolean"
}
},
"required": [
"member_id",
"type",
"amount",
"details"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet14 Tools