# MedCode Oracle

# MedCode Oracle — Healthcare API for AI agents

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add mymedi-ai/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list mymedi-ai/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get mymedi-ai/mcp-server code_lookup

# Call a tool
npx -y @smithery/cli@latest tool call mymedi-ai/mcp-server code_lookup '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--mymedi-ai.run.tools`

## Tools (20)

- `code_lookup` — Look up medical codes (ICD-10, CPT, HCPCS) by code string. Returns description, category, active status, and related co…
- `code_suggest` — Get AI-powered medical code suggestions from a clinical description. Returns ranked code suggestions with relevance sco…
- `code_validate` — Validate a medical code for correctness, active status, and context. Returns warnings and errors.
- `pa_predict` — Predict prior authorization approval probability for a procedure. Returns approval likelihood (0-1), confidence level, …
- `pa_status` — Check the status of a prior authorization request. Returns current status, dates, and expiration info.
- `ner_extract` — Extract medical named entities from clinical text. Identifies ICD-10 codes, CPT codes, dates, medications, and 12 entit…
- `claims_validate` — Pre-submission claims validation. Checks for errors, missing fields, code mismatches, and provides fix suggestions befo…
- `compliance_audit` — HIPAA compliance audit. Scans data for PHI exposure (SSN, MRN, DOB patterns), returns findings with severity, score (0-…
- `drug_lookup` — Look up drug information including label data, adverse events, and related diagnosis codes. Source: OpenFDA (public dom…
- `drug_interactions` — Check drug-drug interaction signals from FDA adverse event co-reports. Returns co-reported reactions and signal strengt…
- `code_reimbursement` — Look up Medicare reimbursement rates for a medical code. Returns RVU values and estimated payment amounts using CMS PFS…
- `trials_search` — Search active clinical trials by condition, ICD-10 code, or intervention. Returns trial details including NCT ID, phase…
- `code_crossref` — Cross-reference a medical code across ICD-10, CPT, and HCPCS systems. Returns related codes grouped by system. Source: …
- `drug_rxnorm` — Look up a drug in NIH RxNorm for normalized terminology (RxCUI) and optionally check clinical drug-drug interactions wi…
- `provider_payments` — Look up pharmaceutical and device company payments to a physician (Sunshine Act data). Returns total payments, breakdow…
- `disease_surveillance` — Look up disease surveillance data including case counts and trends by condition and geography. Source: CDC National Not…
- `provider_search` — Search the NPI provider directory. Find healthcare providers by name, specialty, or location.
- `provider_enrich` — AI-enriched provider intelligence from NPI number. Returns practice details, specialties, affiliations, and market cont…
- `drug_enrich` — Drug information enrichment via OpenFDA. Returns drug details, indications, interactions, and AI analysis.
- `market_analysis` — Healthcare specialty market analysis for a specific state. Returns provider density, competition metrics, and market op…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get mymedi-ai/mcp-server <tool-name>
```
