Unhcr-refugees-mcp-server MCP Server

Query UNHCR refugee, IDP, and stateless populations, asylum decisions, returns, and resettlement.

Local + remotestreamable-httpstdio

What is the Unhcr-refugees-mcp-server MCP Server?

Unhcr-refugees-mcp-server is an MCP integration. Query UNHCR refugee, IDP, and stateless populations, asylum decisions, returns, and resettlement.

Hosted connection

The registry lists a streamable-http connection at https://unhcr-refugees.caseyjhand.com/mcp.

Packages and local setup

The published npm package is @cyanheads/unhcr-refugees-mcp-server, version 0.1.2. Its declared MCP transport is stdio.

The package declares UNHCR_REQUESTS_PER_SECOND: Upstream request starts per second for the whole process (1–10).; UNHCR_MAX_ROWS: Most upstream rows one tool call fetches (10000–500000); a larger result stops at the cap with complete: false.; UNHCR_CACHE_MAX_MB: Response-cache budget in MB; 0 disables the cache.; UNHCR_DATASET_TTL_SECONDS: Per-table TTL for staged dataframes, in seconds (minimum 60).; UNHCR_DATAFRAME_DROP_ENABLED: Set to true to register unhcr_dataframe_drop; off by default, the per-table TTL reclaims staged tables.; MCP_LOG_LEVEL: Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')..

The published npm package is @cyanheads/unhcr-refugees-mcp-server, version 0.1.2. Its declared MCP transport is streamable-http.

The package declares MCP_TRANSPORT_TYPE: Selects the HTTP transport.; UNHCR_REQUESTS_PER_SECOND: Upstream request starts per second for the whole process (1–10). Every caller of a hosted instance shares it.; UNHCR_MAX_ROWS: Most upstream rows one tool call fetches (10000–500000); a larger result stops at the cap with complete: false.; UNHCR_CACHE_MAX_MB: Response-cache budget in MB; 0 disables the cache.; UNHCR_DATASET_TTL_SECONDS: Per-table TTL for staged dataframes, in seconds (minimum 60).; UNHCR_DATAFRAME_DROP_ENABLED: Set to true to register unhcr_dataframe_drop; off by default, the per-table TTL reclaims staged tables.; MCP_HTTP_HOST: The hostname for the HTTP server.; MCP_HTTP_PORT: The port to run the HTTP server on.; MCP_HTTP_ENDPOINT_PATH: The endpoint path for the MCP server.; MCP_AUTH_MODE: Authentication mode to use: 'none', 'jwt', or 'oauth'.; MCP_LOG_LEVEL: Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.1.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
UNHCR_REQUESTS_PER_SECONDUpstream request starts per second for the whole process (1–10).Optional
UNHCR_MAX_ROWSMost upstream rows one tool call fetches (10000–500000); a larger result stops at the cap with complete: false.Optional
UNHCR_CACHE_MAX_MBResponse-cache budget in MB; 0 disables the cache.Optional
UNHCR_DATASET_TTL_SECONDSPer-table TTL for staged dataframes, in seconds (minimum 60).Optional
UNHCR_DATAFRAME_DROP_ENABLEDSet to true to register unhcr_dataframe_drop; off by default, the per-table TTL reclaims staged tables.Optional
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').Optional