Skip to directory

About cdc-health-mcp-server

MCP server for discovering and querying CDC public health datasets via the Socrata SODA API, providing access to ~1,487 datasets across disease surveillance, mortality, vaccinations, and behavioral risk factors.

What you can use it for

  • other
Connection and setup
Hosting
Local stdio process
Transport
stdio
Endpoint
Local process; no hosted endpoint documented
Authentication
No credentials were configured; the tested read-only tool “cdc_list_catalog_vocabulary” succeeded in an isolated environment. Other tools may have additional requirements.

Requirements

  • Node.js 18+
  • The npm package repository matched the repository linked from the public profile.

Setup steps

  1. npx -y @cyanheads/cdc-health-mcp-server@0.10.0
Tools 5+

The server returned 5 tools in tools/list. Only “cdc_list_catalog_vocabulary” was invoked with a synthetic read-only input and succeeded.

  • cdc_discover_datasets

    Search the CDC dataset catalog by keyword, category, or tag. Returns IDs, names, truncated descriptions, asset types, column counts, and update timestamps. The catalog also holds charts, maps, stories, files, and links; an entry whose columnCount is 0 is one of those and yields no data from the other tools. Use cdc_get_dataset_schema for the full column list of a chosen dataset.

    Parameters: domain, query, category, tags, limit, offset, order
    01
  • cdc_get_dataset_schema

    Fetch the column schema for a CDC dataset — names, data types, descriptions, row count, and last-updated timestamp. Returns the first 100 columns by default; wide datasets continue via column_offset. The dataset description is capped at 4,000 characters by default; pass full_description: true for the whole text. Get dataset IDs from cdc_discover_datasets.

    Parameters: domain, datasetId, column_limit, column_offset, full_description
    02
  • cdc_list_catalog_vocabulary

    List the controlled vocabularies cdc_discover_datasets' category and tags filters are matched against — every domain category and domain tag the CDC catalog publishes, each with the number of entries carrying it. Call it before filtering a search: a value the catalog does not carry matches nothing and returns an empty page, which is indistinguishable from a real value with no results. All categories come back whole; the tag vocabulary runs to roughly 1,600 values, so tags are ranked by entry count and returned one page at a time via tag_limit and tag_offset. Pass filter to narrow both vocabularies to the values whose words contain it.

    Parameters: domain, filter, tag_limit, tag_offset
    03
  • cdc_query_dataset

    Execute a SoQL query against any CDC dataset. Supports filtering, aggregation, sorting, full-text search, and field selection. Use cdc_discover_datasets to find dataset IDs and cdc_get_dataset_schema to inspect columns before querying.

    Parameters: domain, datasetId, search, select, where, group, having, order, limit, offset
    04
  • cdc_query_wonder

    Query CDC WONDER for national US mortality statistics — deaths, population, and crude/age-adjusted death rates — across its five mortality databases, selected with the database input: final underlying-cause data for 1999–2020 (the default) or 2018–2024, provisional data running from 2018 through the current year, and two multiple-cause databases covering the same two eras. Break results out by year, age group, sex, and/or race, and filter by ICD-10 cause of death, sex, age group, or year range; on a multiple-cause database, mcd_icd10 additionally matches a cause listed anywhere on the death certificate rather than only the one certified as underlying. Each database holds a different span of years (1999–2026 across all of them) and a request whose year_range falls outside the selected one's span is rejected with that span named. WONDER is a separate CDC system from the Socrata datasets the other cdc_* tools query. Data is national only — sub-national (state/county) breakdowns are not av

    Parameters: database, group_by, cause_icd10, mcd_icd10, sex, age_groups, year_range, limit, offset
    05

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

Limitations and notes
  • Runtime verification covered one read-only tool call (cdc_list_catalog_vocabulary); other listed tools were not individually exercised.
Original sources

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.

Similar tools