Mariana Tek MCP tools

MCP tool mariana-tek_list_locations

Returns every studio location your Admin account can see. Use location_id from each item in list_classes. Times in other tools use the location's time zone.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_list_locations",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "locations": [
      {
        "location_id": "loc_01",
        "name": "Downtown Studio",
        "address": "120 Main St, Brooklyn, NY",
        "time_zone": "America/New_York"
      },
      {
        "location_id": "loc_02",
        "name": "Riverside Studio",
        "address": "48 River Rd, Hoboken, NJ",
        "time_zone": "America/New_York"
      }
    ]
  },
  "isError": false
}

MCP tool mariana-tek_list_classes

Returns the classes of one location between two dates, earliest first. Filter by instructor to find all classes of one person. Each item has the class_id that the roster and booking tools take, and the number of open spots.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_list_classes",
    "arguments": {
      "from": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "classes": [
      {
        "class_id": "418203",
        "name": "Pilates Sculpt",
        "start": "2026-10-17T09:00:00-04:00",
        "instructor": "Sam Ortiz",
        "capacity": 3,
        "spots_open": 0,
        "waitlist": 1
      },
      {
        "class_id": "418230",
        "name": "HIIT 45",
        "start": "2026-10-17T18:00:00-04:00",
        "instructor": "Alex Rivera",
        "capacity": 20,
        "spots_open": 6,
        "waitlist": 0
      }
    ]
  },
  "isError": false
}

MCP tool mariana-tek_get_class_roster

Returns the roster of one class: every reservation with the spot (Pick-A-Spot layouts only), the payment used and its status, then the waitlist and the standby list. Waitlisted customers are not on the class until Mariana Tek auto-fills a freed spot or staff add them. Use reservation_id from each item to check in or cancel.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_get_class_roster",
    "arguments": {
      "class_id": "class_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "class_id": "418203",
    "class": "Pilates Sculpt",
    "capacity": 3,
    "reservations": [
      {
        "reservation_id": "7710342",
        "customer_id": "90517",
        "customer": "Jamie Park",
        "spot": "1",
        "payment_used": "Unlimited Monthly",
        "status": "reserved"
      },
      {
        "reservation_id": "7710343",
        "customer_id": "90544",
        "customer": "Riley Chen",
        "spot": "2",
        "payment_used": "10 Class Pack",
        "status": "reserved"
      },
      {
        "reservation_id": "7710344",
        "customer_id": "90561",
        "customer": "Morgan Diaz",
        "spot": "3",
        "payment_used": "Intro Offer",
        "status": "reserved"
      }
    ],
    "waitlist": [
      {
        "customer_id": "90602",
        "customer": "Casey Wong",
        "payment_option": "5 Class Pack"
      }
    ],
    "standby": []
  },
  "isError": false
}

MCP tool mariana-tek_find_customer

Searches customer accounts by name, email or phone number and returns the matches with their customer_id. Pass customer_id to get_customer and the booking tools.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_find_customer",
    "arguments": {
      "query": "query"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "customers": [
      {
        "customer_id": "90517",
        "name": "Jamie Park",
        "email": "jamie@example.com",
        "phone": "+1 555 0100"
      }
    ]
  },
  "isError": false
}

MCP tool mariana-tek_get_customer

Returns one customer account with contact details, tags, notes, active memberships and credit packages. Each membership or package has an id you pass as payment_option_id when booking.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_get_customer",
    "arguments": {
      "customer_id": "customer_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "customer_id": "90517",
    "name": "Jamie Park",
    "email": "jamie@example.com",
    "tags": [
      "founding member"
    ],
    "notes": [],
    "memberships": [
      {
        "payment_option_id": "mbr_2231",
        "name": "Unlimited Monthly",
        "status": "active"
      }
    ],
    "credit_packages": []
  },
  "isError": false
}

MCP tool mariana-tek_list_customer_reservations

Returns the reservations of one customer, upcoming by default, soonest first. Switch scope to history to see past classes with their final status. Use reservation_id from each item to cancel.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_list_customer_reservations",
    "arguments": {
      "customer_id": "customer_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reservations": [
      {
        "reservation_id": "7710401",
        "class_id": "418251",
        "class": "Pilates Sculpt",
        "start": "2026-10-19T07:00:00-04:00",
        "instructor": "Sam Ortiz",
        "payment_used": "Unlimited Monthly",
        "status": "reserved"
      }
    ]
  },
  "isError": false
}

MCP tool mariana-tek_list_customer_credits

