Medical Codes MCP Server

by cyanheadsio.github.cyanheads/medical-codes-mcp-serverv0.4.0

Offline US medical code lookup and crosswalk — ICD-10-CM/PCS, HCPCS Level II, RxNorm. Keyless.

2Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Medical Codes MCP server

claude mcp add medical-codes -- npx -y @cyanheads/medical-codes-mcp-server run start:stdio

{
  "mcpServers": {
    "medical-codes": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/medical-codes-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "medical-codes": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/medical-codes-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "medical-codes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/medical-codes-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "medical-codes": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/medical-codes-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MCP_LOG_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MEDCODE_DB_PATH	—	—	Absolute path override for the bundled SQLite index. Defaults to the packaged data/medical-codes.db.
MEDCODE_MAX_RESULTS	—	—	Default page size when a call sends no limit (search, browse, and the paginated map_codes directions), and the number of children get_code attaches with includeHierarchy (default 50, hard ceiling 200).
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.

Remote endpoints

streamable-httphttps://medical-codes.caseyjhand.com/mcp

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-08 · 1d ago · GitHub · v0.4.1
Package published
no data · npm/PyPI
Registry entry updated
2026-09-24 · 15d ago · official registry · v0.4.0

FAQ

›How do I install the Medical Codes MCP server in Claude Code?

Run: claude mcp add medical-codes -- npx -y @cyanheads/medical-codes-mcp-server run start:stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Medical Codes require an API key?

No required environment variables are declared in its published metadata.

›Can I use Medical Codes as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Medical Codes in the official MCP registry?

Yes, as io.github.cyanheads/medical-codes-mcp-server.