De Fysioplek API en MCP-server

Openbare API

Een REST-API om te lezen, zonder sleutel. Elk antwoord is JSON (UTF-8), tijden staan in ISO 8601 met de Nederlandse tijdzone, en lijsten gaan per pagina met een next_cursor. Fouten hebben altijd dezelfde vorm: {"error": {"code", "message"}}.

Limiet: 60 verzoeken per minuut per IP-adres. Daarboven krijg je 429 met Retry-After. Antwoorden mogen een minuut in een cache blijven.

Endpoints

• GET /api/v1/areas: De gebieden waarin je kunt zoeken (stadsdelen en plaatsen), met het aantal praktijken.
• GET /api/v1/categories: De klachtcategorieën met een vaste slug; de namen volgen Accept-Language (nl of en).
• GET /api/v1/slots: Vrije tijden, de vroegste eerst, elk met de link die precies die tijd op De Fysioplek opent. Filters: area, category, practice, from, to, daypart, limit (max 50) en cursor.
• GET /api/v1/practices: Alle praktijken op De Fysioplek, met hun openbare gegevens: vestigingen, specialisaties, verzekeraars, de eerstvolgende vrije tijd, hun pagina en de link om te boeken.
• GET /api/v1/practices/{slug}: Eén praktijk, met daarbij de therapeuten en behandelingen.
• GET /api/v1/meta: Wanneer de gegevens voor het laatst zijn ververst, hoeveel praktijken erin staan en hoe boeken werkt.

De volledige beschrijving staat in de OpenAPI-specificatie: https://defysioplek.nl/api/v1/openapi.json

Voorbeeld van een verzoek

curl https://defysioplek.nl/api/v1/practices?limit=1

Voorbeeld van een antwoord (ingekort, een verzonnen praktijk)

{
  "practices": [
    {
      "slug": "voorbeeld-fysio",
      "name": "Voorbeeld Fysio",
      "branches": [{"street": "Voorbeeldstraat 1", "postcode4": "1094", "city": "Amsterdam",
                    "district": "Oost", "lat": 52.36, "lng": 4.93}],
      "specialisms": ["Rug", "Knie / been"],
      "insurance": {"status": "all", "insurers": [], "except_insurers": [], "checked_at": ""},
      "next_free": {"start": "2026-11-09T18:30:00+01:00"},
      "page_url": "https://defysioplek.nl/praktijk/voorbeeld-fysio",
      "booking_url": "https://defysioplek.nl/zoeken?zoek=Voorbeeld+Fysio&utm_source=api&utm_medium=referral"
    }
  ],
  "next_cursor": "cDp2b29yYmVlbGQtZnlzaW8"
}

MCP-server

Voor AI-assistenten zoals ChatGPT en Claude is er een openbare MCP-server (Streamable HTTP, zonder inloggen). Gebruik dit adres:

https://defysioplek.nl/mcp

Tools, met een voorbeeldvraag

• list_search_options: De gebieden en klachtcategorieën om mee te zoeken (dezelfde JSON als /api/v1/areas en /api/v1/categories).
  “In welke delen van Amsterdam kan ik een fysiotherapeut zoeken?”
• find_slots: Vrije tijden op gebied, klacht, praktijk, datum of dagdeel, elk met een link naar die tijd op De Fysioplek (dezelfde JSON als /api/v1/slots).
  “Zoek een vrije fysio-afspraak in Amsterdam-Oost voor morgen.”
• practice_details: De openbare gegevens van één praktijk, op haar slug (dezelfde JSON als /api/v1/practices/{slug}).
  “Vertel me meer over deze praktijk en haar vestigingen.”
• find_practices: Alle praktijken op De Fysioplek, per pagina (dezelfde JSON als /api/v1/practices).
  “Welke fysiotherapiepraktijken staan er op De Fysioplek?”
• book_slot: Boekt één vrije tijd in twee stappen: eerst een samenvatting, en pas als de patiënt die in de chat bevestigt, de boeking. Dit hulpmiddel werkt zodra het in de lijst met tools van de server staat. Tot dan geeft de assistent de patiënt de link om op defysioplek.nl te boeken.
  “Boek de afspraak van 18:30 bij deze praktijk voor mij.”

Twee bronnen (resources) om één keer te lezen: dfp://meta (hoe vers de gegevens zijn en hoe boeken werkt) en dfp://categories (de klachtcategorieën).

Toevoegen als connector

• ChatGPT: voeg in de instellingen een eigen connector (app) toe met het adres hierboven, zonder authenticatie.
• Claude: ga naar Instellingen › Connectors › Eigen connector toevoegen en vul het adres hierboven in.

De namen van de menu's kunnen veranderen; zoek naar ‘connector’ of ‘MCP’.

Privacy

De API vraagt en geeft geen patiëntgegevens. Boeken gaat alleen via onze eigen site of, zodra die live is, de tool book_slot. We publiceren geen telefoonnummers, websites of e-mailadressen van praktijken.

Vragen

Mail naar info@defysioplek.nl.