Humanitarian Data Exchange MCP Server

HDX MCP Server provides access to humanitarian data through the Humanitarian Data Exchange (HDX) API - https://data.humdata.org/hapi. This server offers 33 specialized tools for retrieving humanitarian information including affected populations (refugees, IDPs, returnees), baseline demographics, food security indicators, conflict data, funding information, and operational presence across hundreds of countries and territories. See repository for instructions on getting a free HDX_APP_INDENTIFIER for access.

223

29 Tools

Signed

Built by Docker

Requires Secrets

Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Overview Tools (29)Config Manual installation

Docker Hub⁠Github repository⁠

Tools

Name Description

coordination_funding_get OCHA's funding data from the Financial Tracking Service provides information on humanitarian aid contributions. See the more detailed technical <a href="https://hdx-hapi.readthedocs.io/en/latest/data_usage_guides/coordination_and_context/#funding">HDX HAPI documentation</a>, and the <a href="https://fts.unocha.org/home/2024/donors/view">original FTS source</a> website. **Query Parameters:** - **app_identifier** (Required): base64 encoded application name and email, as in `base64("app_name:email")`. This value can also be passed in the `X-HDX-HAPI-APP-IDENTIFIER` header. See the *encoded_app_identifier* endpoint. - **appeal_code**: Filter the response by a unique code given by FTS to each appeal - **appeal_type**: Filter the respinse by the type of the appeal, such as flash or HRP - **location_code**: Filter the response by a location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes. Use the metadata_location_get tool to get available location codes and names. - **location_name**: Filter the response by a location (typically a country). The location names are based on the "short name" from the <a href="https://unstats.un.org/unsd/methodology/m49/#fn2">UN M49 Standard</a>. Use the metadata_location_get tool to get available location codes and names. - **has_hrp**: Filter the response by the has_hrp flag. The has_hrp flag indicates whether a country has a Humanitarian Response Plan. - **in_gho**: Filter the response by the in_gho flag. The in_gho flag indicates whether a country is in the <a href="https://humanitarianaction.info/">Global Humanitarian Overview</a>. - **start_date**: Filter entries to include rows where the reference period overlaps with or extends beyond this date, e.g. 2020, 2020-01, 2020-01-01 or 2020-01-01T00:00:00 - **end_date**: Filter entries to include rows where the reference period overlaps with or begins prior to this date, e.g. 2020, 2020-01, 2020-01-01, 2020-01-01 or 2020-01-01T23:59:59 - **output_format**: No description. - **limit**: Maximum number of records to return. The system will not return more than 10,000 records. - **offset**: Number of records to skip in the response. Use in conjunction with the limit parameter to paginate. **Responses:** - **200** (Success): Successful Response - Content-Type: `application/json` - **Response Properties:** - **Example:** ```json { "data": [ { "resource_hdx_id": "string", "appeal_code": "string", "appeal_name": "string", "funding_usd": 1.5, "appeal_type": "unknown_type", "reference_period_end": "unknown_type", "location_code": "string", "location_name": "string", "funding_pct": "unknown_type", "requirements_usd": "unknown_type", "reference_period_start": "2024-01-01T12:00:00Z" } ] } ``` - **400**: Bad Request - Content-Type: `application/json` - **Response Properties:** - **Example:** ```json { "detail": "string" } ``` - **422**: Validation Error - Content-Type: `application/json` - **Response Properties:** - **Example:** ```json { "detail": [ { "loc": [ "unknown_type" ], "msg": "string", "type": "string" } ] } ``` - **500**: Internal Server Error - Content-Type: `application/json` - **Response Properties:** - **Example:** ```json { "error_sample_list": [ "unknown" ], "error": "string" } ```

Name	Description
`coordination_funding_get`	OCHA's funding data from the Financial Tracking Service provides information on humanitarian aid contributions. See the more detailed technical <a href="https://hdx-hapi.readthedocs.io/en/latest/data_usage_guides/coordination_and_context/#funding">HDX HAPI documentation</a>, and the <a href="https://fts.unocha.org/home/2024/donors/view">original FTS source</a> website. Query Parameters: - app_identifier (Required): base64 encoded application name and email, as in `base64("app_name:email")`. This value can also be passed in the `X-HDX-HAPI-APP-IDENTIFIER` header. See the encoded_app_identifier endpoint. - appeal_code: Filter the response by a unique code given by FTS to each appeal - appeal_type: Filter the respinse by the type of the appeal, such as flash or HRP - location_code: Filter the response by a location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes. Use the metadata_location_get tool to get available location codes and names. - location_name: Filter the response by a location (typically a country). The location names are based on the "short name" from the <a href="https://unstats.un.org/unsd/methodology/m49/#fn2">UN M49 Standard</a>. Use the metadata_location_get tool to get available location codes and names. - has_hrp: Filter the response by the has_hrp flag. The has_hrp flag indicates whether a country has a Humanitarian Response Plan. - in_gho: Filter the response by the in_gho flag. The in_gho flag indicates whether a country is in the <a href="https://humanitarianaction.info/">Global Humanitarian Overview</a>. - start_date: Filter entries to include rows where the reference period overlaps with or extends beyond this date, e.g. 2020, 2020-01, 2020-01-01 or 2020-01-01T00:00:00 - end_date: Filter entries to include rows where the reference period overlaps with or begins prior to this date, e.g. 2020, 2020-01, 2020-01-01, 2020-01-01 or 2020-01-01T23:59:59 - output_format: No description. - limit: Maximum number of records to return. The system will not return more than 10,000 records. - offset: Number of records to skip in the response. Use in conjunction with the limit parameter to paginate. Responses: - 200 (Success): Successful Response - Content-Type: `application/json` - Response Properties: - Example: ```json { "data": [ { "resource_hdx_id": "string", "appeal_code": "string", "appeal_name": "string", "funding_usd": 1.5, "appeal_type": "unknown_type", "reference_period_end": "unknown_type", "location_code": "string", "location_name": "string", "funding_pct": "unknown_type", "requirements_usd": "unknown_type", "reference_period_start": "2024-01-01T12:00:00Z" } ] } ``` - 400: Bad Request - Content-Type: `application/json` - Response Properties: - Example: ```json { "detail": "string" } ``` - 422: Validation Error - Content-Type: `application/json` - Response Properties: - Example: ```json { "detail": [ { "loc": [ "unknown_type" ], "msg": "string", "type": "string" } ] } ``` - 500: Internal Server Error - Content-Type: `application/json` - Response Properties: - Example: ```json { "error_sample_list": [ "unknown" ], "error": "string" } ```

Manual installation

You can install the MCP server using:

Installation for

Humanitarian Data Exchange MCP Server

Related servers

Elasticsearch

ArXiv MCP Server

Brave Search

EverArt (Archived)