Joondanna Family Dental agent and API documentation
Public, read-only interfaces for finding clinic services, contact details and published pages. No login or API key is required.
Agent guidance · OpenAPI description · MCP server card
Connection guide
# Joondanna Family Dental agent and API documentation A family-owned dental clinic in Joondanna, Perth, Western Australia, providing general, cosmetic, restorative, implant, orthodontic and emergency dental services. ## When to use this site Use these public resources to find dental services in Joondanna, read treatment and payment information, retrieve contact details and opening hours, and direct a person to the existing booking page. Every interface is read-only. There is no patient-record, diagnosis, live-availability, price-quotation or appointment-submission API. ## Read website content as Markdown Request the same page URL with `Accept: text/markdown`. Browser requests for `text/html` continue to receive HTML. Responses vary on Accept, respect quality values, and return 406 when neither format is acceptable. GET and HEAD are supported. Unknown paths retain HTTP 404 and link to recovery resources. ```sh curl -H 'Accept: text/markdown' https://joondannacitydental.vercel.app/ curl -H 'Accept: text/html' https://joondannacitydental.vercel.app/ curl -H 'Accept: text/markdown' https://joondannacitydental.vercel.app/some-missing-page/ ``` ## Public read-only REST API - [Clinic information](https://joondannacitydental.vercel.app/api/v1/clinic): GET contact details, opening hours and the booking link. - [Site search](https://joondannacitydental.vercel.app/api/v1/search?q=mouthguards): GET public pages matching q (1–200 characters); limit is 1–20, default 10. - [Page content](https://joondannacitydental.vercel.app/api/v1/page?path=/general-dentistry/mouthguards/): GET an allowlisted public page as JSON with its Markdown content. Supply a local path, not an external URL. - [OpenAPI 3.1 description](https://joondannacitydental.vercel.app/openapi.json): the supported language-neutral API contract. ## Authentication and errors No API key, OAuth, login or patient information is required. Do not send health details or credentials to these endpoints. Methods other than GET/HEAD return 405 with Allow. Invalid inputs return 400; missing public pages return 404. REST errors use application/problem+json with type, title, status and detail. Public responses may be cached; there is no contractual request quota or uptime guarantee. This clinic does not offer an SDK, OAuth service, GraphQL endpoint or booking API. ## Model Context Protocol (MCP) Connect a Streamable HTTP MCP client to [https://joondannacitydental.vercel.app/mcp/](https://joondannacitydental.vercel.app/mcp/). The endpoint supports the official SDK's current protocol negotiation and legacy initialize handshake. A new request-scoped server is used for each request; no persistent session is required. Tools are get_clinic_information, search_site and read_page. All have read-only, idempotent annotations. Origin headers are validated; non-browser clients can omit Origin. The same protocol is available at [/.well-known/mcp/](https://joondannacitydental.vercel.app/.well-known/mcp/). GET with Accept: text/event-stream may return 405 because this stateless server does not provide a long-lived SSE subscription. Legacy POST responses may use SSE; clients must support both application/json and text/event-stream. ## Discovery - [Agent guidance](https://joondannacitydental.vercel.app/llms.txt) - [MCP registry-format manifest](https://joondannacitydental.vercel.app/server.json): a discoverable manifest, not a claim of registry registration. - [MCP server card](https://joondannacitydental.vercel.app/mcp/server-card/): an experimental discovery convention, not a substitute for a protocol handshake. - [API catalog](https://joondannacitydental.vercel.app/.well-known/api-catalog): RFC 9727 discovery. - [Sitemap](https://joondannacitydental.vercel.app/sitemap.xml) ## Booking and clinical limits For booking, follow [Book an appointment](https://joondannacitydental.vercel.app/book-an-appointment/); the existing external booking provider handles the transaction. Do not claim a booking has been made from these read-only tools. Call +61861096666 or use the published contact page for clinic enquiries. Information is general; suitability, fees, treatment decisions and urgent concerns must be discussed with the dental team.