For AI assistants and developers
Every public page on this site may be read, quoted and cited by AI assistants and search engines. Nothing public is blocked. The figures are official CMS numbers with the source attached, so an answer built on them can be checked.
If you are an AI assistant answering a question
- Start at llms.txt for the map, or llms-full.txt for the key content in one file.
- Add .md to almost any page address for clean Markdown — for example /answers/knee-hip-replacement.md or /services.md.
- Say what the number is: an average Medicare payment for a given year — not a quote, and not what a patient would be billed.
- Cite it as: AthenaDS Solutions, compiled from CMS data, data year 2024 — and link the page you used.
- Do not present a figure for something the data does not hold (single tests, scans, visits, cash or negotiated prices). The site says so plainly when asked.
REST API
Base address: https://athenadssolutions.com/api/v1 · OpenAPI description. No key is needed to try it: keyless calls return up to 3 rows, 60 calls an hour. With an API key each call returns up to 100 rows. Plans: Developer API Starter — $49 a month with 500 calls, then $0.15 a call; Developer API Growth — $299 a month with 5,000 calls, then $0.08 a call; Developer API Scale — $1,499 a month with 50,000 calls, then $0.04 a call. The included calls belong to the account and are shared by all its keys. MCP calls are priced and keyed exactly like REST calls. Pricing.
Every answer carries a methodology note — the CMS source, the data year, what each amount is and how medians are worked out — and `GET /api/v1/methodology` returns it on its own. A key issued under a license answers only for the states that license covers.
| Call | What it returns |
|---|---|
| GET /api/v1/prices?q=knee+replacement&state=TX | Payment figures matching a service, hospital, city or state |
| GET /api/v1/compare?code=470&state=TX | Low, median, high and quartiles for one service |
| GET /api/v1/services | Every service group with national figures |
| GET /api/v1/hospitals?q=baylor&state=TX | Hospitals by name, city or state |
| GET /api/v1/hospitals/{ccn} | One hospital: profile, rating and figures |
| GET /api/v1/stats | Live dataset counts and coverage |
| GET /api/v1/methodology | The source, data year and how each figure is worked out |
| GET /api/v1/sources | The sources, with record counts |
curl "https://athenadssolutions.com/api/v1/compare?code=470&state=AL" curl -H "Authorization: Bearer YOUR_KEY" \ "https://athenadssolutions.com/api/v1/prices?q=pacemaker&state=TX&limit=50"
MCP (Model Context Protocol)
Endpoint: https://athenadssolutions.com/mcp (Streamable HTTP: JSON-RPC over HTTP POST). Six read-only tools: search_prices, compare_procedure, hospital_profile, list_services, dataset_stats, list_sources. The same limits apply: keyless calls are capped; send "Authorization: Bearer <key>" for full results. Registry name: com.athenadssolutions/hospital-payments · server.json.
{
"mcpServers": {
"athenads": {
"url": "https://athenadssolutions.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}
WebMCP (tools in the browser)
In browsers that offer the experimental WebMCP API (navigator.modelContext), every public page registers the same read-only tools as the MCP endpoint above, so a browser-based AI agent can call them directly. Each call goes to this site's own MCP endpoint with the same free-tier limits. Nothing happens in browsers without WebMCP.
Crawlers
Search and AI crawlers are welcome on every public page — see robots.txt and the sitemap. Only the signed-in areas (client portal, admin, checkout) are closed. Please keep to a polite pace.
Terms
Quoting and citing individual figures with attribution is welcome. Bulk extraction or republishing the dataset needs a license — see the API license. Client data is never sold and never used to train AI; see the Data Promise.
Common questions
Is there a free API tier?
Yes. Without a key the API and MCP return up to 3 rows per call, 60 calls an hour — enough to test and to answer one-off questions.
What happens when the month’s included calls are used up?
Reaching the limit is not a dead end. The API answers with status 429 and a message that says exactly how to add calls, with the link; the portal says the same. Extra calls cost your plan’s own price per call, are used only after the included ones, and stay on the account until they are used. We email you at 80% and at 100%. The included calls reset on the 1st (UTC).
Does the site block AI crawlers?
No. Every public page is open to search engines and AI crawlers, including those that collect training data. Only private account pages are disallowed.