search_datasets
Pack: cdc · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
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 — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the cdc pack
{
"mcpServers": {
"cdc": {
"url": "https://gateway.pipeworx.io/cdc/mcp"
}
}
}
See Getting Started for client-specific install steps.