cdc-health-mcp-server

---

Tools

Three tools for discovering and querying CDC public health data:

Tool	Description
cdc_discover_datasets	Search the catalog by keyword, category, or tag. Entry point for all queries.
cdc_get_dataset_schema	Fetch column schema, row count, and metadata for a dataset. Essential before writing SoQL queries.
cdc_query_dataset	Execute SoQL queries — filter, aggregate, sort, full-text search, and field selection.

cdc_discover_datasets

Search the CDC dataset catalog to find relevant datasets.

• Full-text search across dataset names and descriptions
• Filter by domain category (e.g., "NNDSS", "Vaccinations", "Behavioral Risk Factors")
• Filter by domain tags (e.g., ["covid19", "surveillance"])
• Returns dataset IDs, names, descriptions, column lists, and update timestamps
• Pagination via offset for browsing large result sets

---

cdc_get_dataset_schema

Fetch the full column schema for a specific dataset.

• Column names, data types, and descriptions
• Row count and last-updated timestamp
• Essential for understanding column types before writing $where clauses
• Accepts four-by-four dataset identifiers (e.g., bi63-dtpu)

---

cdc_query_dataset

Execute SoQL queries against any CDC dataset.

• Full SoQL support: $select, $where, $group, $having, $order
• Full-text search across all text columns via $q
• Up to 5,000 rows per request with pagination
• Returns the assembled SoQL query string for debugging
• All response values are strings (per SODA v2.1) — parse based on column type metadata

Resources and prompt

Type	Name	Description
Resource	cdc://datasets	Top 50 datasets by popularity for orientation
Resource	cdc://datasets/{datasetId}	Dataset metadata and column schema (equivalent to schema tool)
Prompt	analyze_health_trend	Guided 5-step workflow: discover, inspect, baseline query, compare, synthesize

Features

Built on @cyanheads/mcp-ts-core:

• Declarative tool definitions — single file per tool, framework handles registration and validation
• Unified error handling across all tools
• Pluggable auth (none, jwt, oauth)
• Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
• Structured logging with optional OpenTelemetry tracing
• Runs locally (stdio/HTTP) or on Cloudflare Workers from the same codebase

CDC-specific: