Model Context Protocol

A hosted MCP server for healthcare data

MCP is the open standard that lets AI agents call external tools without custom glue code. Point any MCP-capable client at Patientary’s endpoint and it gets real NPI and ICD-10 lookups as first-class tools — no wrapper to write, no scraped data to trust.

REST API docs

Setup

Add the server

Streamable HTTP transport, JSON-RPC 2.0, MCP protocol 2024-11-05 — one URL, no local process to run.

Endpoint:

https://patientary.com/api/mcp

Config snippet for Claude Code, Claude Desktop, Cursor or any client that reads a mcpServers map. The Authorization header is optional — omit it to call anonymously at the anonymous rate limit.

mcp config

{
  "mcpServers": {
    "patientary": {
      "url": "https://patientary.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ptn_live_..."
      }
    }
  }
}

Tools

What the server exposes

Six tools, one per lookup — the same data the REST API and the website serve.

lookup_npi

Fetch a single provider by 10-digit NPI from the live CMS NPPES registry.

{ "npi": "1245319599" }

search_providers

Search NPPES by name, organization, taxonomy or location.

{ "last_name": "smith", "state": "CA", "taxonomy": "cardiology" }

lookup_icd10

Get one ICD-10-CM code — chapter, billable status, parent and children.

{ "code": "E11.9" }

search_icd10

Search ICD-10-CM by code prefix or clinical description.

{ "q": "type 2 diabetes", "billable": true }

validate_codes

Batch-validate NPIs and ICD-10 codes in one call (claim scrubbing). Batches over 1 item require a paid key.

{ "npis": ["1245319599"], "icd10": ["E11.9", "Z00.00"] }

lookup_taxonomy

Look up or search NUCC provider-taxonomy (specialty) codes.

{ "q": "family medicine" }

tools/call request

POST https://patientary.com/api/mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "lookup_icd10",
    "arguments": { "code": "E11.9" }
  }
}

response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{ \"request_id\": \"req_2b7f\", \"code\": { \"code\": \"E11.9\", \"name\": \"Type 2 diabetes mellitus without complications\", \"chapter\": \"IV\", \"billable\": true }, \"disclaimer\": \"...\" }"
    }]
  }
}

Anonymous calls are rate-limited to 6/min and 100/day per IP — enough to try the server from an agent config, not enough to build on. Pass Authorization: Bearer <key> (create one in Settings → API keys) for production limits: 10/min on Free, up to 600/min on Scale. See pricing for the full table.

Patientary is an informational reference tool built on public data (CMS NPPES and the official ICD-10-CM release). It is not medical, coding, legal or billing advice, and code assignment is the responsibility of a qualified professional. Always verify against the primary source before you bill or file.