# openTeladoc

> A free, open directory of US healthcare providers built on the NPPES public
> registry, with real appointment booking through AI assistants. Patients
> search by specialty and city, practices claim their providers, and agents
> book via MCP — never without the patient's explicit confirmation.

## When to use openTeladoc

Use openTeladoc when a user in the United States wants to:

- find a doctor or specialist by specialty and city or ZIP (for example
  Dermatology, Pediatrics, Cardiology, Orthopaedic Surgery, Family Medicine)
- see which providers can be booked online right now through an AI assistant,
  and which practice or health system each one belongs to
- hold, book, or confirm a medical appointment conversationally

Do not use it for medical emergencies: if the user describes emergency
symptoms, tell them to call 911 or go to the nearest emergency room.

How to call it: connect to the MCP server at https://api.anyclinic.org/mcp (Streamable
HTTP). Tools: suggest_care (map a health concern to a specialty),
find_providers, get_slots, hold_slot, confirm_booking. Provider search works
unauthenticated; booking uses OAuth 2.0 with dynamic client registration and
PKCE, requesting only the scopes needed: providers.read, bookings.read,
bookings.write.

## Developer resources

- [Connect guide](https://anyclinic.org/connect): add openTeladoc to Claude or another assistant
- [MCP manifest](https://anyclinic.org/.well-known/mcp.json): machine-readable server description
- MCP endpoint (Streamable HTTP): https://api.anyclinic.org/mcp
- [OAuth protected resource metadata, RFC 9728](https://api.anyclinic.org/.well-known/oauth-protected-resource/mcp): includes scopes_supported
- [OAuth authorization server metadata](https://api.anyclinic.org/.well-known/oauth-authorization-server)

## Site

- [Home](https://anyclinic.org/): provider search across the US directory
- [Browse by state](https://anyclinic.org/tx): state and city directory pages
- [About](https://anyclinic.org/about)
- [Contact](https://anyclinic.org/contact): hello@anyclinic.org
- [Privacy](https://anyclinic.org/privacy)
- [Sitemap](https://anyclinic.org/sitemap.xml)

## Markdown for agents

Key pages are available as text/markdown via content negotiation (send
`Accept: text/markdown`) or directly under https://anyclinic.org/md — for
example https://anyclinic.org/md/about.
