Skip to content
Eden Engine

State Hospital Bed Capacity and COVID-19 Occupancy, Daily Time Series (HHS)

healthdatagov/hospital-capacity-by-state

Daily hospital capacity by US state or territory from the U.S. Department of Health and Human Services COVID-19 reporting: total inpatient beds, inpatient beds in use, and inpatient beds in use by COVID-19 patients, newest date first. Filter by state and date range with a SoQL condition and choose how many rows to return. Counts are text strings as the source sends them. The dataset stopped updating after 3 May 2024, so it covers January 2020 to late April 2024, and no adjustment is made for hospitals that did not report. A filter that matches nothing returns an empty list. U.S. Department of Health and Human Services data, passed through unmodified and served by Eden Engine; not an official HHS product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

U.S. Department of Health and Human Services

Source: U.S. Department of Health and Human Services, HealthData.gov. A US federal government work (dataset licence USGOV_WORKS); credit is not legally required. Served by Eden Engine; not an official U.S. Department of Health and Human Services product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "healthdatagov/hospital-capacity-by-state" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "healthdatagov/hospital-capacity-by-state" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "healthdatagov/hospital-capacity-by-state", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "healthdatagov/hospital-capacity-by-state", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "limit"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "How many rows to return, 1 to 500. Rows come newest date first, so 7 with a state filter is that state's last seven reported days."
    },
    "where": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_ =<>!'().:-]{1,200}$",
      "description": "Optional SoQL filter. Columns: state (two-letter code, text), date (timestamp, compare against a quoted ISO date), inpatient_beds, inpatient_beds_used, inpatient_beds_used_covid (counts). Examples: state='AR' and date>'2021-01-01'; state='CA' and date between '2021-01-01' and '2021-03-31'. Leave out for the newest rows across all states."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "The report date as a timestamp with no UTC offset, e.g. 2024-04-27T00:00:00.000."
          },
          "state": {
            "type": "string",
            "description": "Two-letter US state or territory code."
          },
          "inpatient_beds": {
            "type": "string",
            "description": "Total inpatient beds reported, as a text number."
          },
          "inpatient_beds_used": {
            "type": "string",
            "description": "Inpatient beds in use, as a text number."
          },
          "inpatient_beds_used_covid": {
            "type": "string",
            "description": "Inpatient beds in use by COVID-19 patients, as a text number."
          }
        },
        "additionalProperties": true
      },
      "description": "One row per state and day, newest date first. Empty when the filter matches no row."
    }
  },
  "additionalProperties": true
}