MCP Server

MediMo

uk.co.medimo/mcp
Healthcare Public & reachable MCP 2026-07-28

What this MCP does

Searches UK private physiotherapy, osteopathy, and chiropractic clinics, shows live availability, and generates booking checkout links.

get_availability
Check clinic availability
Return current bookable availability for one clinic, read from the clinic's own diary. Gives the soonest appointment and how many are free today, tomorrow and in the next 48 hours, per treatment type. Pass a date or a date range to get that day's appointment times, each carrying the ids start_booking needs to open the checkout on that exact slot. Every response says how old its reading is, and every date carries its own age, because the next few days are re-read every ten minutes and later dates far less often. Says plainly when a date has not been read rather than reporting it as having nothing. Covers self-pay first appointments booked online; the checkout page shows every live slot.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['clinic_id'], 'properties': {'date': {'type': 'string', 'description': "Optional single date, ISO format (2026-09-22). Returns that day's appointment times."}, 'date_to': {'type': 'string', 'description': 'Optional end of a date range, ISO format. At most 14 days from date_from.'}, 'service': {'type': 'string', 'description': 'Optional. Narrow to one treatment, e.g. "physiotherapy", "osteopathy", "chiropractic".'}, 'clinic_id': {'type': 'string', 'description': 'The clinic id from search_clinics. Accepts the slug or the ULID.'}, 'date_from': {'type': 'string', 'description': 'Optional start of a date range, ISO format. Use with date_to.'}, 'time_of_day': {'enum': ['morning', 'afternoon', 'evening'], 'type': 'string', 'description': 'Optional. Narrow the times to morning (before noon), afternoon (noon to 5pm) or evening (5pm on).'}}}
Output schema
{'type': 'object', 'required': ['about', 'booking_rule', 'price_promise', 'generated_at', 'data'], 'properties': {'data': {'type': 'object', 'required': ['clinic_id', 'name', 'availability'], 'properties': {'days': {'type': 'array', 'items': {'type': 'object', 'required': ['date'], 'properties': {'date': {'type': 'string'}, 'name': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'as_of': {'type': ['string', 'null']}, 'slots': {'type': 'array', 'items': {'type': 'object', 'required': ['at', 'practitioner_id'], 'properties': {'at': {'type': 'string', 'description': 'ISO 8601 with offset. Pass to start_booking as starts_at.'}, 'service_id': {'type': ['string', 'null']}, 'service_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Every service bookable at this time.'}, 'practitioner_id': {'type': 'string'}}}}, 'state': {'enum': ['available', 'none', 'unknown'], 'type': 'string'}, 'listed': {'type': 'integer'}, 'reading': {'type': ['string', 'null']}, 'coverage': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'truncated': {'type': 'boolean'}, 'slot_count': {'type': ['integer', 'null'], 'description': 'Whole day, regardless of any time_of_day filter.'}, 'specialism': {'type': 'string'}, 'age_minutes': {'type': ['integer', 'null']}, 'slot_count_scope': {'type': 'string'}, 'times_are_a_sample': {'type': 'boolean'}}}, 'description': 'Present when a date or date range was asked for: one entry per date per treatment.'}, 'name': {'type': 'string'}, 'clinic_id': {'type': 'string'}, 'requested': {'type': 'object', 'properties': {'date_to': {'type': ['string', 'null']}, 'date_from': {'type': ['string', 'null']}, 'time_of_day': {'enum': ['morning', 'afternoon', 'evening'], 'type': ['string', 'null']}}}, 'availability': {'type': 'object', 'required': ['state'], 'properties': {'note': {'type': ['string', 'null']}, 'as_of': {'type': ['string', 'null']}, 'scope': {'type': 'string'}, 'state': {'enum': ['available', 'none', 'stale', 'unknown'], 'type': 'string'}, 'reason': {'type': ['string', 'null']}, 'coverage': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'age_minutes': {'type': ['integer', 'null']}, 'horizon_days': {'type': 'integer'}, 'by_specialism': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'state': {'enum': ['available', 'none'], 'type': 'string'}, 'specialism': {'type': 'string'}, 'slot_counts': {'type': 'object', 'properties': {'today': {'type': 'integer'}, 'tomorrow': {'type': 'integer'}, 'next_48_hours': {'type': 'integer'}}}, 'next_available_at': {'type': ['string', 'null']}}}}, 'coverage_note': {'type': ['string', 'null']}}}}}, 'about': {'type': 'string', 'description': 'What MediMo is.'}, 'data_as_of': {'type': ['string', 'null'], 'description': 'Age of the underlying reading, when different from generated_at.'}, 'booking_rule': {'type': 'string', 'description': 'Where bookings and payment complete.'}, 'generated_at': {'type': 'string', 'description': 'When this response was produced. ISO 8601, Europe/London.'}, 'price_promise': {'type': 'string'}}}
get_clinic
Get clinic details
Return the full public profile of one MediMo clinic: description, address, the treatments it offers with prices and durations, its practitioners with profession, regulator registration, gender and languages spoken besides English, its parking and step-free access, the insurers it accepts, and current availability. Pass insurer for that insurer's appointments, prices and approved practitioners. Prices are the clinic's own — booking through MediMo costs the same as booking direct. Contains no phone numbers, emails or review text. Use it after search_clinics when someone wants detail on a specific clinic; call start_booking when they have chosen.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['clinic_id'], 'properties': {'insurer': {'type': 'string', 'description': 'Optional. The health insurer paying, e.g. "Bupa". Services, prices and practitioners become that insurer\'s. Leave out for self-pay.'}, 'clinic_id': {'type': 'string', 'description': 'The clinic id from search_clinics. Accepts the slug or the ULID.'}}}
Output schema
{'type': 'object', 'required': ['about', 'booking_rule', 'price_promise', 'generated_at', 'data'], 'properties': {'data': {'type': 'object', 'required': ['clinic_id', 'name', 'services', 'practitioners', 'availability'], 'properties': {'area': {'type': 'string'}, 'name': {'type': 'string'}, 'address': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'line_1': {'type': 'string'}, 'line_2': {'type': 'string'}, 'country': {'type': 'string'}, 'postcode': {'type': 'string'}}}, 'insurer': {'type': 'string', 'description': 'The insurer these services and prices are for. Absent for self-pay.'}, 'services': {'type': 'array', 'items': {'type': 'object', 'required': ['service_id', 'name'], 'properties': {'name': {'type': 'string'}, 'price_gbp': {'type': 'number', 'description': "What the patient pays at checkout. With an insurer, that insurer's price."}, 'service_id': {'type': 'string'}, 'specialism': {'type': 'string', 'description': 'Treatment slug: physiotherapy, chiropractic, osteopathy.'}, 'description': {'type': 'string'}, 'treatment_note': {'type': 'string'}, 'appointment_type': {'enum': ['first_visit', 'follow_up'], 'type': 'string'}, 'duration_minutes': {'type': 'integer'}, 'no_upfront_payment': {'type': 'boolean', 'description': 'Present and true when the insurer is billed and nothing is taken at checkout.'}, 'treatment_included': {'type': 'boolean', 'description': 'Present and false only when the clinic states this appointment is assessment only.'}}}}, 'clinic_id': {'type': 'string'}, 'facilities': {'type': 'object', 'properties': {'access': {'type': 'array', 'items': {'type': 'string'}}, 'parking': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'Parking and access as the clinic recorded them. An empty list means the clinic said none apply; the whole field is absent when the clinic has not recorded them.'}, 'description': {'type': 'string'}, 'profile_url': {'type': 'string'}, 'specialisms': {'type': 'string'}, 'availability': {'type': 'object', 'required': ['state'], 'properties': {'note': {'type': ['string', 'null']}, 'as_of': {'type': ['string', 'null']}, 'scope': {'type': 'string'}, 'state': {'enum': ['available', 'none', 'stale', 'unknown'], 'type': 'string'}, 'reason': {'type': ['string', 'null']}, 'coverage': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'age_minutes': {'type': ['integer', 'null']}, 'horizon_days': {'type': 'integer'}, 'by_specialism': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'state': {'enum': ['available', 'none'], 'type': 'string'}, 'specialism': {'type': 'string'}, 'slot_counts': {'type': 'object', 'properties': {'today': {'type': 'integer'}, 'tomorrow': {'type': 'integer'}, 'next_48_hours': {'type': 'integer'}}}, 'next_available_at': {'type': ['string', 'null']}}}}, 'coverage_note': {'type': ['string', 'null']}}}, 'google_rating': {'type': ['object', 'null'], 'properties': {'count': {'type': 'integer', 'description': 'Number of Google reviews.'}, 'scale': {'type': 'integer'}, 'value': {'type': 'number', 'description': 'Google rating out of 5.'}, 'maps_url': {'type': ['string', 'null']}, 'attribution': {'type': 'string'}}}, 'practitioners': {'type': 'array', 'items': {'type': 'object', 'required': ['practitioner_id', 'name'], 'properties': {'bio': {'type': 'string'}, 'name': {'type': 'string'}, 'gender': {'enum': ['female', 'male'], 'type': 'string', 'description': 'As recorded by the clinic.'}, 'professions': {'type': 'array', 'items': {'type': 'string'}}, 'registrations': {'type': 'array', 'items': {'type': 'object', 'properties': {'regulator': {'type': 'string'}, 'registration_number': {'type': 'string'}}}}, 'practitioner_id': {'type': 'string'}, 'additional_languages': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Languages spoken besides English, as recorded by the clinic.'}}}}, 'price_promise': {'type': 'string'}, 'insurers_accepted': {'type': 'array', 'items': {'type': 'string'}, 'description': "Insurers the clinic accepts. Pass one as insurer to search_clinics, get_clinic or start_booking for that insurer's appointments, prices and checkout."}, 'cancellation_policy': {'type': 'object', 'properties': {'summary': {'type': 'string'}, 'applies_to': {'type': 'string'}}}}}, 'about': {'type': 'string', 'description': 'What MediMo is.'}, 'data_as_of': {'type': ['string', 'null'], 'description': 'Age of the underlying reading, when different from generated_at.'}, 'booking_rule': {'type': 'string', 'description': 'Where bookings and payment complete.'}, 'generated_at': {'type': 'string', 'description': 'When this response was produced. ISO 8601, Europe/London.'}, 'price_promise': {'type': 'string'}}}
get_nhs_wait
NHS waiting times
Return the latest published NHS waiting-time figures for the Integrated Care Board covering a UK postcode, or for a named board: the median wait, how many people are waiting, the wait bands, and how that compares with the national average. Figures are NHS England's own published statistics, with the reporting period stated. Useful context when someone is deciding whether to wait or to go private; pair it with search_clinics for what is bookable privately nearby.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {'icb': {'type': 'string', 'description': 'Alternative to postcode: an Integrated Care Board by name, slug or code, e.g. "Greater Manchester".'}, 'postcode': {'type': 'string', 'description': 'A UK postcode. The Integrated Care Board covering it is looked up locally, with no external call.'}, 'specialty': {'type': 'string', 'description': 'Optional. Defaults to MSK physiotherapy, the waiting list private physiotherapy is an alternative to.'}}}
Output schema
{'type': 'object', 'required': ['about', 'booking_rule', 'price_promise', 'generated_at', 'data'], 'properties': {'data': {'type': 'object', 'required': ['icb', 'specialty'], 'properties': {'icb': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}}}, 'bands': {'type': 'array', 'items': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'count': {'type': 'integer'}, 'label': {'type': 'string'}}}}, 'page_url': {'type': ['string', 'null'], 'description': "MediMo's page for these figures. Link here rather than composing a URL."}, 'specialty': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}}}, 'attribution': {'type': 'string'}, 'data_source': {'type': 'string'}, 'median_wait': {'type': 'string'}, 'source_note': {'type': 'string'}, 'total_waiting': {'type': ['integer', 'null']}, 'national_average': {'type': 'object', 'properties': {'median_wait': {'type': 'string'}, 'total_waiting': {'type': ['integer', 'null']}, 'median_wait_weeks': {'type': ['number', 'null']}, 'waiting_longer_than_12_weeks_percent': {'type': ['number', 'null']}}}, 'reporting_period': {'type': 'string'}, 'median_wait_weeks': {'type': ['number', 'null']}, 'private_alternative': {'type': 'string'}, 'reporting_period_label': {'type': 'string'}, 'waiting_longer_than_12_weeks_percent': {'type': ['number', 'null']}}}, 'about': {'type': 'string', 'description': 'What MediMo is.'}, 'data_as_of': {'type': ['string', 'null'], 'description': 'Age of the underlying reading, when different from generated_at.'}, 'booking_rule': {'type': 'string', 'description': 'Where bookings and payment complete.'}, 'generated_at': {'type': 'string', 'description': 'When this response was produced. ISO 8601, Europe/London.'}, 'price_promise': {'type': 'string'}}}
get_practitioner
Get practitioner details
Return one practitioner's public profile: name, profession, the regulator they are registered with and their registration number where MediMo holds it, their gender and languages spoken besides English as their clinic recorded them, their bio, and the clinics they can be booked at. Only registrations MediMo has verified are included. Contains no contact details. Use it when someone asks about a named clinician; call get_availability on their clinic for appointment times.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['practitioner_id'], 'properties': {'practitioner_id': {'type': 'string', 'description': 'The practitioner id (ULID) from get_clinic.'}}}
Output schema
{'type': 'object', 'required': ['about', 'booking_rule', 'price_promise', 'generated_at', 'data'], 'properties': {'data': {'type': 'object', 'required': ['practitioner_id', 'name', 'clinics'], 'properties': {'bio': {'type': 'string'}, 'name': {'type': 'string'}, 'gender': {'enum': ['female', 'male'], 'type': 'string', 'description': 'As recorded by the clinic.'}, 'clinics': {'type': 'array', 'items': {'type': 'object', 'properties': {'area': {'type': ['string', 'null']}, 'name': {'type': 'string'}, 'clinic_id': {'type': 'string'}}}}, 'professions': {'type': 'array', 'items': {'type': 'string'}}, 'registrations': {'type': 'array', 'items': {'type': 'object', 'properties': {'regulator': {'type': 'string'}, 'registration_number': {'type': 'string'}}}}, 'practitioner_id': {'type': 'string'}, 'additional_languages': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Languages spoken besides English, as recorded by the clinic.'}}}, 'about': {'type': 'string', 'description': 'What MediMo is.'}, 'data_as_of': {'type': ['string', 'null'], 'description': 'Age of the underlying reading, when different from generated_at.'}, 'booking_rule': {'type': 'string', 'description': 'Where bookings and payment complete.'}, 'generated_at': {'type': 'string', 'description': 'When this response was produced. ISO 8601, Europe/London.'}, 'price_promise': {'type': 'string'}}}
search_clinics
Search clinics
Find private physiotherapy, osteopathy or chiropractic clinics near a UK postcode or town that can be booked online through MediMo. Each result carries the clinic's next available first appointment, read from its own diary and refreshed every ten minutes, plus distance, Google rating and the treatments it offers. Returns no appointment times beyond the next available slot and does not book. Pass a date, a date range and/or a time of day to get only the clinics free then, with that day's appointment times — "a chiropractic appointment next Tuesday afternoon within 5 miles of WA14". Narrow to clinics with a practitioner of a given gender or language, or with free parking on site or step-free access, using the same rules as the website's filters. Pass insurer when someone is paying through their health insurance: only clinics accepting it are returned, with that insurer's appointments, prices and checkout. Each result lists its parking, access and accepted insurers. Start here; use get_clinic for detail on one result and start_booking when the person has chosen.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['location'], 'properties': {'date': {'type': 'string', 'description': "Optional single date, ISO format (2026-09-22). Returns only clinics with an appointment that day, and that day's times."}, 'sort': {'enum': ['nearest', 'soonest', 'rating'], 'type': 'string', 'description': 'Order of results. "nearest" (default) lists clinics with an appointment first, then by distance; "soonest" by next available appointment; "rating" by Google rating.'}, 'limit': {'type': 'integer', 'description': 'Maximum clinics to return, 1–20. Default 10.'}, 'date_to': {'type': 'string', 'description': 'Optional end of a date range, ISO format. At most 7 days from date_from.'}, 'insurer': {'type': 'string', 'description': 'Optional. The health insurer paying, e.g. "Bupa", "AXA", "Vitality". Only clinics accepting it are returned, and prices and checkout links become that insurer\'s. Leave out for self-pay.'}, 'service': {'type': 'string', 'description': 'Optional treatment: "physiotherapy", "osteopathy", "chiropractic" (short forms like "physio" are fine). Leave empty to search all treatments.'}, 'language': {'type': 'string', 'description': 'Optional. Only clinics with a practitioner who speaks this language and delivers the treatment searched for, e.g. "Polish". English is assumed everywhere and is not a filter.'}, 'location': {'type': 'string', 'description': 'A UK postcode ("M33 7XS"), postcode district ("SK8") or town ("Altrincham"). A full postcode gives the most accurate distances.'}, 'date_from': {'type': 'string', 'description': 'Optional start of a date range, ISO format. Use with date_to.'}, 'facilities': {'type': 'array', 'items': {'enum': ['free_parking', 'accessible'], 'type': 'string'}, 'description': 'Optional. "free_parking": free parking on site. "accessible": step-free access, an accessible toilet, and a treatment room reachable without stairs. Every one listed must apply.'}, 'time_of_day': {'enum': ['morning', 'afternoon', 'evening'], 'type': 'string', 'description': 'Optional. Only clinics with a slot in the morning (before noon), afternoon (noon to 5pm) or evening (5pm on).'}, 'radius_miles': {'type': 'integer', 'description': 'Search radius, 1–20 miles. Default 10. Widens once to 20 if fewer than 3 clinics are found.'}, 'practitioner_gender': {'enum': ['female', 'male'], 'type': 'string', 'description': 'Optional. Only clinics with a practitioner of this gender who delivers the treatment searched for.'}}}
Output schema
{'type': 'object', 'required': ['about', 'booking_rule', 'price_promise', 'generated_at', 'data'], 'properties': {'data': {'type': 'object', 'required': ['location', 'total_found', 'clinics'], 'properties': {'hint': {'type': ['string', 'null']}, 'sort': {'type': 'string'}, 'clinics': {'type': 'array', 'items': {'type': 'object', 'required': ['clinic_id', 'name'], 'properties': {'area': {'type': ['string', 'null']}, 'name': {'type': 'string'}, 'postcode': {'type': ['string', 'null']}, 'clinic_id': {'type': 'string'}, 'dates_read': {'type': 'boolean'}, 'facilities': {'type': 'object', 'properties': {'access': {'type': 'array', 'items': {'type': 'string'}}, 'parking': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'Parking and access as the clinic recorded them. An empty list means the clinic said none apply; the whole field is absent when the clinic has not recorded them.'}, 'profile_url': {'type': 'string'}, 'specialisms': {'type': ['string', 'null']}, 'availability': {'type': 'object', 'required': ['state'], 'properties': {'note': {'type': ['string', 'null']}, 'as_of': {'type': ['string', 'null']}, 'state': {'enum': ['available', 'none', 'stale', 'unknown'], 'type': 'string', 'description': 'unknown and stale mean the reading could not be made or is too old, never that there is nothing.'}, 'reason': {'type': ['string', 'null']}, 'coverage': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'age_minutes': {'type': ['integer', 'null']}, 'next_available_at': {'type': ['string', 'null']}}}, 'google_rating': {'type': ['object', 'null'], 'properties': {'count': {'type': 'integer', 'description': 'Number of Google reviews.'}, 'scale': {'type': 'integer'}, 'value': {'type': 'number', 'description': 'Google rating out of 5.'}, 'maps_url': {'type': ['string', 'null']}, 'attribution': {'type': 'string'}}}, 'distance_miles': {'type': ['number', 'null']}, 'next_available': {'type': ['object', 'null'], 'properties': {'at': {'type': 'string'}, 'price_gbp': {'type': 'number'}, 'service_id': {'type': 'string'}, 'checkout_url': {'type': 'string'}, 'service_name': {'type': 'string'}, 'practitioner_id': {'type': 'string'}, 'no_upfront_payment': {'type': 'boolean'}}}, 'insurers_accepted': {'type': 'array', 'items': {'type': 'string'}, 'description': "Insurers the clinic accepts. Pass one as insurer to search_clinics, get_clinic or start_booking for that insurer's appointments, prices and checkout."}, 'on_requested_dates': {'type': 'array', 'items': {'type': 'object', 'required': ['date'], 'properties': {'date': {'type': 'string'}, 'name': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'as_of': {'type': ['string', 'null']}, 'slots': {'type': 'array', 'items': {'type': 'object', 'required': ['at', 'practitioner_id'], 'properties': {'at': {'type': 'string', 'description': 'ISO 8601 with offset. Pass to start_booking as starts_at.'}, 'service_id': {'type': ['string', 'null']}, 'service_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Every service bookable at this time.'}, 'practitioner_id': {'type': 'string'}}}}, 'state': {'enum': ['available', 'none', 'unknown'], 'type': 'string'}, 'listed': {'type': 'integer'}, 'reading': {'type': ['string', 'null']}, 'coverage': {'enum': ['complete', 'partial', 'unknown'], 'type': 'string'}, 'truncated': {'type': 'boolean'}, 'slot_count': {'type': ['integer', 'null'], 'description': 'Whole day, regardless of any time_of_day filter.'}, 'specialism': {'type': 'string'}, 'age_minutes': {'type': ['integer', 'null']}, 'slot_count_scope': {'type': 'string'}, 'times_are_a_sample': {'type': 'boolean'}}}}, 'treatments_offered': {'type': 'array', 'items': {'type': 'string'}}}}}, 'location': {'type': 'object', 'properties': {'note': {'type': ['string', 'null']}, 'input': {'type': 'string'}, 'within': {'type': ['string', 'null']}, 'precision': {'type': 'string'}, 'resolved_to': {'type': 'string'}}}, 'returned': {'type': 'integer'}, 'total_found': {'type': 'integer'}, 'radius_widened': {'type': 'boolean'}, 'filters_applied': {'type': ['object', 'null'], 'properties': {'insurer': {'type': 'string'}, 'language': {'type': 'string'}, 'facilities': {'type': 'array', 'items': {'enum': ['free_parking', 'accessible'], 'type': 'string'}}, 'practitioner_gender': {'enum': ['female', 'male'], 'type': 'string'}}, 'description': 'Filters that narrowed these results. Null when none were applied.'}, 'requested_dates': {'type': ['object', 'null'], 'properties': {'date_to': {'type': ['string', 'null']}, 'date_from': {'type': ['string', 'null']}, 'time_of_day': {'enum': ['morning', 'afternoon', 'evening'], 'type': ['string', 'null']}}}, 'radius_miles_used': {'type': 'number'}, 'dates_not_read_for': {'type': ['integer', 'null']}, 'treatments_searched': {'type': 'array', 'items': {'type': 'string'}}, 'nearest_covered_areas': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'distance_miles': {'type': 'number'}}}}}}, 'about': {'type': 'string', 'description': 'What MediMo is.'}, 'data_as_of': {'type': ['string', 'null'], 'description': 'Age of the underlying reading, when different from generated_at.'}, 'booking_rule': {'type': 'string', 'description': 'Where bookings and payment complete.'}, 'generated_at': {'type': 'string', 'description': 'When this response was produced. ISO 8601, Europe/London.'}, 'price_promise': {'type': 'string'}}}
start_booking
Start a booking
Build the MediMo checkout link for a chosen clinic and treatment, so the person can complete their booking and payment on medimo.co.uk. Returns the URL and a summary of what they are booking and what it costs. Call it once they have chosen. It holds no appointment, creates no booking, takes no payment and needs no personal details — all of that happens on the MediMo page. Pass insurer for the insured checkout, which asks for their policy details. Safe to call more than once.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['clinic_id'], 'properties': {'insurer': {'type': 'string', 'description': 'Optional. The health insurer paying, e.g. "Bupa". Opens the insured checkout for that insurer. Use the same insurer passed to get_clinic.'}, 'clinic_id': {'type': 'string', 'description': 'The clinic id from search_clinics or get_clinic.'}, 'starts_at': {'type': 'string', 'description': 'Optional ISO 8601 time, from get_availability next_available_at. Requires service_id and practitioner_id.'}, 'service_id': {'type': 'string', 'description': 'Optional. The service id from get_clinic, to open the checkout on that treatment.'}, 'practitioner_id': {'type': 'string', 'description': 'Optional. The practitioner id from get_clinic, if they asked for someone specific.'}}}
Output schema
{'type': 'object', 'required': ['about', 'booking_rule', 'price_promise', 'generated_at', 'data'], 'properties': {'data': {'type': 'object', 'required': ['checkout_url', 'clinic', 'what_happens_next'], 'properties': {'clinic': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'clinic_id': {'type': 'string'}}}, 'insurer': {'type': 'string', 'description': 'The insurer the checkout is set up for. Absent for self-pay.'}, 'service': {'type': 'object', 'required': ['service_id', 'name'], 'properties': {'name': {'type': 'string'}, 'price_gbp': {'type': 'number', 'description': "What the patient pays at checkout. With an insurer, that insurer's price."}, 'service_id': {'type': 'string'}, 'specialism': {'type': 'string', 'description': 'Treatment slug: physiotherapy, chiropractic, osteopathy.'}, 'description': {'type': 'string'}, 'treatment_note': {'type': 'string'}, 'appointment_type': {'enum': ['first_visit', 'follow_up'], 'type': 'string'}, 'duration_minutes': {'type': 'integer'}, 'no_upfront_payment': {'type': 'boolean', 'description': 'Present and true when the insurer is billed and nothing is taken at checkout.'}, 'treatment_included': {'type': 'boolean', 'description': 'Present and false only when the clinic states this appointment is assessment only.'}}}, 'slot_note': {'type': 'string'}, 'starts_at': {'type': 'string'}, 'checkout_url': {'type': 'string', 'description': 'Give this to the person. Booking and payment complete on medimo.co.uk.'}, 'practitioner': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'practitioner_id': {'type': 'string'}}}, 'what_happens_next': {'type': 'string'}}}, 'about': {'type': 'string', 'description': 'What MediMo is.'}, 'data_as_of': {'type': ['string', 'null'], 'description': 'Age of the underlying reading, when different from generated_at.'}, 'booking_rule': {'type': 'string', 'description': 'Where bookings and payment complete.'}, 'generated_at': {'type': 'string', 'description': 'When this response was produced. ISO 8601, Europe/London.'}, 'price_promise': {'type': 'string'}}}
Changed
start_booking
Sept. 27, 2026, 2:50 a.m.
Changed
get_practitioner
Sept. 27, 2026, 2:50 a.m.
Changed
get_clinic
Sept. 27, 2026, 2:50 a.m.
Changed
search_clinics
Sept. 27, 2026, 2:50 a.m.
Added
get_nhs_wait
Sept. 17, 2026, 12:55 p.m.
Added
start_booking
Sept. 17, 2026, 12:55 p.m.
Added
get_practitioner
Sept. 17, 2026, 12:55 p.m.
Added
get_availability
Sept. 17, 2026, 12:55 p.m.
Added
get_clinic
Sept. 17, 2026, 12:55 p.m.
Added
search_clinics
Sept. 17, 2026, 12:55 p.m.