{"name":"MyMedi-AI Bot Marketplace","description":"Healthcare billing intelligence API for AI agents. 32 tools, 81K+ medical codes, pay-per-call.","paymentPaths":{"anonymous_usdc":{"description":"Pay-per-call with on-chain USDC — no registration, no API key, true agent-to-agent commerce","protocol":"x402","network":"Base (eip155:8453)","wallet":"0xEeA1b43948f1106ae82c8abb89f0E6e09bd594a8","header":"X-402-Payment: <signed-payment-token>","facilitator":"https://x402.org/facilitator"},"registered_credits":{"description":"Pre-buy credits for lower friction (1 credit = $0.001). Stripe or USDC deposit.","register":"POST /bot-marketplace/register","starter":"100 free credits on signup ($0.10 sample)","header":"X-API-Key: <key>"}},"quickStart":{"step1":"Register: POST /bot-marketplace/register with { \"name\": \"your-agent\" }","step2":"Get API key + 100 free credits in response ($0.10 sample)","step3":"Call tools with X-API-Key header — top up via Stripe or USDC deposit"},"demo":{"url":"/agent/v1/demo?code=G47.33","description":"Basic code lookup only (free, rate-limited). Register for full RVU / reimbursement / crosswalk data."},"npm":{"mcp_server":{"package":"@mymedi-ai/mcp-server","install":"npx -y @mymedi-ai/mcp-server"},"sdk":{"package":"@mymedi-ai/sdk","install":"npm install @mymedi-ai/sdk"}},"endpoints":{"register":{"method":"POST","path":"/bot-marketplace/register","auth":"none","description":"Register bot, get API key + 100 free credits"},"balance":{"method":"GET","path":"/bot-marketplace/balance","auth":"X-API-Key","description":"Check credit balance"},"usage":{"method":"GET","path":"/agent/v1/usage","auth":"X-API-Key","description":"Per-endpoint call and spend stats"},"stats":{"method":"GET","path":"/bot-marketplace/stats","auth":"none","description":"Marketplace statistics"},"pricing":{"method":"GET","path":"/bot-marketplace/credits/pricing","auth":"none","description":"Credit packages and pricing"},"purchase":{"method":"POST","path":"/bot-marketplace/credits/purchase","auth":"X-API-Key","description":"Purchase credits via Stripe"},"deposit":{"method":"POST","path":"/bot-marketplace/credits/deposit","auth":"X-API-Key","description":"Deposit USDC for credits"}},"tools":[{"name":"pa_required_check","price":"free","description":"Check whether a HCPCS code is on the CMS Required Prior Authorization List (42 CFR 414.234). Returns paRequired flag, category, nationwide-since date, and list version. Original Medicare FFS scope. Free, no API key required."},{"name":"denial_code_info","price":"free","description":"Explain a DME claim denial code (CARC). Returns title, meaning, common DME causes, fixes, appealability, and related codes. Free, no API key required."},{"name":"code_lookup_basic","price":"free","description":"Look up basic metadata for a medical code: code, codeType, description, category, isActive. Basic metadata only — the paid code_lookup adds full metadata. Free, no API key required."},{"name":"reimbursement_basic","price":"free","description":"Look up Medicare payment for a code. Returns the national PFS facility and non-facility payment (CMS RVU × conversion factor) for professional services, plus DMEPOS fee-schedule ranges (rental/purchase, min–max across state fees) for DME items like E/K/L codes. Free, no API key required."},{"name":"order_readiness_checklist","price":"free","description":"Blank pre-delivery checklist for a HCPCS DMEPOS code: the universal standard written order (SWO) elements (42 CFR 410.38(d)), whether the code requires a face-to-face encounter and written order prior to delivery (F2F/WOPD), and whether it is on the Medicare Required Prior Authorization List. Requirement definitions only — PHI-free, never send patient data. Free, no API key required."},{"name":"modifier_advisor","price":"free","description":"Editorial guidance on DMEPOS billing modifiers: the KX/GA/GY/GZ medical-necessity and liability family, RR/NU/UE rental-vs-purchase, capped-rental month markers (KH/KI/KJ), and RT/LT laterality. Pass a HCPCS code to scope guidance to that item's DMEPOS category, or a category directly; add a scenario phrase (e.g., \"ABN on file\", \"bilateral\") to surface the relevant modifiers. Original editorial content, not payer policy. PHI-free. Free, no API key required."},{"name":"code_lookup","price":"$0.001","description":"Look up a medical code (ICD-10, CPT, HCPCS). Returns description, category, active status, and related codes. For DMEPOS (HCPCS) codes it also returns a labeled fee schedule: per-modifier (RR/NU/UE) national min–max ranges, or — when a state is given — that state's exact non-rural and rural rates. Source: CMS DMEPOS Fee Schedule (DME26-B)."},{"name":"code_lookup_batch","price":"$0.001","description":"Look up a list of medical codes (ICD-10, CPT, HCPCS) in one call. Per-item results mirror code_lookup (description, category, active status, related codes, DMEPOS fee schedule with optional state filter). Priced per code — $0.001 × number of codes, max 25 per call; the full charge is refunded automatically when every code misses."},{"name":"code_suggest","price":"$0.01","description":"Suggest ICD-10/CPT/HCPCS codes from a clinical description. Term-based search over the 81K-code CMS database, ranked by matched-term coverage and relevance. Works with natural sentences (\"patient with obstructive sleep apnea prescribed CPAP\"). Automatically refunds the call when nothing matches."},{"name":"code_validate","price":"$0.005","description":"Validate a medical code for correctness, active status, and context. Returns warnings and errors."},{"name":"code_validate_batch","price":"$0.005","description":"Validate a list of medical codes for correctness, active status, and optional date-of-service context in one call. Per-item results mirror code_validate (valid, active, warnings, errors, codeDetails). Priced per code — $0.005 × number of codes, max 25 per call. An invalid code is a billable answer (valid:false), same as the single validate."},{"name":"pa_predict","price":"$0.05","description":"Prior-authorization outlook for a procedure code. When a historical cohort of decided PAs exists (≥10), returns a data-driven approval rate with cohort size and confidence. When no cohort exists, returns the verifiable facts instead — CMS Required Prior Authorization List status, category, and published review timeframes — and explicitly reports that no probability was computed (the call is refunded on this path). Never fabricates a probability. Original Medicare FFS scope."},{"name":"pa_status","price":"$0.02","description":"Check the status of a prior authorization request. Returns current status, dates, and expiration info."},{"name":"pa_exposure_report","price":"$0.01","description":"Map a supplier HCPCS catalog against the CMS Required Prior Authorization List (74 items) and the Required Face-to-Face Encounter & Written Order Prior to Delivery List (83 items, effective 2026-04-13). Per code: PA requirement with nationwide-since date, F2F/WOPD requirement, documentation gates (SWO, UTN-before-claim, F2F/WOPD sequencing), and deterministic denial-risk flags — plus a catalog-level exposure summary. Unknown or non-HCPCS codes are flagged and count as billable answers. Priced per code — $0.01 × number of codes, max 100 per call. Returns JSON here; the REST endpoint also renders a branded PDF with {\"format\":\"pdf\"}. Original Medicare FFS scope. PHI-free: codes in, rules out."},{"name":"ner_extract","price":"$0.02","description":"Extract medical named entities from clinical text. Identifies ICD-10 codes, CPT codes, dates, medications, and 12 entity types with confidence scores."},{"name":"claims_validate","price":"$0.05","description":"Pre-submission claims validation. Checks for errors, missing fields, code mismatches, and provides fix suggestions before you submit to the payer."},{"name":"compliance_audit","price":"$0.25","description":"HIPAA compliance audit. Scans data for PHI exposure (SSN, MRN, DOB patterns), returns findings with severity, score (0-100), and remediation recommendations."},{"name":"drug_lookup","price":"$0.01","description":"Look up drug information including label data, adverse events, and related diagnosis codes. Source: OpenFDA (public domain)."},{"name":"drug_interactions","price":"$0.03","description":"Check drug-drug interaction signals from FDA adverse event co-reports. Returns co-reported reactions and signal strength. Source: OpenFDA FAERS (public domain)."},{"name":"code_reimbursement","price":"$0.01","description":"Look up Medicare reimbursement rates for a medical code. Returns RVU values and estimated payment amounts using CMS PFS conversion factor. Source: CMS PFS RVU 2026 (public domain)."},{"name":"fee_schedule_lookup","price":"$0.01","description":"Look up the CMS DMEPOS fee schedule for a DME/orthotic/prosthetic HCPCS code: rental (RR) vs purchase (NU new / UE used), non-rural vs rural, per state. Give a state for exact rates, or omit for national min–max ranges; filter by modifier to narrow to rental or purchase. Source: CMS DMEPOS Fee Schedule DME26-B (Apr 2026). For professional-service (CPT) payment use code_reimbursement instead."},{"name":"trials_search","price":"$0.03","description":"Search active clinical trials by condition, ICD-10 code, or intervention. Returns trial details including NCT ID, phase, enrollment, and eligibility. Source: ClinicalTrials.gov (public domain)."},{"name":"code_crossref","price":"$0.02","description":"Cross-reference a medical code across ICD-10, CPT, and HCPCS systems. Returns related codes grouped by system. Source: CodeReference DB (ICD-10/HCPCS: public domain)."},{"name":"drug_rxnorm","price":"$0.02","description":"Look up a drug in NIH RxNorm for normalized terminology (RxCUI) and optionally check clinical drug-drug interactions with severity ratings. Source: NIH RxNorm (public domain)."},{"name":"provider_payments","price":"$0.02","description":"Look up pharmaceutical and device company payments to a physician (Sunshine Act data). Returns total payments, breakdown by type, and top paying companies. Source: CMS Open Payments (public domain)."},{"name":"disease_surveillance","price":"$0.02","description":"Look up disease surveillance data including case counts and trends by condition and geography. Source: CDC National Notifiable Diseases Surveillance System (public domain)."},{"name":"provider_search","price":"$0.005","description":"Search the NPI provider directory. Find healthcare providers by name, specialty, or location."},{"name":"provider_enrich","price":"$0.05","description":"AI-enriched provider intelligence from NPI number. Returns practice details, specialties, affiliations, and market context."},{"name":"drug_enrich","price":"$0.03","description":"Drug information enrichment via OpenFDA. Returns drug details, indications, interactions, and AI analysis."},{"name":"market_analysis","price":"$0.10","description":"Healthcare specialty market analysis for a specific state. Returns provider density, competition metrics, and market opportunity data."},{"name":"account_status","price":"free","description":"Check your MyMedi-AI account: current credit balance, USD equivalent, transaction count, recent transactions, and last activity. Free — never bills credits. Uses your connector sign-in (or X-API-Key when self-hosted)."},{"name":"buy_credits","price":"free","description":"Top up your MyMedi-AI credits. Creates a Stripe Checkout session and returns a checkoutUrl for you to open and complete payment in the browser — calling this tool charges nothing by itself. Specify amount (USD, min $1 = 1,000 credits) or package (starter $1, basic $5, standard $25, professional $100, enterprise $500). 1 credit = $0.001; credits are added automatically after checkout."}],"payment":{"creditRate":"$0.001 per credit","starterCredits":100,"methods":["x402 USDC on Base (anonymous, no signup)","Pre-paid credits via Stripe","USDC deposit → credits"]},"links":{"homepage":"https://mymedi-ai.com","discovery":"/agent/v1/discovery","pricing":"/agent/v1/pricing","health":"/agent/v1/health","mcp_definition":"/mcp/definition","agent_json":"/.well-known/agent.json"}}