Humanitarian Data Exchange — Claude Code MCP server for HDX data
This MCP server connects an AI assistant to the Humanitarian Data Exchange API for querying humanitarian information by country and region.
no license updated 2026-10-29
Open on GitHubWhat Humanitarian Data Exchange does
The server can retrieve information on refugees, internally displaced people and humanitarian needs, along with population, rainfall, food security, prices, funding and conflict events. Its listing describes 33 tools for HDX API queries, location searches and dataset lookups.
A free HDX application identifier is required and must be set as HDX_APP_IDENTIFIER. You can run the server with Docker or UV; the UV route requires UV and a cloned repository. Data coverage varies by country and region. For example, conflict-event data for Afghanistan is available at province and district level, so a country-wide total may require unreliable aggregation.
What it helps with
- find refugee and internally displaced people data
- check HDX data coverage for a country
- retrieve humanitarian needs information
- compare funding and operational presence data
- look up food security and price indicators
Example prompts for the agent
- Find HDX data on refugees in Sudan.
- Check which HDX data is available for Afghanistan at district level.
- Compare humanitarian needs and funding information for Mali.
How to install Humanitarian Data Exchange
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Humanitarian Data Exchange
How do I install Humanitarian Data Exchange for Claude Code?
First obtain an HDX application identifier from the API page. For the UV setup, install UV, clone dividor/hdx-mcp, enter the project directory, run uv sync --all-extras --dev, copy env.example to .env, set HDX_APP_IDENTIFIER, then start uv run hdx-mcp-server --transport http --host 0.0.0.0 --port 8000 --verbose.
What does Humanitarian Data Exchange do?
It gives an AI assistant MCP access to HDX information, including data on displaced people, population, funding and food security.
Does HDX provide the same data coverage for every country?
No. Coverage varies by location. For Afghanistan, conflict events are available at province and district level, so producing a national total may require difficult aggregation.