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:

• Wraps the Socrata SODA API v2.1 — no auth required, optional

... View full README on GitHub