TimetableOS MCP by usefulapi
Read members, memberships, sessions and bookings; book members and capture leads in TimetableOS.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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": {
"timetableos": {
"url": "https://timetableos.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://timetableos.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (23)
🟢timetableos_check_key
Show the business this API key belongs to and what the key may do (its scopes and locations). Needs no scope. Use it first to test a key. API: GET /ping.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_members(q, status, tag, email, gym_id, ...)
List members of the studio. Filter by name, email, phone or member number (q), status, tag, home location or changes since a time. Needs members:read. API: GET /members.
Eingabe-Schema
{
"type": "object",
"properties": {
"q": {
"description": "Name, email, phone or member number.",
"type": "string"
},
"status": {
"description": "One status: lead, prospect, active, frozen, cancelled or former.",
"type": "string"
},
"tag": {
"description": "One tag.",
"type": "string"
},
"email": {
"description": "Exact email address.",
"type": "string"
},
"gym_id": {
"description": "Home location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"updated_since": {
"description": "Only members changed at or after this time (ISO 8601, UTC).",
"type": "string"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_member(id)
Get one member by id: name, contact details, status, home location, tags and join date. Needs members:read. API: GET /members/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_memberships(member_id, status, plan_id, page, per_page)
List memberships, the plans members hold. Filter by member, status or plan. Needs memberships:read. API: GET /memberships.
Eingabe-Schema
{
"type": "object",
"properties": {
"member_id": {
"description": "One member id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"status": {
"description": "One status: pending, active, past_due, frozen, cancelled, ended or expired.",
"type": "string"
},
"plan_id": {
"description": "One plan id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_membership(id)
Get one membership: its plan, status, price, billing dates and visits left. Needs memberships:read. API: GET /memberships/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_plans(status, kind, page, per_page)
List membership plans and passes the studio sells (price, billing, visits). Needs plans:read. API: GET /plans.
Eingabe-Schema
{
"type": "object",
"properties": {
"status": {
"description": "draft, active or archived. Default active.",
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"recurring",
"pass",
"pack"
]
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_plan(id)
Get one membership plan: price, signup fee, billing interval and eligible locations. Needs plans:read. API: GET /plans/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_classes(status, kind, page, per_page)
List the classes, appointments, workshops and open-access offers of the studio. Needs classes:read. API: GET /classes.
Eingabe-Schema
{
"type": "object",
"properties": {
"status": {
"description": "active or archived. Default active.",
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"class",
"appointment",
"workshop",
"open_access"
]
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_class(id)
Get one class: duration, capacity, drop-in price and waitlist setting. Needs classes:read. API: GET /classes/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_sessions(from, to, class_id, gym_id, status, ...)
List scheduled sessions (occurrences) of the classes in a time window, with capacity, booked count, spots left and waitlist. Needs classes:read. API: GET /occurrences.
Eingabe-Schema
{
"type": "object",
"properties": {
"from": {
"description": "Start of the window, ISO 8601. Default now.",
"type": "string"
},
"to": {
"description": "End of the window, ISO 8601 (exclusive).",
"type": "string"
},
"class_id": {
"description": "One class id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"gym_id": {
"description": "One location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"status": {
"description": "scheduled, cancelled or completed.",
"type": "string"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_session(id)
Get one scheduled session: class, start and end, room, instructor, capacity and spots left. Needs classes:read. API: GET /occurrences/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_bookings(occurrence_id, member_id, status, page, per_page)
List bookings (reservations) by session, member or status. Needs bookings:read. API: GET /reservations.
Eingabe-Schema
{
"type": "object",
"properties": {
"occurrence_id": {
"description": "One session id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"member_id": {
"description": "One member id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"status": {
"description": "booked, waitlisted, checked_in, cancelled, late_cancelled or no_show.",
"type": "string"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_booking(id)
Get one booking (reservation): session, member, status and check-in time. Needs bookings:read. API: GET /reservations/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_invoices(status, kind, membership_id, member_id, due_from, ...)
List invoices by status, kind, membership, member or due date. Read only: no payment or refund. Needs invoices:read. API: GET /invoices.
Eingabe-Schema
{
"type": "object",
"properties": {
"status": {
"description": "open, paid, failed, void or refunded.",
"type": "string"
},
"kind": {
"description": "recurring, signup and others.",
"type": "string"
},
"membership_id": {
"description": "One membership id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"member_id": {
"description": "One member id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"due_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"due_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_invoice(id)
Get one invoice: amount, tax, due date, payment status and failure reason. Read only. Needs invoices:read. API: GET /invoices/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_list_products(status, category, q, page, per_page)
List shop products (retail items) with price and stock. Needs products:read. API: GET /products.
Eingabe-Schema
{
"type": "object",
"properties": {
"status": {
"description": "active or archived. Default active.",
"type": "string"
},
"category": {
"description": "One category.",
"type": "string"
},
"q": {
"description": "Part of the product name.",
"type": "string"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Items per page, at most 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetableos_get_product(id)
Get one shop product: name, SKU, price, stock and locations. Needs products:read. API: GET /products/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timetableos_create_member(first_name, last_name, email, phone_number, date_of_birth, ...)
Create a member (a lead, prospect or active member) in the studio. Writes a record. Needs members:write. API: POST /members.
Eingabe-Schema
{
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"description": "First name (required)."
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"date_of_birth": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"status": {
"type": "string",
"enum": [
"lead",
"prospect",
"active",
"frozen",
"cancelled",
"former"
]
},
"source": {
"type": "string",
"enum": [
"website_form",
"walk_in",
"referral",
"social",
"phone",
"other"
]
},
"home_gym_id": {
"description": "Home location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"idempotency_key": {
"description": "Optional Idempotency-Key. Send the same key again to retry a call safely: the first answer comes back and the work is done once. When omitted, a new key is used.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"first_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡timetableos_update_member(id, first_name, last_name, email, phone_number, ...)
Change fields of one member: contact details, status, home location or tags. Only the fields you pass change. Needs members:write. API: PATCH /members/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
},
"first_name": {
"type": "string",
"minLength": 1
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"date_of_birth": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"status": {
"type": "string",
"enum": [
"lead",
"prospect",
"active",
"frozen",
"cancelled",
"former"
]
},
"source": {
"description": "Lead source label, as the studio uses it.",
"type": "string"
},
"home_gym_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timetableos_book_member(occurrence_id, member_id, idempotency_key)
Book a member into a scheduled session, with the front desk rules (capacity, waitlist, blocking flags, entitlement). A visit that would need payment is refused. Needs bookings:write. API: POST /reservations.
Eingabe-Schema
{
"type": "object",
"properties": {
"occurrence_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Session id (from timetableos_list_sessions)."
},
"member_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Member id."
},
"idempotency_key": {
"description": "Optional Idempotency-Key. Send the same key again to retry a call safely: the first answer comes back and the work is done once. When omitted, a new key is used.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"occurrence_id",
"member_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timetableos_cancel_booking(id, reason, idempotency_key)
Cancel one booking (reservation), with an optional reason. Cancels the seat for the member. Needs bookings:write. API: POST /reservations/{id}/cancel.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id."
},
"reason": {
"description": "Optional reason, kept on the booking.",
"type": "string"
},
"idempotency_key": {
"description": "Optional Idempotency-Key. Send the same key again to retry a call safely: the first answer comes back and the work is done once. When omitted, a new key is used.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timetableos_record_check_in(member_id, code, gym_id, source, idempotency_key)
Record a member check-in at the door, kiosk or app. Returns whether the check-in is allowed and why not if it is not. Needs checkins:write. API: POST /check-ins.
Eingabe-Schema
{
"type": "object",
"properties": {
"member_id": {
"description": "Member id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"code": {
"description": "Member code or QR code, when no member id is known.",
"type": "string"
},
"gym_id": {
"description": "Location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"source": {
"type": "string",
"enum": [
"desk",
"qr",
"kiosk"
]
},
"idempotency_key": {
"description": "Optional Idempotency-Key. Send the same key again to retry a call safely: the first answer comes back and the work is done once. When omitted, a new key is used.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timetableos_capture_lead(name, first_name, last_name, email, phone, ...)
Capture an enquiry as a lead, the same way the studio's website form does. Needs leads:write. API: POST /leads.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Full name, when first and last name are not split.",
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"interest": {
"description": "What the person wants, e.g. a class or a plan.",
"type": "string"
},
"message": {
"type": "string"
},
"source": {
"type": "string",
"enum": [
"website_form",
"walk_in",
"referral",
"social",
"phone",
"other"
]
},
"source_detail": {
"type": "string"
},
"gym_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"consented": {
"description": "Whether the person agreed to be contacted.",
"type": "boolean"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"idempotency_key": {
"description": "Optional Idempotency-Key. Send the same key again to retry a call safely: the first answer comes back and the work is done once. When omitted, a new key is used.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis