AthenaDS Solutions
AI & API

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

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.

CallWhat it returns
GET /api/v1/prices?q=knee+replacement&state=TXPayment figures matching a service, hospital, city or state
GET /api/v1/compare?code=470&state=TXLow, median, high and quartiles for one service
GET /api/v1/servicesEvery service group with national figures
GET /api/v1/hospitals?q=baylor&state=TXHospitals by name, city or state
GET /api/v1/hospitals/{ccn}One hospital: profile, rating and figures
GET /api/v1/statsLive dataset counts and coverage
GET /api/v1/methodologyThe source, data year and how each figure is worked out
GET /api/v1/sourcesThe 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.