search_datasets
Pack: cdc · Endpoint: https://gateway.pipeworx.io/cdc/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_datasets for the schema, then POST the same URL with its arguments for the data.
Search CDC public health datasets by keyword. Returns dataset names, descriptions, IDs, and update dates. Example: search_datasets(“influenza surveillance”).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Search keywords (e.g., “covid cases”, “influenza”, “vaccination rates”, “mortality”) |
Example call
Arguments
{
"query": "covid cases"
}
curl
curl -X POST https://gateway.pipeworx.io/cdc/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_datasets","arguments":{"query":"covid cases"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('search_datasets', {
"query": "covid cases"
});
More examples
{
"query": "influenza surveillance"
}
Response shape
Always returns: count, datasets
| Field | Type | Description |
|---|---|---|
count | number | Number of datasets returned |
datasets | array |
Full JSON Schema
{
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "Number of datasets returned"
},
"datasets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Socrata dataset ID"
},
"name": {
"type": [
"string",
"null"
],
"description": "Dataset name"
},
"description": {
"type": [
"string",
"null"
],
"description": "Dataset description (truncated to 300 chars)"
},
"category": {
"type": [
"string",
"null"
],
"description": "Dataset category"
},
"modified_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601 timestamp of last modification"
},
"columns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Column names (up to 15)"
}
},
"required": [
"id",
"name",
"description",
"category",
"modified_at",
"columns"
]
}
}
},
"required": [
"count",
"datasets"
]
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"cdc": {
"url": "https://gateway.pipeworx.io/cdc/mcp"
}
}
}
See Getting Started for client-specific install steps.