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

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
90%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~4,426Tokens (Tool-Definitionen)
~1.5 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (3.46% 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": {
    "timetableos": {
      "url": "https://timetableos.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://timetableos.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (23)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet23 Tools