Phorme Training

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Coach-built training: coaching brains, programs, race plans, gyms, clinics, demos and your log.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Phorme Training": {
      "url": "https://phor.me/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (49)

• preview_workout_import

  Use this when the user wants a single workout they can follow and track in Phorme: one written in this conversation, pasted from notes, or built to fit their time and equipment. It checks the workout, matches each exercise to the Phorme movement library with a demo link, flags anything that needs equipment the user did not list or runs past their time, and stores a private preview for 24 hours. It does not save training to any account. Do not use it for multiweek programs, nutrition plans, or pain and injury questions.

  Parameters:

  • workout (required) — object — The workout to preview, taken from this conversation.
  • origin — string — Use "sport_week" when the workout is a session returned by preview_sport_week. Otherwise leave out.
  • time_limit_minutes — integer — Minutes the user said they have. Leave out when the user did not say.
  • available_equipment — array — Equipment the user said they have, for example ["dumbbells", "bench"] or ["none"]. Leave out when the user did not say.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• save_workout_to_phorme

  Use this when the user has seen a workout preview and clearly said to save it. It saves that preview to the connected Phorme account as a private workout and returns a link that opens it in Phorme. It needs a connected Phorme account with the training:write permission. Retrying with the same idempotency_key returns the same saved workout and does not create a second copy.

  Parameters:

  • preview_id (required) — string — The preview_id of the preview being saved.
  • confirmation (required) — boolean — Set to true only after the user clearly confirmed this save in the conversation.
  • idempotency_key (required) — string — A unique string for this save. Reuse the same value when retrying so no second copy is created.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• preview_program_import

  Use this when the user wants to turn a multiweek training program from this conversation into trackable Phorme training. It checks every week and workout, matches exercises to the Phorme movement library, and stores a private preview for 24 hours. It does not save training to any account. Do not use it for a single workout, nutrition plans or medical questions.

  Parameters:

  • program (required) — object — The multiweek program to preview, taken from this conversation. At most 500 workouts in total.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• save_program_to_phorme

  Use this when the user has seen a program preview and clearly said to save it. It saves that preview to the connected Phorme account as a private program and returns a link that opens it in Phorme. It needs a connected Phorme account with the training:write permission and a Phorme membership that already includes programs. If the account does not have that membership the tool says so and saves nothing. It never starts a purchase. Retrying with the same idempotency_key does not create a second copy.

  Parameters:

  • preview_id (required) — string — The preview_id of the preview being saved.
  • confirmation (required) — boolean — Set to true only after the user clearly confirmed this save in the conversation.
  • idempotency_key (required) — string — A unique string for this save. Reuse the same value when retrying so no second copy is created.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_saved_training read-only

  Use this when the user asks about a workout or program already saved to Phorme in this conversation, for example to get its Phorme link again. It returns the title and open link for training owned by the connected Phorme account and changes nothing. It needs the training_id from that save. It cannot list, search, edit or delete training.

  Parameters:

  • training_kind (required) — string — Whether the saved item is a workout or a program.
  • training_id (required) — string — The training_id returned by save_workout_to_phorme or save_program_to_phorme.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• render_training_import read-only

  Use this to show a compact Phorme card for a workout or program that was just previewed or saved. It displays only the title, counts, status and link it is given. It reads and changes nothing in Phorme.

  Parameters:

  • title — string — Training title from the tool result.
  • status — string — "preview" for training not yet saved, "saved" for training saved to Phorme.
  • open_url — string — Link that opens the saved training in Phorme. Not set for previews.
  • training_kind — string
  • warning_count — integer
  • exercise_count — integer
  • estimated_duration_minutes — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• preview_sport_week read-only

  Use this when the user plays a sport and wants their gym days for a week planned around it, for example two lifting days during basketball season. It picks the closest coach-built Phorme sport program and returns one week of sessions sized to the days the user has, with sets, reps, coach notes and a demo link for each exercise. It reads only and changes nothing in any account. If Phorme has no program for that sport it says so in match_quality and limits. Do not use it for injury rehab, team practice plans for children, or nutrition.

  Parameters:

  • sport (required) — string — The sport or position, for example "basketball", "volleyball" or "wide receiver".
  • gym_days_per_week (required) — integer — Gym days the user has this week. Ask when the user did not say.
  • season_phase — string — Where the user is in their season, only if they said.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_races read-only

  Use this when the user is looking for a race to enter, for example "which 70.3 can I do in South America next spring", "marathons in Europe in April" or "a HYROX near Riga". It lists races from Phorme's verified race listings that fit the kind of race, the place (a country, city or region) and the months asked, by date only, each with its city, date, its own page, its registration as the organiser last showed it, and whether Phorme has a plan that counts back to it. When the organiser has given them, the race's own logistics are included: where to pick up the race packet, the nearest airport, getting there and the official hotels the organiser lists, with the page they came from. It reads only and changes nothing. Only races in Phorme's listings are returned, with the dates the listings give.

  Parameters:

  • kind — string — The kind of race, for example "70.3", "triathlon", "marathon", "half marathon" or "HYROX". Leave out for any.
  • where — string — A country, city or region, for example "Colombia", "Barranquilla" or "South America". Leave out for anywhere.
  • to_month — string — Last month, YYYY-MM, only if the user gave a window.
  • from_month — string — First month, YYYY-MM, only if the user gave a window.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• plan_for_race read-only

  Use this when the user names a race they are training for, for example "IRONMAN 70.3 Barranquilla", "I signed up for the half ironman in Cartagena" or "Chicago Marathon". It finds the race in Phorme's race listings (name, date, city and the race's own page), counts the weeks to race day, and returns the week of Phorme's plan for that kind of race that lines up with race day, with sets, reps, paces, coach notes and a demo link for each exercise. For a triathlon (IRONMAN 70.3, 5150, full) it is swim, bike and run in one plan, with efforts until the athlete's swim and bike tests are in. When the organiser has given them, the race's own logistics come with it (venue, where to pick up the race packet, airport, official hotels from the organiser), with the page and date they were read. It reads only and changes nothing. If the race is not listed it says so; never guess a race date. Do not use it for injury rehab or nutrition.

  Parameters:

  • race (required) — string — The race as the user named it, for example "IRONMAN 70.3 Barranquilla".

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_coaching_brain read-only

  Use this when the user wants a way to train for a goal or sport, for example "I want to get more explosive for basketball", "build muscle three days a week" or "train for a half marathon", or wants to train with a named coach, for example "train with Cameron Goodson", and has not picked a programme, or has a coach code someone gave them, for example K7Q2-XR4D. Phorme coaching brains are curated training methods: a coach, the principles the method trains by, and a coach-built programme. It returns up to three brains that fit, best first, each with its coach, focus, how it trains and its programmes with weeks and days a week; with a coach named, only that coach's brains; with a code, the one brain it belongs to and its page. It reads only and changes nothing. Do not use it for injury rehab or nutrition.

  Parameters:

  • code — string — A Phorme coach code exactly as the user gave it, for example "K7Q2-XR4D", or a phor.me/c/ link. Only when they gave one.
  • goal — string — What the user wants from training, in their words, for example "jump higher" or "first HYROX race". Needed unless a code is given.
  • coach — string — A coach the user named, for example "Cameron Goodson". Only that coach's brains are returned.
  • sport — string — The sport or position, only if the user named one.
  • days_per_week — integer — Training days a week, only if the user said.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_gym_class read-only

  Use this when the user wants a gym, studio or class to train at in person, for example "a strength class in Austin this week" or "a gym near me". It returns up to five Phorme gyms, studios and other places to train in the city named or within 60 km (or radius_km) of the position given, nearest or best matching first, each with its page on phor.me and its classes in the coming days with the class id, local start time, length, places left and a link to book on phor.me. When nothing matches it returns alternatives: the nearest places further out, and a home plan from a Phorme coaching brain. It reads only and shows no prices; booking a class for a signed-in user is a separate step.

  Parameters:

  • city — string — The city the user named, for example "Austin".
  • days — integer — How many days ahead to look. Default 7.
  • near_lat — number — Latitude, only if the user shared their position.
  • near_lon — number — Longitude, only if the user shared their position.
  • radius_km — integer — How far from the shared position to look, in km. Default 60. Use a larger one only when the user said they would travel.
  • class_type — string — The kind of class, only if the user said, for example "barbell" or "yoga".

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• book_gym_class

  Use this when a signed-in user wants a place in one class at a Phorme gym or studio. Confirm the class, the day and time, and the gym with the user first, and set confirmation to true only after they said yes. It books the class for the connected Phorme account: booked when there is a spot, on the waitlist when it is full, a spot held for 15 minutes when the class is paid, or a request the gym is told about when the gym has not opened booking on Phorme yet. A paid class is paid on Phorme's own payment page, through a link in the result. This tool takes no payment, names no amount and never sells a subscription or membership. Booking the same class again returns the same booking. It needs a connected Phorme account with the training:write permission.

  Parameters:

  • class_id (required) — string — The class_id of the class, from find_gym_class.
  • confirmation (required) — boolean — Set to true only after the user said yes to this class, day, time and gym.
  • place_id — string — The place_id of its gym or studio, from the same find_gym_class result.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• cancel_gym_booking destructive

  Use this when a signed-in user wants to give up a class they booked, are on the waitlist for, or asked a gym for on Phorme. Confirm which class with the user first, and set confirmation to true only after they said yes. It cancels that booking for the connected Phorme account and frees the spot for the next person on the waitlist. It takes the booking id, or the class id of the booked class. Sales are final, so a paid class is not refunded. It needs a connected Phorme account with the training:write permission.

  Parameters:

  • confirmation (required) — boolean — Set to true only after the user said yes to cancelling this class.
  • class_id — string — The class_id of the booked class, when the booking_id is not known.
  • booking_id — string — The booking_id from book_gym_class. Give this or class_id.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• find_clinic read-only

  Use this when the user wants to be seen in person by a physical therapist, sports medicine clinic, chiropractor, sports massage therapist or recovery studio, in a city they name or near a position they share. It returns up to five Phorme clinic and recovery partners, nearest or best matching first, each with the kind of care, the services it lists, its page on phor.me and a link to ask for an appointment there. It takes a place and a kind of care, never symptoms. It reads only, does not diagnose or treat, shows no prices and books nothing.

  Parameters:

  • care — string — The kind of care the user asked for, only if they named one.
  • city — string — The city the user named, for example "Austin".
  • near_lat — number — Latitude, only if the user shared their position.
  • near_lon — number — Longitude, only if the user shared their position.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_personal_coach read-only

  Use this when the user wants a human coach of their own: 1:1 coaching, someone who writes their program for them, checks in each week, reviews how they move or answers their messages, for example "I want a real coach for basketball" or "can someone coach me one on one?". It returns the Phorme coaches taking 1:1 clients now, with what the coaching includes, how many spots are open and the coach's page, where the terms and joining are. It shows no prices, books nothing and changes nothing. Coaching is training, not medical care.

  Parameters:

  • goal — string — What the user wants coaching for, in their words, only if they said.
  • sport — string — Their sport, only if they named one.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_place_in_ai

  Use this when the owner or manager of a gym, studio, sports clinic or race asks whether ChatGPT knows their place or race or recommends it, for example "does ChatGPT recommend my gym?", "what does AI say about my physio clinic in Austin?" or "does ChatGPT know our triathlon?". It asks OpenAI's model with web search two questions a customer or athlete would ask: about the place or race, and for the best of its kind in its city. It returns whether it was found, whether it was named among the best and who was named instead, which of five facts a customer needs were stated (where, hours, classes or treatments, prices, how to book; for a race: where it starts, race date, course, entry fee, how to register), the pages it cited, and a link to the full result. Prices are reported only as stated or not, and a fact counts as stated only when the answer gave it. It also returns a free next step: a link to claim the place on Phorme (for a race, the race organiser page). It takes up to a minute, reuses a check of the same place from the last week, and saves the result as a share page; it changes nothing about the place on Phorme. It is for owners and managers, not for rating a place for someone choosing where to go.

  Parameters:

  • place (required) — string — The gym, clinic or race's name, as the owner or organiser wrote it.
  • city (required) — string — The city it is in (for a race, where it is held).
  • kind — string — What kind of place it is, as a customer would search. Defaults to gyms.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• find_exercise_swap read-only

  Use this when the user needs a replacement for one exercise because they do not have the equipment, the station is taken, or they want a different option, for example no cable machine for cable rows. It returns up to five Phorme library movements of the same kind that the user's equipment allows, each with a demo link, and says so when it has to offer the nearest kind instead. It reads only and changes nothing, including any saved plan. Do not use it to work around pain or injury.

  Parameters:

  • exercise (required) — string — The exercise to replace, as the user wrote it, for example "Seated cable row".
  • available_equipment (required) — array — Equipment the user has, for example ["dumbbells", "bench"] or ["none"]. Ask when the user did not say.
  • reason — string — Why they need a swap, only if they said.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_training_history read-only

  Use this when the user asks about their own training logged in Phorme: what they did last time, how often they trained, their personal records, or a next workout built on their recent sessions. It returns their most recent logged workouts with each exercise's sets, best set, estimated max and volume, how many workouts they logged in the last 7 and 30 days, and their latest records. It reads only and changes nothing. It needs a connected Phorme account. Weights are in pounds.

  Parameters:

  • limit — integer — How many recent workouts to return, newest first. Defaults to 10.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_lift_progress read-only

  Use this when the user asks how one of their lifts is progressing or wants it graphed, for example "how is my bench going" or "chart my squat over six months". It finds the lift in their Phorme log by the words they use and returns one point per session with the best set, estimated max and volume, the change over the period and their best session, and shows a chart card. It reads only and changes nothing. It needs a connected Phorme account. Weights are in pounds. If no lift matched it lists the lifts they have logged.

  Parameters:

  • movement (required) — string — The lift as the user said it, for example "bench", "back squat" or "RDL".
  • months — integer — How many months back to look. Defaults to 6.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_planned_sessions read-only

  Use this when the user asks what their Phorme plan has for today or the coming days, for example "what is my workout today". It returns each planned session with its exercises, sets, reps and the loads Phorme set from their own maxes. It reads only and changes nothing, including the plan. It needs a connected Phorme account. Weights are in pounds.

  Parameters:

  • days — integer — How many days ahead, starting today. Defaults to 7.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_my_coaching_business read-only

  Use this when a Phorme coach asks about their own coaching brains: how many members train under each, who went quiet, what they have earned, and whether a note to members can go today. It reads only and changes nothing. It needs a connected Phorme account; an account without a coaching brain gets the address of the coach console.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• start_my_coaching_brain

  Use this when a coach or trainer wants to turn their own method into a Phorme coaching brain and has none yet, or asks for a new one. It creates a draft brain with the name they chose and their method in their own words; members see nothing until the coach publishes it in the coach console. A first program can then be saved to it as a draft. It needs a connected Phorme account; signing in with a phone number creates one.

  Parameters:

  • name (required) — string — The brain's name, as the coach chose it, for example "Hayes Strength".
  • confirmation (required) — boolean — True only after the coach confirmed the name and method.
  • method — string — How the coach trains people, in their own words from this conversation. Never invented.
  • tagline — string — One line on who it is for, in the coach's words.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• save_program_to_my_coaching_brain

  Use this when a Phorme coach has written a program in this conversation and clearly said to save it to one of their coaching brains. It saves the program as a draft on that brain (session names, exercises, sets and reps); members see nothing until the coach adds the draft in the coach console. It needs a connected Phorme account that owns the brain.

  Parameters:

  • brain_id (required) — string — The brain id from the coach's brains.
  • title (required) — string
  • sessions (required) — array — One week of sessions; the app repeats and progresses it.
  • confirmation (required) — boolean — True only after the coach confirmed this save.
  • weeks — integer — How many weeks the program runs. Defaults to 4.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• send_note_to_my_members

  Use this when a Phorme coach has written a short note to everyone training under one of their published coaching brains and clearly said to send it. It sends the coach's words as they are, as a notification and in each member's coach history: up to 400 characters, no links, one note per brain per day. It needs a connected Phorme account with an active coach plan that owns the brain.

  Parameters:

  • brain_id (required) — string
  • text (required) — string — The coach's own words, exactly as they approved them.
  • confirmation (required) — boolean — True only after the coach confirmed this exact note.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• set_my_brain_rules

  Use this when a Phorme coach describes how they coach and wants their coaching brain to follow it, for example "every session starts with mobility, main lifts stay in 3 to 6 reps, never two hard days in a row". Sent with the coach's words, it reads them into the brain's rules and saves nothing: it returns the rules, one plain line per rule, and what no rule covers yet. Sent with those rules and confirmation, it saves them, and Phorme checks the brain on sample members and says whether every plan still works. Members train by the saved rules from their next session. It needs a connected Phorme account that owns the brain; set confirmation to true only after the coach said yes to the rules as read back.

  Parameters:

  • brain_id (required) — string — The brain id from the coach's brains.
  • text — string — How the coach coaches, in their own words from this conversation. Never invented. Sent to read a draft.
  • rules — object — The rules a draft returned, unchanged or as the coach corrected them: method, voice, banned_phrases and share. Sent to save.
  • confirmation — boolean — True only after the coach confirmed these rules. Needed to save.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_my_brain_code

  Use this when a Phorme coach asks for the code or link to share one of their coaching brains, for example "what is my coach code?". Each brain has one code, like K7Q2-XR4D, made the first time it is asked for and kept as the brain changes. Anyone who types it in the Phorme app or opens its link starts with that brain. It needs a connected Phorme account that owns the brain.

  Parameters:

  • brain_id (required) — string — The brain id from the coach's brains.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• copy_coach_from_code

  Use this when a coach has another coach's Phorme code and wants to start their own coaching brain from it, for example "start my brain from K7Q2-XR4D". Sent with the code alone, it shows whose brain it is and whether its coach lets other coaches copy it, and changes nothing. Sent with a name and confirmation, it makes a new draft brain from it with its rules and programs, which the coach then makes their own; the coach who made it keeps 10% of what the copy earns. It needs a connected Phorme account; set confirmation to true only after the coach said yes and chose the name.

  Parameters:

  • code (required) — string — The code as the coach gave it, for example "K7Q2-XR4D", or its phor.me/c/ link.
  • name — string — The name the coach chose for their copy. Needed to copy.
  • confirmation — boolean — True only after the coach confirmed the copy and its name.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_gym_report read-only

  Use this when a gym, studio or clinic owner asks about their own places on Phorme: what is listed, what is live, and how each place did, for example "how is my gym doing on Phorme?" or "did anyone book this week?". It returns each place the connected account lists, with its page and status, and its report: times shown by assistants, page views, asks held, bookings, requests, members and the share earned. A place on the free listing shows a little reach and what it missed; the rest is locked, the same as the web console. It reads only and changes nothing. It needs a connected Phorme account.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_or_claim_place

  Use this when a gym, studio or clinic owner wants their place on Phorme, for example after an AI check, or says "list my gym". Confirm the name, city and address with the owner first, and set confirmation to true only after they said yes. It lists the place for the connected account as a draft nobody sees yet, with its page facts, and finds the map pin from the address. If the account already lists a place with that name in that city it returns that place and changes nothing. Listing is free; it takes no payment and starts no plan. It needs a connected Phorme account.

  Parameters:

  • name (required) — string — The place's name, as the owner wrote it.
  • city (required) — string
  • country (required) — string — For example "United States".
  • confirmation (required) — boolean — Set to true only after the owner said yes to listing this place.
  • lat — number — Latitude of the map pin, only to set it by hand.
  • lon — number — Longitude of the map pin, only to set it by hand.
  • kind — string — What the place is: gym (also studios and boxes) or a kind of care.
  • line — string — One line on what the place is, in the owner's words.
  • about — string — One or two plain sentences about the place, in the owner's words.
  • hours — array — Opening hours, one line each, for example ["Mon to Fri, 6 am to 9 pm", "Sat, 8 am to noon"].
  • phone — string — The place's public phone number, as the owner gave it.
  • prices — ['string', 'array'] — What training at the place costs, shown on its page, in the owner's own words: one line each, for example "Drop-in 25 dollars", or { label, amount (in dollars) or amount_cents, period, note }. At most 12; an empty list clears them. Repeat them only to the owner.
  • address — string — The street address. The map pin is found from it.
  • website — string — The place's own website, starting with https://.
  • book_url — string — The place's own booking page, starting with https://.
  • timezone — string — The place's IANA time zone, for example "America/Chicago".
  • book_label — string — The words on its booking button, for example "Book a class".
  • request_email — string — Where booking confirmations and requests are emailed. Never shown in public.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_place

  Use this when an owner wants to change what their place's page says: name, address, hours, booking link, what kind of place it is, the line about it, its time zone, its phone, its price list or the email for requests. Read the change back to the owner first, and set confirmation to true only after they said yes. Only the things given change; an empty value clears one. A new address moves the map pin. A live page shows the change at once. The price list only shows what the place charges; nothing is sold here. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • confirmation (required) — boolean — Set to true only after the owner said yes to these changes.
  • lat — number — Latitude of the map pin, only to set it by hand.
  • lon — number — Longitude of the map pin, only to set it by hand.
  • city — string
  • kind — string — What the place is: gym (also studios and boxes) or a kind of care.
  • line — string — One line on what the place is, in the owner's words.
  • name — string
  • about — string — One or two plain sentences about the place, in the owner's words.
  • hours — array — Opening hours, one line each, for example ["Mon to Fri, 6 am to 9 pm", "Sat, 8 am to noon"].
  • phone — string — The place's public phone number, as the owner gave it.
  • prices — ['string', 'array'] — What training at the place costs, shown on its page, in the owner's own words: one line each, for example "Drop-in 25 dollars", or { label, amount (in dollars) or amount_cents, period, note }. At most 12; an empty list clears them. Repeat them only to the owner.
  • address — string — The street address. The map pin is found from it.
  • country — string
  • website — string — The place's own website, starting with https://.
  • book_url — string — The place's own booking page, starting with https://.
  • timezone — string — The place's IANA time zone, for example "America/Chicago".
  • book_label — string — The words on its booking button, for example "Book a class".
  • request_email — string — Where booking confirmations and requests are emailed. Never shown in public.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• set_class_schedule destructive

  Use this when an owner wants to see, add, change or cancel a class at their place. action list reads the schedule and changes nothing. For add, edit and cancel, read the class, day and time back to the owner first, and set confirmation to true only after they said yes. A class people booked keeps its time, length and price; a class members paid for cannot be cancelled here. Members pay for a paid class on Phorme's own payment page; this tool takes no payment. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • action (required) — string
  • line — string — One line on the class.
  • title — string — The class name, for example "Barbell basics".
  • minutes — integer
  • capacity — integer — How many people it takes.
  • class_id — string — For edit and cancel: the class_id from action list.
  • price_usd — number — What one place in the class costs, as the owner set it. 0 or left out for free. Never repeat it to anyone but the owner.
  • starts_at — string — When it starts: "YYYY-MM-DDTHH:MM" in the place's own time, or an ISO time with its offset.
  • confirmation — boolean — Set to true only after the owner said yes to this class change.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• publish_place

  Use this when an owner wants their place live on Phorme: its page on phor.me, the app's map and the Phorme connector. Confirm with the owner first, and set confirmation to true only after they said yes. Going live needs an email for booking confirmations and requests: request_email, else the place's own, else the account's. Listing is free; when someone asks to book a place that is not on the gym plan, the ask is held 7 days and the owner is told. It takes no payment and starts no plan. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • confirmation (required) — boolean — Set to true only after the owner said yes to putting this place live.
  • request_email — string — Where booking confirmations and requests are emailed. Never shown in public.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• unpublish_place destructive

  Use this when an owner wants their place off Phorme for now. Confirm with the owner first, and set confirmation to true only after they said yes. Its page, the app's map and the Phorme connector stop listing it; its details and classes are kept, so it can be put live again. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • confirmation (required) — boolean — Set to true only after the owner said yes to taking this place down.

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• start_gym_brain

  Use this when an owner wants a coaching brain for their place, so members train with the gym's own coach in the Phorme app. Confirm with the owner first, and set confirmation to true only after they said yes. In one step it makes a brain from the place's name, line and classes, gives it a starting program from the Phorme library, publishes it and puts the place's members under it, the same as the console's one-click start. The owner can change it in the builder after. Free on the free listing too. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • confirmation (required) — boolean — Set to true only after the owner said yes to starting a coaching brain for this place.
  • days_per_week — integer — Training days a week the starting program is built for. Default 3.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• set_member_cover destructive

  Use this when an owner on the gym plan wants to pay for their members' Phorme membership at one place, so members train free, or wants to stop. Confirm with the owner first, and set confirmation to true only after they said yes. It turns the switch on or off and can lower the cap of members covered (up to 50). Members join from the app and the place approves them. A place not on the gym plan cannot turn it on; the result then gives plan_url, the plan on phor.me. It takes no payment here. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • on (required) — boolean — true to cover members, false to stop.
  • confirmation (required) — boolean — Set to true only after the owner said yes to this change to member cover.
  • cap — integer — Most members covered at this place. Default 50.

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• list_held_requests read-only

  Use this when an owner asks who wants to book or visit their place, for example "who asked to book this week?". At a place not on the gym plan, class bookings and 1:1 requests are held for 7 days. It returns each one waiting: its hold_id, the place, the class and its local time (or that it is a 1:1 request), the member's first name, their note and best times, when it expires, and whether it can be accepted now. It reads only and changes nothing. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id — string — Only this place. Leave out for all of the owner's places.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• answer_held_request destructive

  Use this when an owner wants to accept or decline one ask held for the plan at their place, by its hold_id. Read the ask back to the owner first, and set confirmation to true only after they said yes. Accept books the member in (a paid class is held while they pay on Phorme's own page; a full class puts them on the waitlist), or sends a 1:1 request on to the place's email. Decline ends it, with the owner's short note when they gave one. Either way the member hears. Accepting needs the gym plan at that place; the result then gives plan_url instead. It takes no payment. It needs a connected Phorme account that owns the place.

  Parameters:

  • hold_id (required) — string — The hold_id from list_held_requests.
  • answer (required) — string
  • confirmation (required) — boolean — Set to true only after the owner said yes to this answer.
  • note — string — For decline: a short note to the member, in the owner's words.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• claim_place

  Use this when an owner says a gym Phorme already lists is theirs and nobody runs it on Phorme yet, for example "that gym is mine". Confirm the place with the owner first, and set confirmation to true only after they said yes. It never hands the place over by itself: Phorme sends a six digit code to the email or phone the place has on file, not to the person asking. Whoever reads that inbox or phone gives them the code, and entering it makes them the owner. A place with neither on file waits for Phorme's team. It takes no payment. It needs a connected Phorme account.

  Parameters:

  • place_id (required) — string — The place_id of the listed place, from find_gym_class.
  • confirmation (required) — boolean — Set to true only after the owner said yes to claiming this place.
  • via — string — Where the code goes, when the place has both on file. Default email.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• verify_place_claim

  Use this when an owner has the six digit code Phorme sent to their place's own email or phone after they claimed it. Read the code back to the owner first, and set confirmation to true only after they said yes. A right code makes the connected account the place's owner; a wrong one changes nothing, and after five wrong tries or 24 hours the place must be claimed again. It takes no payment. It needs a connected Phorme account.

  Parameters:

  • claim_id (required) — string — The claim_id from claim_place.
  • code (required) — string — The six digit code, as the owner gave it.
  • confirmation (required) — boolean — Set to true only after the owner said yes to entering this code.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• cover_member destructive

  Use this when an owner on the gym plan wants to see who is covered or asked to be at one place, or to invite, approve or remove one member, for example "invite my member Sam to train free". action list reads who is listed and changes nothing. For invite (by the member's phone), approve (a member who asked) and remove, read it back to the owner first, and set confirmation to true only after they said yes. An invite sends the phone a text to join; the member hears once when they are covered or removed. Cover counts only while the gym plan covers the place, up to its cap; past it, new members pay as normal. It takes no payment here. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • action (required) — string
  • phone — string — For invite: the member's phone with its country code, for example +15125550100.
  • member_id — string — For approve and remove: the member_id from action list.
  • confirmation — boolean — Set to true only after the owner said yes to this change to who is covered.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• update_gym_brain

  Use this when an owner wants to change how their place's coaching brain sounds or looks: its name, its one line, its voice (how the coach talks to members), its method, its colour or its cover photo. Read the change back to the owner first, and set confirmation to true only after they said yes. Only the things given change; an empty value clears one. It saves to the brain; members get it once the brain is published again. The place needs a coaching brain first. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • confirmation (required) — boolean — Set to true only after the owner said yes to these changes to the coaching brain.
  • name — string — The coach's name members see.
  • color — string — The brand colour, as #rrggbb.
  • voice — string — How the coach talks to members, in the owner's words.
  • method — string — How the gym trains: the principles the coach plans by.
  • tagline — string — One line under the name.
  • cover_image_url — string — An https link to the cover photo.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• publish_gym_brain

  Use this when an owner wants the changes to their place's coaching brain to reach members, for example after its voice, look or programs changed. Confirm with the owner first, and set confirmation to true only after they said yes. It runs the same publish checks as the console and publishes the brain when they pass; when one fails it says what is left and members see no change. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • confirmation (required) — boolean — Set to true only after the owner said yes to publishing the coaching brain.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• set_booking_notices

  Use this when an owner wants booking and ask notices for a place sent somewhere else, for example "text my bookings to my phone". send_to is an email, or a phone that gets them as texts; one at a time, as in the console. An empty send_to sends them to the account's own phone or email. Read it back to the owner first, and set confirmation to true only after they said yes. The phone is never shown on the place's page. It needs a connected Phorme account that owns the place.

  Parameters:

  • place_id (required) — string — The place_id of one of the owner's places, from get_gym_report or create_or_claim_place.
  • send_to (required) — string — An email, or a phone with its country code for texts, for example +15125550100. "" for the account's own.
  • confirmation (required) — boolean — Set to true only after the owner said yes to where booking notices go.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_gym_billing_link read-only

  Use this when an owner on the gym plan wants to change the card, see invoices or change how many places the plan covers. It returns a link to Stripe's own billing page for the owner to open. It is a link only: nothing is paid or changed in the chat, and it changes nothing by itself. It needs a connected Phorme account.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_payouts read-only

  Use this when an owner asks what Phorme paid them, or what goes out next, for example "what did Phorme pay my gym?". It returns what the account earned, what was paid out, what is going out, what is owed now, whether a bank is set up, and each recent payout. It reads only and changes nothing. It needs a connected Phorme account.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_payout_setup_link

  Use this when an owner wants their share paid to their bank and has not set it up, for example when no bank is set up yet. Confirm with the owner first, and set confirmation to true only after they said yes. It returns a link to Stripe's own form, where the owner gives their bank to Stripe. It is a link only: the bank is never given in the chat, and it takes no payment. It needs a connected Phorme account.

  Parameters:

  • confirmation (required) — boolean — Set to true only after the owner said yes to setting up payouts.
  • country — string — The two letter country of the bank, for example US. Default US.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• set_owner_email

  Use this when an owner who signed in by phone wants notices about their gym plan sent to an email. Read the email back to the owner first, and set confirmation to true only after they said yes. An empty email clears it, and notices go to the account's own email or phone. It is never shown to members. It needs a connected Phorme account.

  Parameters:

  • email (required) — string — The owner's email, or "" to clear it.
  • confirmation (required) — boolean — Set to true only after the owner said yes to this email.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• search_phorme_programs read-only

  Use this when the user asks for an existing coach-built training program for their sport or goal, for example a structured volleyball program. It returns up to five matching Phorme programs, each with a sample session from its first week that the user can try now and where to find it in the Phorme app. Every result is a program a member can train in the Phorme app today. It changes nothing, shows no prices and starts no purchase. Results are ordered by fit and never by commission.

  Parameters:

  • goal — string — Training goal, for example "build strength".
  • sport — string
  • creator — string — Coach or creator name, only if the user named one.
  • equipment — array — Equipment the user has.
  • experience — string — Training level, for example "beginner".
  • schedule_days — integer — Training days per week.
  • duration_weeks — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_phorme_program read-only

  Use this when the user picked one Phorme program and wants its details. It returns the program, every session of its first week, where to find it in the Phorme app, and a link to a page that describes it. It reads only, shows no prices and starts no purchase.

  Parameters:

  • program_id (required) — string — The program id returned by search_phorme_programs.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.