{"uid":"cap_HPwSdg7PGKjO_3i6rSOdk","slug":"hospital-price-discover-102fcefd","name":"Hospital Price Discover","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://payai.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_NyforIgXdhWJHyJ5m_Rwe","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 US hospital machine-readable price files by reading the CMS-required cms-hpt.txt pointer from a hospital's website domain, returning location names, source pages, MRF URLs, and detected file formats.","exampleAgentPrompt":"Can you find the machine-readable price files for nemours.org? I need the MRF file URLs and file formats for all their locations.","exampleUseCases":[{"title":"Hospital price transparency compliance check","prompt":"Look up the machine-readable price files for mayoclinic.org and tell me the file URLs and formats they're using for each location — I need to check if they're CMS compliant."},{"title":"Healthcare price comparison research","prompt":"I'm researching hospital pricing in the Northeast — can you find the machine-readable price file URLs for brighamandwomens.org and what format those files are in?"},{"title":"Automated MRF URL classification","prompt":"I already have this MRF URL from a hospital and want to classify its file format directly: https://example-hospital.org/prices/mrf-2024.json.gz — can you tell me what type of file it is?"}],"resultDescription":"A list of hospital locations, each with: the location name, the source page where the MRF link was found, the direct URL to the machine-readable file (MRF), and the detected file format (e.g. JSON, CSV, JSON.gz).","failureModes":["Hospital domain does not publish a cms-hpt.txt file — returns empty or error","cms-hpt.txt exists but links are malformed or inaccessible","Non-US or non-hospital domain provided — no meaningful results","Provided mrf_url is unreachable or has an unrecognized format","Domain resolves but hospital site blocks crawling or returns 403/404"],"whenToPreferThis":"Use this endpoint when you need to programmatically locate CMS-mandated hospital price transparency files from a hospital's domain without manually browsing the hospital's website. It is specifically designed for the US hospital price transparency regulatory framework (cms-hpt.txt standard) and handles format detection automatically. Prefer this over general web scraping when you need structured MRF metadata across one or multiple hospital systems.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:11:13.087Z","isFirstParty":false}