# US Hospital Price Transparency File Discoverer

> US Hospital Price Transparency File Discoverer is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://api.agentstools.dev/price/discover
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-hospital-price-transparency-file-discoverer-6d81f9ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SwCBBU9x6d1R8vPHs0CYK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-hospital-price-transparency-file-discoverer-6d81f9ff
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-hospital-price-transparency-file-discoverer-6d81f9ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)