Skip to content
Eden Engine

CDC COVID-19 Weekly Cases and Deaths by State

cdcdata/covid-cases-deaths-by-state

Weekly COVID-19 case and death counts per US state or jurisdiction from the CDC: for each reporting week, the cumulative total and the new cases and new deaths, plus new historic cases and deaths. Optionally filter to one state code (for example AZ, LA, GA). Historical data: the CDC dataset behind it was last updated in 2023. Rows are passed through unmodified, with every number as a string. Source: CDC. Served by Eden Engine; not an official CDC 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

Centers for Disease Control and Prevention

Source: CDC (Centers for Disease Control and Prevention), data.cdc.gov. U.S. federal government work, public domain per cdc.gov/other/agencymaterials.html; passed through unmodified. This material is also published on cdc.gov. CDC does not endorse this service. Served by Eden Engine; not an official CDC 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: "cdcdata/covid-cases-deaths-by-state" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "cdcdata/covid-cases-deaths-by-state" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "cdcdata/covid-cases-deaths-by-state", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "cdcdata/covid-cases-deaths-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": 200,
      "minimum": 1,
      "description": "How many weekly rows to return, 1 to 200. Required."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Z]{2,3}$",
      "description": "Jurisdiction code in upper case exactly as the dataset writes it, for example AZ, LA or GA. Case-sensitive, exact match."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Rows to skip. Rows come in the dataset's own order, which is not sorted by date and which this tool does not sort, so narrow with the state filter rather than paging deep."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "state": {
            "type": "string",
            "description": "Jurisdiction code."
          },
          "end_date": {
            "type": "string",
            "description": "Last day of the reporting week."
          },
          "new_cases": {
            "type": "string",
            "description": "New cases in the week, as a string."
          },
          "tot_cases": {
            "type": "string",
            "description": "Cumulative cases, as a string."
          },
          "new_deaths": {
            "type": "string",
            "description": "New deaths in the week, as a string."
          },
          "start_date": {
            "type": "string",
            "description": "First day of the reporting week."
          },
          "tot_deaths": {
            "type": "string",
            "description": "Cumulative deaths, as a string."
          },
          "date_updated": {
            "type": "string",
            "description": "When the row was updated."
          },
          "new_historic_cases": {
            "type": "string"
          },
          "new_historic_deaths": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "description": "The matching weekly rows under `results`; an empty list when nothing matches the filter.",
  "additionalProperties": true
}