{"uid":"cap_SwCBBU9x6d1R8vPHs0CYK","slug":"us-hospital-price-transparency-file-discoverer-6d81f9ff","name":"US Hospital Price Transparency File Discoverer","description":"Find a US hospital's machine-readable price files from its website domain. Reads the hospital's root cms-hpt.txt pointer and returns the location name, source page and machine-readable-file URL for each location, with the detected file format.","url":"https://api.agentstools.dev/price/discover","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"domain":{"type":"string","description":"Hospital website domain, e.g. nemours.org"},"mrf_url":{"type":"string","description":"A machine-readable-file URL to classify directly instead of discovering from a domain"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zRGLmSZeoljzhu8YdWPue","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Discovers machine-readable price files (MRFs) for a US hospital by reading its CMS-required cms-hpt.txt pointer file and returning location names, source pages, MRF URLs, and detected file formats.","exampleAgentPrompt":"Can you find the machine-readable price files for Johns Hopkins — give me the MRF download URLs and file formats from their website at hopkinsmedicine.org?","exampleUseCases":[{"title":"Compare hospital pricing file formats","prompt":"I'm researching price transparency across major health systems — can you pull the MRF URLs and file formats for Mayo Clinic at mayoclinic.org so I know what format their pricing data comes in before I start downloading?"},{"title":"Locate chargemaster for insurance audit","prompt":"We're auditing negotiated rates for a client — can you find all the machine-readable price files for HCA Healthcare from hcahealthcare.com, including each location name and the direct download links?"},{"title":"Verify CMS compliance for hospital network","prompt":"I need to check if Nemours Children's Health is meeting CMS price transparency requirements — can you look up their MRF files from nemours.org and tell me what locations are listed and whether the files are accessible?"}],"resultDescription":"Returns a list of hospital locations found via the cms-hpt.txt pointer, each with: the location name, the source page where the MRF was linked, the direct URL to the machine-readable file, and the detected file format (e.g. CSV, JSON, ZIP).","failureModes":["Domain has no cms-hpt.txt file — returns empty or not-found result","Hospital website blocks crawler access — returns access error","MRF URL is listed in cms-hpt.txt but the file itself is unavailable or broken","Domain typo or non-hospital domain provided — no valid pointer found","cms-hpt.txt exists but is malformed or non-standard — partial or empty results"],"whenToPreferThis":"Use this endpoint when you need to programmatically locate a US hospital's CMS-mandated machine-readable price transparency files starting from just the hospital's website domain. It is the right choice when you want to bypass manual site navigation and directly resolve MRF download links from the standardized cms-hpt.txt pointer. Prefer it over general web scraping when you need structured, normalized output including file format classification across multiple hospital locations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:59:37.470Z","isFirstParty":false}