@mymedi-ai/mcp-server
  
MCP server for healthcare AI. Connect Claude, Cursor, VS Code, or any MCP client to 32 medical billing + clinical intelligence tools backed by 81K+ codes and 7 free government data sources — plus denial-decoding prompts and CMS dataset resources. Six tools work with no API key at all, and every clinical tool is read-only and PHI-free by design.
Claude (web or desktop) users: Settings → Connectors → Add custom connector → paste https://mymedi-ai.com/mcp-stream — no authentication, tools work immediately.
Quick Start
Two ways to pay — pick either:
Option A: Register for credits (100 free)
curl -X POST https://mymedi-ai.com/bot-marketplace/register \
-H "Content-Type: application/json" \
-d '{"name": "my-agent"}'
# → { apiKey, credits: 100 }Option B: Anonymous per-call USDC (no signup)
Send USDC on Base to the treasury wallet and include the signed payment in X-402-Payment header. True agent-to-agent commerce. See /agent/v1/pricing for details.
Or try free
curl "https://mymedi-ai.com/agent/v1/demo?code=99213"Returns basic code metadata (60/hour rate-limited). Paid tier unlocks RVU, Medicare reimbursement (PFS + OPPS), crosswalks, and AI features.
Works without an API key
Six tools are free and need no API key — install the server with no MCP_API_KEY and they work immediately (rate-limited 60/hour/IP):
| Tool | Description | |------|-------------| | pa_required_check | Medicare DMEPOS prior-auth required check — CMS Required Prior Authorization List (42 CFR 414.234) | | denial_code_info | DME denial code (CARC) explainer — meaning, common causes, fixes, appealability | | code_lookup_basic | Basic medical code lookup — code, type, description, category, active status | | reimbursement_basic | Medicare national PFS payment + DMEPOS fee-schedule ranges (rental/purchase) | | order_readiness_checklist | Blank DMEPOS pre-delivery checklist — SWO elements, F2F/WOPD, prior auth (42 CFR 410.38) | | modifier_advisor | DMEPOS billing-modifier guidance — KX/GA/GY/GZ, RR/NU/UE, capped-rental, RT/LT |
The other 24 paid tools need an API key from POST /bot-marketplace/register (100 starter credits); account_status and buy_credits manage that account and never bill credits.
Client Setup
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"mymedi-ai": {
"command": "npx",
"args": ["-y", "@mymedi-ai/mcp-server"],
"env": {
"MCP_API_KEY": "your-api-key"
}
}
}
}Cursor / VS Code
Add to MCP settings:
{
"mymedi-ai": {
"command": "npx",
"args": ["-y", "@mymedi-ai/mcp-server"],
"env": {
"MCP_API_KEY": "your-api-key"
}
}
}Claude Code
claude mcp add mymedi-ai -- npx -y @mymedi-ai/mcp-serverTools (32)
Free (no API key)
| Tool | Description | Price | |------|-------------|-------| | pa_required_check | Medicare DMEPOS prior-auth required check (42 CFR 414.234) | free | | denial_code_info | DME denial code (CARC) explainer | free | | code_lookup_basic | Basic code metadata lookup | free | | reimbursement_basic | Medicare national PFS payment + DMEPOS fee-schedule ranges | free | | order_readiness_checklist | Blank DMEPOS pre-delivery checklist (SWO, F2F/WOPD, PA) | free | | modifier_advisor | DMEPOS billing-modifier guidance (KX/GA/GY/GZ, RR/NU/UE, RT/LT) | free |
Medical Coding
| Tool | Description | Price | |------|-------------|-------| | code_lookup | Look up ICD-10, CPT, HCPCS codes (81K+ codes) + DMEPOS fees | $0.001 | | code_lookup_batch | Batch lookup, up to 25 codes per call | $0.001/code | | code_suggest | Code suggestions from clinical text (81K-code term search) | $0.01 | | code_validate | Validate code correctness and status | $0.005 | | code_validate_batch | Batch validation, up to 25 codes per call | $0.005/code | | code_crossref | Cross-reference codes across ICD-10/CPT/HCPCS | $0.02 | | code_reimbursement | Medicare PFS + OPPS reimbursement rates (RVU, $) | $0.01 | | fee_schedule_lookup | DMEPOS fee schedule — state + RR/NU/UE modifier specific | $0.01 |
Prior Auth & Claims
| Tool | Description | Price | |------|-------------|-------| | pa_predict | Approval rate from decided-PA cohort + CMS requirement facts | $0.05 | | pa_status | Check prior auth status | $0.02 | | pa_exposure_report | PA/WOPD catalog exposure report, up to 100 codes | $0.01/code | | claims_validate | Pre-submission claims validation | $0.05 | | ner_extract | Extract medical entities from clinical text | $0.02 | | compliance_audit | HIPAA compliance audit | $0.25 |
Drug Intelligence
| Tool | Description | Price | |------|-------------|-------| | drug_lookup | OpenFDA drug info + adverse events | $0.01 | | drug_interactions | FDA co-reported adverse event signals | $0.03 | | drug_rxnorm | NIH RxNorm + clinical interactions | $0.02 | | drug_enrich | AI-enriched drug intelligence | $0.03 |
Providers & Market
| Tool | Description | Price | |------|-------------|-------| | provider_search | NPI provider directory search | $0.005 | | provider_enrich | AI-enriched provider intelligence | $0.05 | | provider_payments | Sunshine Act physician payments (CMS Open Payments) | $0.02 | | market_analysis | Specialty market analysis by state | $0.10 |
Clinical & Public Health
| Tool | Description | Price | |------|-------------|-------| | trials_search | Active clinical trials (ClinicalTrials.gov) | $0.03 | | disease_surveillance | CDC NNDSS case counts + trends | $0.02 |
Account & Billing (API key, never bills credits)
| Tool | Description | Price | |------|-------------|-------| | account_status | Credit balance, USD equivalent, recent transactions | free | | buy_credits | Stripe Checkout link to top up credits ($1 = 1,000 credits) | free |
Prompts
| Prompt | Arguments | What it does | |--------|-----------|--------------| | decode-denial | code (CARC, e.g. CO-50) | Decodes the denial via denial_code_info, then builds a fix/resubmit/appeal action plan | | order-readiness | code (HCPCS, e.g. E0466) | Assembles the blank pre-delivery paperwork checklist via order_readiness_checklist |
Resources
| Resource | URI | Contents | |----------|-----|----------| | PA Required List | mymedi://datasets/pa-required-list | Full CMS Required Prior Authorization List (42 CFR 414.234) with categories and effective dates | | F2F + WOPD List | mymedi://datasets/f2f-wopd-list | Full CMS face-to-face/WOPD list (42 CFR 410.38(d)) plus the universal SWO elements | | Platform overview | https://mymedi-ai.com/llms.txt | What MyMedi-AI is, tool catalog, pricing, integration paths |
Environment Variables
| Variable | Description | Default | |----------|-------------|---------| | MCP_API_KEY | API key from registration (omit for free tools / anonymous USDC) | — | | MCP_API_BASE_URL | API base URL | https://mymedi-ai.com | | MCP_CONNECTOR_TOKEN | Shared-egress rate-limit token for hosted multi-user deployments (not needed for individual installs) | — |
Payment
- Free tier: 100 starter credits on registration ($0.10 of usage — enough to run
pa_predictonce and sample the cheap tiers) - Credit rate: $0.001 per credit (1 credit = 1 cheapest call)
- x402 USDC: Pay per call on Base chain — no signup, agent-native commerce
- Stripe: Credit packages at mymedi-ai.com/bot-marketplace/credits/pricing
- USDC deposit: Send to treasury wallet and redeem for credits
Credit Balance Headers
Every paid response includes:
| Header | Meaning | |--------|---------| | X-Credits-Remaining | Balance after this call | | X-Credits-Spent | Credits this call consumed | | X-Credits-Warning | low (<50), critical (<10), depleted (0) | | X-Credits-Action-Required | top-up or top-up-soon when balance is tight |
Your SDK/agent can watch for these to trigger auto-top-up.
SDK
For programmatic use without MCP, install the SDK:
npm install @mymedi-ai/sdkimport { MyMediAI } from '@mymedi-ai/sdk';
const client = new MyMediAI({ apiKey: 'your-api-key' });
const result = await client.codeLookup('M79.3');Data Sources
All 7 license-free government sources:
- ICD-10 / HCPCS / CPT: CMS PFS RVU 2026 (public domain)
- NPI provider directory: CMS (public domain)
- OpenFDA: drug labels, adverse events, interactions
- RxNorm: NIH normalized drug terminology
- ClinicalTrials.gov: active clinical trials
- CMS Open Payments: Sunshine Act physician payments
- CDC NNDSS: notifiable disease surveillance
Troubleshooting
- "Payment required" / 402 responses — the tool you called is pay-per-call and no API key is configured. Register a free key (100 starter credits):
curl -X POST https://mymedi-ai.com/bot-marketplace/register -H "Content-Type: application/json" -d '{"name":"your-agent"}', then setMCP_API_KEY. The five free tools never need a key. - 429 / rate-limited on free tools — free endpoints allow 60 requests/hour per IP. Wait, or register a key and use the paid equivalents.
- Connector won't connect — the hosted endpoint is
https://mymedi-ai.com/mcp-streamover Streamable HTTP. Verify it from a terminal:npx -y @modelcontextprotocol/inspector --cli https://mymedi-ai.com/mcp-stream --transport http --method tools/list. - Code not found — lookups expect bare code strings (
E1390,99213,M79.3). Denial codes acceptCO-50,co50, or50. - Stale data concerns — reference data follows CMS release cycles (HCPCS April 2026, PFS RVU Jan 2026, PA/F2F lists per Federal Register notices); each response carries its list version where applicable.
- Still stuck? Email support@mymedi-ai.com or open an issue at https://github.com/MyMedi-AI/mymedi-ai-mcp-server/issues.
Links
License
MIT
