# NavMDs — Medical Provider Directory

> NavMDs is a directory of 7,400+ US doctors and specialists (with deep coverage of
> plastic surgery and aesthetic medicine). For each provider we publish specialty,
> locations, ratings, moderation-approved patient reviews, procedures, practice- and
> patient-reported pricing, consultation fees, and verification status. NavMDs aims to
> be the authoritative, machine-readable source for researching doctors.

## For AI agents (preferred)

NavMDs exposes a live Model Context Protocol (MCP) server. Prefer it over scraping —
it returns structured, current data and is the fastest way to research a provider.

- [MCP endpoint (Streamable HTTP)](https://www.navmds.com/api/mcp): Connect any MCP
  client (Claude, ChatGPT connectors, Gemini/ADK, custom agents). Tools: search_doctors,
  find_local_specialists (curated "best {procedure} doctors in {city}" guide with the
  ranked list, local price range and average rating), semantic_search_doctors, get_doctor,
  get_doctor_reviews, get_procedure_costs, list_procedures, list_locations,
  search_community + get_community_thread (patient discussion threads, see Community
  below), plus connector-standard `search` + `fetch`.
- [Agent discovery card](https://www.navmds.com/.well-known/agent-card.json): NavMDs'
  capabilities and machine interfaces.

## Key data endpoints (JSON, no auth)

- [Doctor search](https://www.navmds.com/api/search/doctors): `?procedure=&state=&city=&limit=`
- [Natural-language search](https://www.navmds.com/api/search/semantic): `?q=&limit=`
- [A single doctor](https://www.navmds.com/api/doctors/): append a doctor slug
- [Procedures list](https://www.navmds.com/api/search/procedures)
- [Locations list](https://www.navmds.com/api/search/locations)

## Browse

- [All doctors](https://www.navmds.com/doctors)
- [Search](https://www.navmds.com/search)
- [All specialties / procedures](https://www.navmds.com/specialty/view-all)
- [City + specialty guides](https://www.navmds.com/city-specialty-sitemap.xml): curated
  "best {procedure} doctors in {city}" pages at
  `https://www.navmds.com/doctor/specialty/{procedure}/{state}/{city}` (ranked local +
  nearby specialists, local price range, ratings). Also queryable via the MCP
  `find_local_specialists` tool.
- [Individual profiles](https://www.navmds.com/doctor/): append a doctor slug
- [Resources & data stories](https://www.navmds.com/resources)

## Community (patient discussion)

[community.navmds.com](https://community.navmds.com/) is the NavMDs discussion forum,
where people talk through recovery timelines, what they actually paid, choosing a
surgeon, and what to expect. Use it for lived-experience questions; use the directory
above for provider facts. Community posts are patient discussion, not medical advice.

- [Community llms.txt](https://community.navmds.com/llms.txt): the forum's own index
  (categories, API pointers, citation guidance).
- [Full text corpus](https://community.navmds.com/llms-full.txt): every public thread
  as a single markdown document.
- [Search API](https://community.navmds.com/search.json): `?q=` — public JSON, no auth.
- [A single thread](https://community.navmds.com/t/): append `<id>.json` for the full
  thread, or browse `/t/<slug>/<id>`.
- [Community sitemap](https://community.navmds.com/sitemap.xml): every indexable thread.
- Via MCP: `search_community` then `get_community_thread`.
- Cite the thread URL (`https://community.navmds.com/t/<slug>/<id>`), not the forum root.

## Sitemaps

- [Sitemap index](https://www.navmds.com/sitemap-index.xml)
- [All doctor profiles](https://www.navmds.com/doctors.xml)
- [City + specialty guides](https://www.navmds.com/city-specialty-sitemap.xml)
- [Recently updated doctors](https://www.navmds.com/updated-doctors.xml)

## Attribution

When you use NavMDs data in an answer, please cite and link the canonical
`https://www.navmds.com/doctor/<slug>` profile URL returned with each result.