Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open