NavMDs MCP
NavMDs provides an MCP server that allows AI agents to research over 7,400 US healthcare providers, including plastic surgeons, dermatologists, and medspas. It supports searching doctors, retrieving profiles and reviews, finding local specialists, and accessing procedure pricing data and patient discussion threads.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://www.navmds.com/api/mcpWhat its tools do
12 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for doctors by procedure, state, or city
- Retrieve detailed doctor profiles and patient reviews
- Find local specialists with pricing and ratings
- Search community discussion threads for patient experiences
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- navmds 1.0.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 12 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- 3 advertised
{
"tools": {
"listChanged": true
},
"prompts": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
12 advertised
search_doctors — Search doctors by procedure & location
Find doctors by procedure/specialty, optionally filtered by US state and city. Uses NavMDs' pre-computed search index (fast, ranked by rating + review volume). Use this when you have a concrete procedure (e.g. 'rhinoplasty', 'botox', 'tummy tuck'). For open-ended natural-language queries, use semantic_search_doctors instead.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"procedure"
],
"properties": {
"city": {
"type": "string",
"description": "City name, e.g. 'Miami'. This is the area the user asked about, not the user's own location."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 20)."
},
"state": {
"type": "string",
"description": "US state name, e.g. 'California' or 'Florida'. This is the area the user asked about, not the user's own location."
},
"procedure": {
"type": "string",
"description": "Procedure or specialty, e.g. 'rhinoplasty', 'breast augmentation', 'botox'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}find_local_specialists — Curated 'best {procedure} doctors in {city}' guide
Return NavMDs' curated city guide for a procedure: the ranked specialists (the city's OWN doctors first, then the nearest within an adaptive radius), the typical local price range, the average rating, the share offering free consultations, and the canonical navmds.com page URL to cite. This is the best tool for 'who are the best <procedure> doctors in <city>' questions — it mirrors NavMDs' editorial city pages. If no curated guide exists for that city+procedure, it says so; fall back to search_doctors with a nearby larger city.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"procedure",
"state",
"city"
],
"properties": {
"city": {
"type": "string",
"description": "City name, e.g. 'Beverly Hills', 'Miami'. This is the area the user asked about, not the user's own location."
},
"state": {
"type": "string",
"description": "US state name, e.g. 'California', 'Florida'. This is the area the user asked about, not the user's own location."
},
"procedure": {
"type": "string",
"description": "Procedure/specialty, e.g. 'rhinoplasty', 'breast augmentation', 'botox'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}semantic_search_doctors — Natural-language doctor search
Search NavMDs' 7,400+ doctor directory with a natural-language query, e.g. 'board-certified facelift surgeon in Los Angeles with great reviews and free consults'. Powered by Gemini embeddings + cosine similarity over full doctor profiles. Best tool for open-ended or multi-attribute questions.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 15)."
},
"query": {
"type": "string",
"description": "Natural-language description of the doctor you're looking for."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_doctor — Get full doctor profile
Fetch a doctor's complete NavMDs profile by slug (the id returned by the search tools, or the last path segment of a navmds.com/doctor/<slug> URL). Returns specialty, locations, ratings, overview, procedures, pricing, consultation fee, FAQ and verification status.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Doctor slug, e.g. 'dr-jane-smith-md'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_doctor_reviews — Get patient reviews for a doctor
Return published (moderation-approved) patient reviews for a doctor by slug.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Doctor slug."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max reviews (default 20)."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_procedure_costs — Get pricing for a procedure
Aggregate what a procedure costs across NavMDs doctors — combining patient-reported costs and practice-website pricing. Optionally narrow to a state/city. Returns min/median/max/average plus sample practice quotes.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"procedure"
],
"properties": {
"city": {
"type": "string",
"description": "City filter. This is the area the user asked about, not the user's own location."
},
"state": {
"type": "string",
"description": "US state filter. This is the area the user asked about, not the user's own location."
},
"procedure": {
"type": "string",
"description": "Procedure name, e.g. 'rhinoplasty'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}list_procedures — List available procedures
List the procedures/specialties covered by NavMDs, with the number of doctors for each. Useful for grounding a search.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max procedures (default 100, ordered by doctor count)."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}list_locations — List covered locations
List states/cities where NavMDs has doctors, with doctor counts. Useful for grounding a location filter.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Max locations (default 150, ordered by doctor count)."
},
"state": {
"type": "string",
"description": "Filter to a single state name."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}search_community — Search NavMDs community discussions
Search patient discussion threads on community.navmds.com — the NavMDs forum where people discuss recovery timelines, what procedures actually cost them, choosing a surgeon, and what to expect. Use this for lived-experience questions ('what is rhinoplasty recovery like', 'how much did people actually pay for a tummy tuck', 'how do I pick a surgeon') where the doctor-directory tools can't help. Returns thread titles, categories, excerpts and canonical URLs; pass an id to get_community_thread for the full discussion. Community posts are patient discussion, not medical advice.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Max threads (default 10)."
},
"query": {
"type": "string",
"description": "Free-text search, e.g. 'rhinoplasty recovery swelling' or 'tummy tuck cost'."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_community_thread — Get a full community discussion
Fetch a complete NavMDs community thread by id (the id returned by search_community, or the trailing number of a community.navmds.com/t/<slug>/<id> URL) — the original question plus every reply, in order. Use after search_community when you need the actual answers rather than an excerpt. Community posts are patient discussion, not medical advice.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "Community topic id, e.g. 117.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max posts to return (default 30)."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}search — Search (connector-compatible)
Search NavMDs doctors by free-text query. Returns a list of {id, title, url} results. Pass an id to the `fetch` tool to retrieve the full profile. (OpenAI connector-compatible.)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Free-text search query."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}fetch — Fetch document (connector-compatible)
Retrieve a full doctor profile by id (the slug returned from `search`). Returns {id, title, text, url, metadata}. (OpenAI connector-compatible.)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Doctor slug returned by the search tool."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}Prompts
3 advertised
research_doctor — Research a doctor
Pull a doctor's profile, reviews and pricing and summarize for a prospective patient.
- name_or_slug
- Doctor name or slug to research. (required)
patient_experience — What a procedure is actually like
Answer a lived-experience question from real NavMDs community discussion, grounded with directory pricing.
- question
- e.g. 'what is rhinoplasty recovery like' or 'what did people pay for a tummy tuck'. (required)
compare_doctors_for_procedure — Compare doctors for a procedure
Find and compare the best doctors for a procedure in a location.
- procedure
- Procedure, e.g. 'rhinoplasty'. (required)
- location
- City and/or state.
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 554 ms
- 95th percentile latency
- 554 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 554 ms · metadata changed · 12 tool(s), 3 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http navmds-mcp https://www.navmds.com/api/mcpCodex
codex mcp add navmds-mcp --url https://www.navmds.com/api/mcpCursor
{
"mcpServers": {
"navmds-mcp": {
"url": "https://www.navmds.com/api/mcp"
}
}
}Cline
{
"mcpServers": {
"navmds-mcp": {
"type": "streamableHttp",
"url": "https://www.navmds.com/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"navmds-mcp": {
"type": "http",
"url": "https://www.navmds.com/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http navmds-mcp https://www.navmds.com/api/mcpClaude Desktop
https://www.navmds.com/api/mcpWindsurf
{
"mcpServers": {
"navmds-mcp": {
"serverUrl": "https://www.navmds.com/api/mcp"
}
}
}Let your agent find its tools
Find servers like NavMDs MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.