Returns the credit packages of one customer with credits remaining, the expiration date and how the credits were used. Complimentary credits are included. Set status to expired to see packages that have run out.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_list_customer_credits",
    "arguments": {
      "customer_id": "customer_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "credit_packages": [
      {
        "name": "10 Class Pack",
        "credits_remaining": 2,
        "expires_on": "2026-10-31",
        "usage": [
          {
            "class": "HIIT 45",
            "date": "2026-10-08"
          }
        ]
      }
    ]
  },
  "isError": false
}

MCP tool mariana-tek_book_reservation

Books one customer into one class and pays with a membership or credit package of that customer. Leave payment_option_id out to use the first valid option. For Pick-A-Spot classes pass spot, otherwise any open spot is used. The reservation is pending until Mariana Tek confirms it. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_book_reservation",
    "arguments": {
      "class_id": "418203",
      "customer_id": "90517",
      "payment_option_id": "mbr_2231"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reservation_id": "7710342",
    "class_id": "418203",
    "class": "Pilates Sculpt",
    "start": "2026-10-17T09:00:00-04:00",
    "customer": "Jamie Park",
    "payment_used": "Unlimited Monthly",
    "spot": "1",
    "status": "pending"
  },
  "isError": false
}

MCP tool mariana-tek_add_to_waitlist

Puts one customer on the waitlist of a class that is full, with the payment option you choose. The customer is not booked yet: inside the waitlist auto-fill window Mariana Tek moves the top customer in when a spot frees up; after it, staff add people by hand. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_add_to_waitlist",
    "arguments": {
      "class_id": "class_8c41d2",
      "customer_id": "customer_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "class_id": "418203",
    "customer_id": "90602",
    "customer": "Casey Wong",
    "payment_option": "5 Class Pack",
    "status": "waitlisted",
    "position": 1
  },
  "isError": false
}

MCP tool mariana-tek_cancel_reservation

Cancels one reservation. Inside the late cancel window, waive_penalty true cancels without the fee (a Graced Cancel) if your role has that permission; without it the fee applies. The cancellation stays in the customer's history. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_cancel_reservation",
    "arguments": {
      "reservation_id": "7710401",
      "waive_penalty": true
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reservation_id": "7710401",
    "class_id": "418251",
    "status": "graced_cancel",
    "penalty_applied": false
  },
  "isError": false
}

MCP tool mariana-tek_check_in_customer

Marks one reservation as checked in. It takes a reservation_id, so waitlisted customers cannot be checked in. Nothing is sent to the customer. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_check_in_customer",
    "arguments": {
      "reservation_id": "reservation_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reservation_id": "7710342",
    "class_id": "418203",
    "customer": "Jamie Park",
    "status": "checked_in"
  },
  "isError": false
}

MCP tool mariana-tek_give_complimentary_credits

Gives one customer a quantity of one credit type, like Give Credits on the Credits tab in Admin. The credit type must be active in your studio. Credits expire at midnight local time on the date you set, and the reason is saved on the account. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_give_complimentary_credits",
    "arguments": {
      "customer_id": "90517",
      "credit_type": "Class Credit",
      "quantity": 1,
      "expires_on": "2026-11-11",
      "reason": "Class cut short"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "customer_id": "90517",
    "credit_type": "Class Credit",
    "quantity": 1,
    "expires_on": "2026-11-16",
    "reason": "Class cut short by power outage",
    "status": "given"
  },
  "isError": false
}

MCP tool mariana-tek_add_customer_note

Adds a note to one customer account. It sends nothing to the customer or anyone else, so add_customer_note runs without asking first.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_add_customer_note",
    "arguments": {
      "customer_id": "customer_8c41d2",
      "text": "text"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "customer_id": "90517",
    "note": "Travelling Oct 19 to 23, late cancels waived by studio.",
    "status": "added"
  },
  "isError": false
}

MCP tool mariana-tek_assign_substitute

Sets a substitute instructor on one class. It changes the instructor only and sends no email; use message_class to tell the class. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_assign_substitute",
    "arguments": {
      "class_id": "418230",
      "instructor": "Taylor Kim"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "class_id": "418230",
    "class": "HIIT 45",
    "instructor": "Taylor Kim",
    "previous_instructor": "Alex Rivera",
    "customers_notified": false
  },
  "isError": false
}

MCP tool mariana-tek_message_class

Emails everyone booked in one class, plus the waitlist and standby customers, from the studio's default address. The response counts the recipients. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mariana-tek_message_class",
    "arguments": {
      "class_id": "class_8c41d2",
      "message": "message"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "class_id": "418230",
    "recipients": 14,
    "reservations": 12,
    "waitlist": 2,
    "standby": 0,
    "status": "sent"
  },
  "isError": false
}