hdx 4 tools

MCP server exposing 4 tools for hdx.

Endpoint

This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.

POST https://gateway.pipeworx.io/hdx/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

search_datasets — 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:<iso3>" (e.g. "groups:syr") — get codes from list_locations.
dataset_details — Full dataset record by id or slug (CKAN package_show), including its resources. Each resource has a "download_url"/"url" pointing at the actual data file (usually CSV/XLSX) — that is how you read the underlying rows, since HDX does not expose a keyless row query.
list_locations — List the locations on HDX (CKAN group_list) — countries and crises, each keyed by a lowercase ISO3 code (e.g. {"name":"syr","display_name":"Syrian Arab Republic"}). Use a code as fq="groups:<name>" in search_datasets to scope results to a country/crisis.
list_organizations — List the publishing organizations on HDX (CKAN organization_list) — UN agencies and NGOs such as OCHA, UNHCR, WFP, IDMC, ACAPS. Use an org "name" as fq="organization:<name>" in search_datasets.

Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/hdx/

Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io