Magicline Studio MCP

**Destructive, never pre-approved; a human confirms every call.** Assign a membership contract to an existing customer, a REAL, binding contract; confirm details with the user first. Always run preview_add_membership first: this works directly only when the preview's dueOnSigningAmount is 0 (nothing to charge at signing). If it is greater than 0, the signup must go through the studio's payment frontend instead, tell the user rather than attempting it. Get term IDs from get_membership_offer.

Add a communication entry to an existing thread on a customer's record. Same fields as create_communication_thread; thread_status updates the thread (CREATED, ONGOING or CLOSED). The API cannot list or read existing threads, so thread_id must come from a create_communication_thread response, keep that ID if follow-ups are expected; otherwise start a new thread.

Book an appointment for a customer. Times are ISO-8601 with timezone, e.g. '2026-07-22T08:00:00+02:00'. Pick times from get_appointment_slots. Omit instructor_ids to book the first available instructor; pass one to request a specific trainer. Validate with validate_appointment_booking first.

Book a class slot for a customer. Use validate_class_booking first if you are unsure the slot is bookable.

Book a trial-offer appointment for a lead customer. Times are ISO-8601 with timezone; pick them from get_trial_offer_appointment_slots.

Book a trial-offer class slot for a lead customer (create the lead with create_trial_lead first).

Cancel an existing appointment booking by its booking ID.

Cancel an existing class booking by its booking ID.

**Destructive, never pre-approved; a human confirms every call.** Create an ordinary contract cancelation for a customer. cancelation_date is YYYY-MM-DD; get valid reason IDs from get_contract_cancelation_reasons. This is a real cancelation, confirm details with the user first.

Create a manual studio check-in for a customer. Optional ISO-8601 time (e.g. '2026-07-17T10:15:30+01:00'); defaults to now.

Create a manual studio checkout for a customer. Optional ISO-8601 time; defaults to now.

Confirm a trial offer booking. Required when the trial config sets a confirmationOfBookingTerm, unconfirmed bookings are auto-cancelled after the deadline. Returns CONFIRMED, or EXPIRED if confirmed too late.

Log a past communication/interaction on a customer's record as a new thread (e.g. record a phone call or email that happened). NOT for notes on the customer's profile, for profile notes or custom fields (e.g. 'front desk notes') use set_additional_information_fields instead. Threads cannot be read back through this API (write-only). communication_channel: PHONE, EMAIL, CHAT, CONVERSATION, LETTER, TEXT_MESSAGE, FAX or OTHER; communication_direction: INCOMING or OUTGOING; thread_status: CREATED, ONGOING or CLOSED.

Create a new customer (prospect, no contract). date_of_birth is YYYY-MM-DD; country_code and language_code are ISO codes (e.g. 'DE', 'de'); gender is MALE, FEMALE or UNISEX. Address is mandatory in Magicline.

Freeze or pause a membership: create an idle period (hold) on a contract. start_date is YYYY-MM-DD; temporal_unit must be the temporalUnit from get_idle_period_config, with term_value, or set unlimited=true instead. Get valid reason IDs from get_idle_period_config. Run validate_idle_period first.

Create a new lead (prospect). gender is MALE, FEMALE or UNISEX; date_of_birth is YYYY-MM-DD. Check get_lead_config for required fields.

**Destructive, never pre-approved; a human confirms every call.** Create a tax advisor export. The payload follows the Magicline 'Create tax advisor export' schema (period, export options).

Create a lead customer for a trial offer, mandatory before booking a trial session; returns the customerId to book with. Get the trial_offer_config_id from the bookable trial class/appointment, and check get_trial_offer_config for which fields the studio requires. Studios typically reject duplicates by email (DUPLICATE_CUSTOMER).

Preview the charges/fees of changing an existing idle period (pause/freeze), without applying it, e.g. what extending or shortening a freeze would cost. Use end_date to shorten to an exact date (if the config allows it).

Set a customer's additional information field values (custom profile fields), THE tool for putting notes on a customer's profile (e.g. a 'Front desk notes' field), not create_communication_thread (which logs a phone call/email interaction instead). assignments is a list of {"additionalInformationFieldId": <id>, "value": <string>}. This REPLACES the customer's full set of assignments, include every field that should keep its value (current values are in get_customer's additionalInformationFieldAssignments; field IDs come from list_additional_information_fields). To append to an existing note, send the old value plus the new text.

**Destructive, never pre-approved; a human confirms every call.** Sign up a brand-new member: creates the customer AND a REAL, binding membership contract in one step, confirm details with the user first. Always run preview_membership_signup first: this works directly only when the preview's dueOnSigningAmount is 0 (nothing to charge at signing). If it is greater than 0, the signup must go through the studio's payment frontend instead, tell the user rather than attempting it. customer follows the same schema as preview_membership_signup (at minimum firstName, lastName, dateOfBirth, email, street, city, zipCode, countryCode and language {"languageCode": ...}). For an EXISTING customer use add_membership, not this. Get term IDs from get_membership_offer.

..., "active": bool, "customerOverridable": bool}]}. Read the current preferences first, modify, and send the result back.

Change an existing idle period / freeze (extend, shorten, move, or convert an unlimited freeze to a fixed end). Run preview_idle_period_update first to show the customer the resulting charges.

Record a usage of a customer's benefit (consumes one unit of their contingent). Check get_customer_benefits first.

Check whether an additional module could be added to a contract, without purchasing it. IDs come from get_purchasable_additional_modules.

Check whether an appointment can be booked for a customer without booking it, some appointments are restricted to certain memberships. Use before book_appointment. The response carries valid: true/false alongside the raw validationStatus.

Check whether a class slot can be booked for a customer, without booking it. The response carries valid: true/false alongside the raw validationStatus.

Check whether an idle period (pause/freeze/hold) request is valid, catches overlaps, max-term violations and too-early start dates, without creating it. Use before create_idle_period. validationStatus IDLEPERIOD_CREATABLE means the request is valid (also flagged as valid: true). temporal_unit must be exactly the temporalUnit from get_idle_period_config (e.g. a DAY-based contract rejects MONTH with IDLEPERIOD_TEMPORALUNIT_INVALID).

Validate lead data against the studio's lead config without creating it.

Check whether a trial-offer appointment can be booked for a lead customer, without booking it. Use before book_trial_appointment. The response carries valid: true/false alongside the raw validationStatus.

Check whether a trial class slot can be booked for a lead customer, without booking it. Use before book_trial_class. The response carries valid: true/false alongside the raw validationStatus.

Validate trial-lead data against the trial offer config without creating the lead, catches missing required fields and duplicate customers. Use before create_trial_lead. The response carries valid: true/false alongside the raw validationStatus.

Withdraw (undo) an ordinary cancelation of a customer's contract.

Withdraw (cancel) a scheduled idle period / freeze that hasn't started yet. Withdrawn idle periods cannot be reactivated, a new one must be created.