US Influenza-Like-Illness Activity by Region and Epiweek (CDC ILINet via Delphi)
delphiepidata/fluview-ili
Influenza-like-illness (ILI) activity in the United States for one or more regions (the national aggregate, HHS regions, the nine US divisions, states) and an epiweek or a range of epiweeks, from the CDC's ILINet outpatient surveillance as published by the Delphi research group at Carnegie Mellon University: the number of ILI visits, patients and reporting providers, counts by age group, and the ILI percentage (weighted and unweighted). Each row says which weekly release (issue) it comes from, because the numbers are revised after first publication. Takes up to ten comma-separated region codes and one epiweek (YYYYWW) or one range (YYYYWW-YYYYWW); a long range for many regions returns many rows. Returns a VALIDATION error when a parameter is malformed or the service has no results for the request. The Delphi legacy API this runs on is being retired, so availability is not guaranteed. Delphi data passed through unmodified and served by Eden Engine; not an official Delphi or Carnegie Mellon product.
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
Delphi Research Group, Carnegie Mellon University
Data from the Delphi Epidata API (FluView, CDC ILINet influenza-like-illness surveillance), Delphi Research Group, Carnegie Mellon University. Please cite https://doi.org/10.1073/pnas.2111452118 and credit the original data source. Served by Eden Engine; not an official Delphi or Carnegie Mellon University 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.
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "delphiepidata/fluview-ili" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "delphiepidata/fluview-ili" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "delphiepidata/fluview-ili", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "delphiepidata/fluview-ili", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot 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.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 20, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"regions",
"epiweeks"
],
"properties": {
"regions": {
"type": "string",
"pattern": "^[a-z0-9_]{2,20}(,[a-z0-9_]{2,20}){0,9}$",
"description": "One region code or up to ten separated by commas, lowercase, no spaces: nat (national), hhs1 to hhs10, cen1 to cen9, two-letter state codes such as ca or tx, dc, pr, and a few city codes (jfk, ny_minus_jfk)."
},
"epiweeks": {
"type": "string",
"pattern": "^[0-9]{6}(-[0-9]{6})?$",
"description": "One epiweek as YYYYWW, the year followed by the two-digit week of the epidemiological year (202401 is week 1 of 2024), or one range YYYYWW-YYYYWW such as 202401-202410."
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ili": {
"type": [
"number",
"null"
],
"description": "Unweighted ILI percentage."
},
"lag": {
"type": "integer",
"description": "Weeks between the epiweek and its issue."
},
"wili": {
"type": [
"number",
"null"
],
"description": "Weighted ILI percentage."
},
"issue": {
"type": "integer",
"description": "Epiweek (YYYYWW) of the release this row comes from."
},
"region": {
"type": "string",
"description": "The region code."
},
"epiweek": {
"type": "integer",
"description": "The epiweek the numbers describe (YYYYWW)."
},
"num_ili": {
"type": [
"integer",
"null"
],
"description": "Number of influenza-like-illness visits."
},
"num_age_0": {
"type": [
"integer",
"null"
],
"description": "ILI visits in the first age group."
},
"num_age_1": {
"type": [
"integer",
"null"
],
"description": "ILI visits in the second age group."
},
"num_age_2": {
"type": [
"integer",
"null"
],
"description": "ILI visits in the third age group; can be null."
},
"num_age_3": {
"type": [
"integer",
"null"
],
"description": "ILI visits in the fourth age group."
},
"num_age_4": {
"type": [
"integer",
"null"
],
"description": "ILI visits in the fifth age group."
},
"num_age_5": {
"type": [
"integer",
"null"
],
"description": "ILI visits in the sixth age group."
},
"num_patients": {
"type": [
"integer",
"null"
],
"description": "Number of patient visits."
},
"release_date": {
"type": "string",
"description": "Date this issue was released, YYYY-MM-DD."
},
"num_providers": {
"type": [
"integer",
"null"
],
"description": "Number of reporting providers."
}
},
"additionalProperties": true
},
"description": "One row per region and epiweek, from the latest release (issue) the service holds for it."
}
},
"description": "The ILINet rows for the requested regions and epiweeks.",
"additionalProperties": true
}