Hello Club MCP by usefulapi
Read Hello Club members, events, bookings and transactions; add members and charges.
我该使用它吗
质量与安全性
A
发现（2）
- LOWTool 'hello_club_list_membership_types' name length outside 3-30 range在 hello_club_list_membership_types 中
- LOWTool 'hello_club_list_event_attendees' name length outside 3-30 range在 hello_club_list_event_attendees 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~5,427token 数（工具定义）
~3.1 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 4.24%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"hello-club": {
"url": "https://hello-club.usefulapi.io/mcp"
}
}
}远程端点
https://hello-club.usefulapi.io/mcpstreamable-http它能做什么
工具清单
工具（14）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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"
}社区
证据
最近观测
已验证未记录版本14 个工具