Log inSubmit server
Cdc Health MCP Server logo

Cdc Health MCP Server

Discover CDC datasets, inspect schemas, run SoQL queries, and retrieve national mortality statistics through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cdc Health MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "cdc-health-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/cdc-health-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

cdc-health-mcp-server connects MCP clients to the CDC Open Data catalog, Socrata SODA queries, and CDC WONDER mortality databases. Its five tools support dataset discovery, schema inspection, catalog vocabulary lookup, SoQL filtering and aggregation, and national mortality analysis. Resources expose popular catalog entries and dataset metadata, while a guided prompt supports public-health trend investigations. Use it when an agent needs structured access to CDC vaccination, surveillance, behavioral-risk, population, or mortality data.

Use cases

  • Discover CDC vaccination and surveillance datasets by catalog metadata
  • Inspect dataset schemas before constructing an analysis query
  • Run SoQL aggregations over CDC public-health tables
  • Compare national mortality rates across demographic or cause dimensions
  • Investigate public-health trends with the guided analysis prompt

Key features

  • CDC catalog search with keyword, category, tag, and asset filters
  • Socrata schema inspection and paged metadata retrieval
  • SoQL filtering, grouping, aggregation, sorting, and full-text search
  • CDC WONDER mortality queries across five databases
  • Catalog resources, trend-analysis prompt, and health-data guidance skill
  • STDIO and Streamable HTTP transports

Tools5

What Cdc Health MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~117 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

8/8 checks healthy over the last 47d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @cyanheads/cdc-health-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed5Callable tools this server registers over MCP.

How Cdc Health MCP Server works

What cdc-health-mcp-server does

cdc-health-mcp-server makes CDC public-health data available through the Model Context Protocol. It covers the CDC Open Data catalog and CDC WONDER, with particular use for finding datasets, understanding their columns, querying tabular data, and examining national mortality statistics.

The catalog tools can search by keyword, category, tag, or asset type; inspect a dataset's metadata and schema; and enumerate catalog categories and tags with entry counts. Queryable Socrata datasets can be filtered, grouped, sorted, aggregated, selected by field, or searched with full-text criteria. The WONDER tool handles national mortality, population, and death-rate queries across five CDC databases.

Two MCP resources provide either the 50 most-viewed catalog entries or metadata and initial columns for a specified dataset. An analyze_health_trend prompt offers a guided workflow for investigating a public-health question. The package also includes the cdc-health-guide skill, which provides guidance for comparing rates, interpreting race and Hispanic-origin dimensions, working with provisional data, and handling stratified Socrata tables.

How it works

The server can run over STDIO or Streamable HTTP. A hosted endpoint is available at https://cdc.caseyjhand.com/mcp; local installations can use the npm package, Docker image, or MCP bundle.

Catalog discovery returns asset type, permalink, column information, descriptions, counts, and applied filters. Dataset schemas include field names, data types, descriptions, row counts, and selected publisher metadata. Queries return the effective SoQL clauses and paging details. Dataset results are limited to 1,000 rows per call, while WONDER requests can return up to 10,000 rows and reject groupings that could exceed that size.

WONDER queries are always national and can group by dimensions such as year, month, age group, sex, race, Hispanic origin, ICD chapter or subchapter, cause, and injury intent. Available databases cover underlying and multiple causes of death from 1999–2020, single-race datasets from 2018–2024, and provisional statistics beginning in 2018. The provisional database can include a partial latest year.

Setup and configuration

Install the npm package through an MCP client using the package's npx installation flow, or deploy the published Docker image. The repository also distributes an MCP bundle for clients that support bundle-based installation. Direct installation links are provided for Claude Desktop, Cursor, and VS Code.

For remote use, configure an MCP client with the hosted Streamable HTTP endpoint. For local use, select the STDIO transport and launch the package through the client. The server is implemented in TypeScript and uses the MCP SDK; its published runtime materials also include the packaged skill.

Tools and capabilities

  • cdc_discover_datasets: search the catalog with keyword, category, tag, and asset-type filters.
  • cdc_get_dataset_schema: retrieve columns, row count, descriptions, and dataset metadata.
  • cdc_list_catalog_vocabulary: list categories and ranked tags with dataset counts.
  • cdc_query_dataset: issue SoQL selections, filters, grouping, sorting, aggregation, having clauses, and full-text searches.
  • cdc_query_wonder: query five CDC WONDER databases for national mortality and related rates.

Dataset IDs use Socrata's four-by-four format. Schema columns and query results support paging. Stable offset paging for dataset queries requires an order ending with a unique tie-breaker, such as :id for ungrouped rows. WONDER supports ICD-10 codes, ranges, and lists, with database-specific race group definitions.

Limitations and notes

Catalog charts, maps, and other non-tabular assets are not directly queryable; responses identify the underlying dataset where applicable. Catalog search pagination has a 10,000-entry boundary, and dataset query responses do not include a total count. WONDER results are national rather than geographic subdivisions, and race series from bridged-race and single-race database families should not be compared directly. The latest provisional year may be incomplete, and some causes can be withheld.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cdc Health MCP Server

cdc-health-mcp-server is an MCP server that connects AI clients to the CDC Open Data catalog, Socrata SODA datasets, and CDC WONDER. Its main tools discover datasets, inspect schemas, list catalog vocabulary, run SoQL queries, and retrieve national mortality, population, and death-rate statistics.

Install it through an MCP client with the npm package, or deploy its Docker image or MCP bundle. Direct installation links are available for Claude Desktop, Cursor, and VS Code, and local operation supports the STDIO transport.

Yes, cdc-health-mcp-server provides a Cursor installation link. Cursor can connect to the server through its local npm-based MCP configuration, while remote clients can use the hosted Streamable HTTP endpoint.

Yes, the `cdc_query_wonder` tool queries five CDC WONDER databases for national mortality, population, and death rates. Queries can group results by time, demographics, and cause-related dimensions, and can accept ICD-10 codes, ranges, or lists.

CDC Open Data queries use SoQL through the `cdc_query_dataset` tool. The tool supports field selection, filtering, grouping, having clauses, sorting, aggregation, full-text search, and paged results.

Related MCP servers

All in Biology & Bioinformatics All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCdc Health MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/cdc-health-mcp-server?style=directory)](https://allmcps.com/mcp/cdc-health-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/cdc-health-mcp-server"><img src="https://allmcps.com/api/badge/cdc-health-mcp-server?style=directory" alt="Cdc Health MCP Server on AllMCPs" /></a>