search_datasets

Pack: hdx · Endpoint: https://gateway.pipeworx.io/hdx/mcp

Search the Humanitarian Data Exchange catalogue (CKAN package_search) for datasets on displacement, refugees, food security, conflict, disasters, health, population, etc. Returns matching datasets with titles, descriptions, publishing organization, locations (groups), and resources. Filter by country/crisis with fq=“groups:” (e.g. “groups:syr”) — get codes from list_locations.

Parameters

NameTypeRequiredDescription
querystringyesSearch terms, e.g. “displacement”, “food security”, “conflict fatalities”.
fqstringnoSolr filter query (facet filter). e.g. “groups:syr” (location = Syria), “organization:unhcr”, “res_format:CSV”. Combine with spaces.
rowsnumbernoMax results, 1-1000 (default 25).
startnumberno0-based offset for paging.
sortstringnoSort spec, e.g. “metadata_modified desc” or “score desc”.

Example call

curl -X POST https://gateway.pipeworx.io/hdx/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_datasets","arguments":{}}}'

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "hdx": {
      "url": "https://gateway.pipeworx.io/hdx/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build June 2, 2026