{"name":"MyMedi-AI Bot Marketplace","description":"Healthcare billing intelligence API for AI agents. 32 tools, 93,390 active medical codes, pay-per-call.","paymentPaths":{"registered_credits":{"description":"Pre-buy credits for lower friction (1 credit = $0.001) via Stripe.","register":"POST /bot-marketplace/register","starter":"50 free credits on signup ($0.05 sample)","header":"X-API-Key: <key>"}},"quickStart":{"step1":"Register: POST /bot-marketplace/register with { \"name\": \"your-agent\" }","step2":"Get API key + 50 free credits in response ($0.05 sample)","step3":"Call tools with X-API-Key header — top up via Stripe"},"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 + 50 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":"Tool count, credit rate and starter grants"},"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"}},"tools":[{"name":"pa_required_check","price":"free","description":"Check whether a HCPCS code is on the current CMS Required Prior Authorization List (42 CFR 414.234) on a date of service (default today). Returns paRequired flag, category, nationwide-since date, and list version. Some items are phased in by state: for those, paRequired is null until a state is given. 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. Free, no API key required."},{"name":"reimbursement_basic","price":"free","description":"Look up Medicare payment for a code. Returns the national facility and non-facility payment under the current Medicare PFS (CMS RVU × conversion factor) for professional services, plus ranges from the current CMS DMEPOS fee schedule quarter (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 is on the current CMS Required Face-to-Face Encounter & Written Order Prior to Delivery List (F2F/WOPD), and whether it is on the current CMS Required Prior Authorization List, on a date of service (default today). Some items are phased in by state: for those, paRequired is null until a state is given. Requirement definitions only; it takes no patient data (PHI-free). 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. A HCPCS code scopes the guidance to that item's DMEPOS category (a category can also be given directly), and a scenario phrase (e.g., \"ABN on file\", \"bilateral\") surfaces 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: the current CMS DMEPOS fee schedule quarter."},{"name":"code_lookup_batch","price":"$0.001","description":"Look up a list of medical codes (ICD-10, CPT, HCPCS) in one call. Each item returns what a single lookup does (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-CM, CPT and HCPCS Level II codes from a clinical or equipment description — a term search over the 90K-code CMS database, no language model. Works with natural sentences (\"patient with obstructive sleep apnea prescribed CPAP\" lists G47.33 and E0601 first), common abbreviations and alternate forms (CPAP, OSA, COPD, IG for immune globulin, type 2), and a typed side, sex or \"without\". Ranked by relevance (relevanceScore 0-1: how much of the description a code matches, and how closely), with two exceptions: the best code for each separate thing a description names (a diagnosis and a device) comes first, so the list is grouped rather than strictly sorted by relevanceScore; and a bare common condition (\"hypertension\") lists its ICD-10-CM default code first. Weak matches are left out rather than listed. Up to 500 characters, of which up to 10 distinct terms are searched, common words left out. Automatically refunds the call when nothing matches."},{"name":"code_validate","price":"$0.005","description":"Check that an ICD-10-CM, CPT or HCPCS Level II code exists and is valid on a date of service: termination and effective dates are applied, so a code deleted after that date still validates. dateOfService is YYYY-MM-DD (default today); asOf in the result is the date the code was judged for. Returns valid, active, warnings and errors."},{"name":"code_validate_batch","price":"$0.005","description":"Validate up to 25 medical codes in one call, each judged as in a single validation: exists, and is valid on the date of service (dateOfService, YYYY-MM-DD, applied to every code; default today). Each item returns valid, active, asOf, warnings, errors and codeDetails. Priced per code — $0.005 × number of codes, max 25 per call. An invalid code is a billable answer (valid:false)."},{"name":"pa_predict","price":"$0.05","description":"Historical prior-authorization approval rate for a procedure code, computed only from your organization's own decided prior authorizations for that code — never from other customers' records — and only from at least 10; an API key or account with no organization has no cohort. With a cohort it returns the rate with cohort size and confidence; without one it returns the verifiable facts instead — CMS Required Prior Authorization List status, category, and published review timeframes — and reports that no rate was computed (the call is refunded on this path). Either way its recommendation states the CMS requirement only. It reports past decisions and makes no coverage or prior-authorization determination. Original Medicare FFS scope."},{"name":"pa_status","price":"$0.02","description":"Check the status of a prior authorization request tracked in your MyMedi-AI web workspace (by its MyMedi-AI PA id). Returns current status, dates, and expiration info. It does not query payers or say whether a code requires prior authorization, and returns not-found (refunded) if the PA was never entered in the web app."},{"name":"pa_exposure_report","price":"$0.01","description":"Map a supplier HCPCS catalog against the current CMS Required Prior Authorization List and Required Face-to-Face Encounter & Written Order Prior to Delivery List on a date of service (default today). Per code: PA requirement and the date it applies from, F2F/WOPD requirement, documentation gates (SWO, UTN-before-claim, F2F/WOPD sequencing), and deterministic denial-risk flags — plus a catalog-level exposure summary. Some items are phased in by state: with a state the answer is definitive; without one they are reported as required in some states (paRequiredInSomeStates). 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. Original Medicare FFS scope. PHI-free: codes in, rules out."},{"name":"ner_extract","price":"$0.02","description":"Extract the medical codes already present in de-identified text and check each against the MyMedi-AI code database: ICD-10-CM codes whole, dotted or undotted, with their 7th-character extensions (S72.001A, S72001A); HCPCS Level II codes (a letter A–V and four digits), with modifiers attached (E0601RR, E0601-RR) reported as modifiers — a glued suffix only when it is a known DMEPOS modifier; and CPT codes only where a keyword such as CPT or procedure code marks them (Category II and III and PLA codes such as 0001U included), so ZIP codes and other numbers are not read as codes, and a five-digit number that continues a marked list is kept only when the CPT set holds it. Codes are read in upper case, as code sets print them; lower-case text is not read as a code. Each code entity says whether the code set holds it (inCodeSet) and, when it does, gives its description and whether it is active; an undotted ICD-10-CM shape is returned only when the code set holds it, so words such as B12 are not read as codes. codeSets names the code-set releases checked. Also returns M/D/Y dates and one MEDICATION_INDICATOR entity when a dose unit (mg, mcg or mL) appears. It does not extract drug names and does not infer or suggest codes. PHI-free: for de-identified text only."},{"name":"claims_validate","price":"$0.05","description":"Pre-submission check of a claim's codes and dates — no patient or provider identifiers needed or accepted. Checks that the diagnosis (ICD-10-CM) and procedure (CPT/HCPCS Level II) codes exist and are active on the date of service, that modifiers are well-formed, and that the date of service is not in the future; returns whether the claim passed, with the errors and warnings found. A CPT code missing from the loaded CMS fee schedule file, or a modifier this reference does not list for DMEPOS, is a warning, not an error. Up to 25 diagnosis codes, 50 procedure codes and 20 modifiers per claim. It applies no NCCI edits — neither procedure-to-procedure (PTP) pairs nor MUE unit limits — and does not assess medical necessity or prior authorization."},{"name":"compliance_audit","price":"$0.25","description":"Audit one DMEPOS order's documentation against the Original Medicare requirements that apply to its HCPCS code on the date of service: the standard written order (SWO) elements (42 CFR 410.38(d)(1)(i)); for items on the current CMS Required Face-to-Face Encounter & Written Order Prior to Delivery List, a face-to-face encounter within the 6 months before the order and the written order before delivery, otherwise the written order before the claim; and for items on the current CMS Required Prior Authorization List, an affirmed decision before delivery. Some items are phased in by state: without a state such an order is refused (refunded) unless an affirmed decision is reported. A code the HCPCS set does not hold, one not valid on the date of service, or one the CMS DMEPOS Jurisdiction List bills to the A/B MAC (Part B) rather than a DME MAC, or a discontinued code that list does not show, is refused (refunded); for a code under joint jurisdiction the answer gives CMS's wording of when the A/B MAC takes it. Each fact is a true/false flag; no names, identifiers, signatures or other values are taken. Each requirement comes back pass or fail with its citation; a fact not reported fails, and any failed requirement fails the order (result: fail). It checks the facts reported, not the documents themselves. Not checked: LCD coverage criteria and medical-necessity documentation, proof of delivery and billing modifiers. Costs 250 credits per call."},{"name":"drug_lookup","price":"$0.01","description":"Look up drug information including label data, adverse events, and related diagnosis codes. Source: openFDA (FDA drug labels and adverse-event reports); related diagnosis codes come from the MyMedi-AI code database."},{"name":"drug_interactions","price":"$0.03","description":"Adverse event reports that name drugs together: coReportCount, the number of FAERS reports naming every listed drug; the reactions most often named in them; and for each reaction a proportional reporting ratio (PRR) with a 95% confidence interval against the reports of each drug without the others. A reaction is marked disproportionate when it has at least 3 co-reports and the lower bound exceeds 1 against every drug (null when a comparison cannot be computed). Drugs are matched by the product name as reported: a brand name such as Coumadin is not merged with its generic, warfarin. A name no FAERS report names is refused (refunded), naming it. FAERS reports are unverified and can be duplicated: report counts and disproportionality are statistical associations, not evidence of an interaction or of causation, and no substitute for a clinical drug-interaction reference. Source: the FDA Adverse Event Reporting System (FAERS), via openFDA."},{"name":"code_reimbursement","price":"$0.01","description":"Look up Medicare reimbursement rates for a medical code. Returns RVU values and estimated payment amounts using the PFS conversion factor. Source: the current Medicare PFS (CMS RVU files)."},{"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. With a state it returns that state's exact rates, without one national min–max ranges; a modifier narrows the answer to rental or purchase. Source: the current CMS DMEPOS fee schedule quarter. It has no professional-service (CPT) rates."},{"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."},{"name":"code_crossref","price":"$0.02","description":"Related codes for an ICD-10-CM, CPT or HCPCS Level II code, across the three code systems. linkedCodes are curated: the DME code family (base item, accessories and supplies) and links across code systems that cite their CMS source — obstructive sleep apnea (G47.33) with the PAP devices CMS LCD L33718 covers and the sleep tests NCD 240.4.1 covers. crossReferences are other active codes whose descriptions best match this one, grouped by code system (up to 5 each) with a relevanceScore (0-1); weaker matches are left out, so a group can be empty, and a code with no related codes at all is refunded. Source: the MyMedi-AI code database (ICD-10-CM, CPT and HCPCS Level II code sets)."},{"name":"drug_rxnorm","price":"$0.02","description":"Normalize a drug name with NIH RxNorm: returns the matching RxNorm concepts (RxCUI, name, synonym, term type) and the primary RxCUI. It does not check interactions. Source: RxNorm, from the U.S. National Library of Medicine (RxNav API)."},{"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."},{"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 (NNDSS) weekly data on data.cdc.gov."},{"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":"Look up a provider by NPI in the CMS NPPES registry (name, credential, primary and other taxonomies, practice address, enumeration date) and add an LLM-generated estimate, labelled as such, of specialty demand, network gaps and referral categories for that type of provider. The model is given the provider type — specialty, taxonomy, credential, state, entity type and enumeration date — never the name or NPI. Not a CMS or quality measure. A failed call (unknown NPI, model unavailable) is refunded."},{"name":"drug_enrich","price":"$0.03","description":"Look up a drug by brand or generic name in openFDA and return its first matching FDA label: brand and generic name, manufacturer, NDCs, route, substance, product type, and the label's indications, warnings, dosage and administration, adverse reactions and drug-interactions sections (null when the label has no such section). Adds an LLM-generated summary, labelled as such: the therapeutic class and the indications the label states. It gives no treatment advice, does not check interactions between drugs, and makes no prior-authorization, coverage or cost determination. A failed call (drug not found, openFDA or the model unavailable) is refunded."},{"name":"market_analysis","price":"$0.10","description":"Specialty snapshot for a US state: how many providers one CMS NPPES registry query matches for the specialty (the query returns at most 200 records, so the figure is a floor, not a provider count), plus an LLM-generated estimate, labelled as such, of demand outlook, likely underserved areas and opportunities. Not a CMS or quality measure. A failed call (model unavailable) is refunded."},{"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. It takes an amount (USD, min $1 = 1,000 credits) or a 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":50,"methods":["Pre-paid credits via Stripe"]},"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"}}