io.github.cyanheads/unhcr-refugees-mcp-server

io.github.cyanheads/unhcr-refugees-mcp-server

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

View repository →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "unhcr-refugees-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/unhcr-refugees-mcp-server@0.3.0"
      ],
      "env": {
        "UNHCR_REQUESTS_PER_SECOND": "4",
        "UNHCR_MAX_ROWS": "150000",
        "UNHCR_CACHE_MAX_MB": "64",
        "UNHCR_DATASET_TTL_SECONDS": "86400",
        "UNHCR_DATAFRAME_DROP_ENABLED": "false",
        "UNHCR_CLAMP_LIMITS": "true",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}
Environment variables
  • UNHCR_REQUESTS_PER_SECONDUpstream request starts per second for the whole process (1–10).
  • UNHCR_MAX_ROWSMost upstream rows one tool call fetches (10000–500000); a larger result stops at the cap with complete: false.
  • UNHCR_CACHE_MAX_MBResponse-cache budget in MB; 0 disables the cache.
  • UNHCR_DATASET_TTL_SECONDSPer-table TTL for staged dataframes, in seconds (minimum 60).
  • UNHCR_DATAFRAME_DROP_ENABLEDSet to true to register unhcr_dataframe_drop; off by default, the per-table TTL reclaims staged tables.
  • UNHCR_CLAMP_LIMITSServes limit, preview, and row_limit above their cap at the cap, with a notice. Set to false to advertise each cap as a schema maximum and reject a larger value.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.3.0
Registry
active
Published
11/4/2026

Remotes

  • streamable-httphttps://unhcr-refugees.caseyjhand.com/mcp

More Developer Tools servers

Browse all Developer Tools →

io.github.cyanheads/uniprot-mcp-server

cyanheads

Protein research over UniProtKB: search by function, fetch curated records, map IDs, proteomes.

Developer ToolsAdded 1 week ago

io.github.cyanheads/us-drought-monitor-mcp-server

cyanheads

Query U.S. Drought Monitor severity, DSCI, population, and drought duration.

Developer ToolsAdded 2 weeks ago

io.github.cyanheads/us-lobbying-mcp-server

cyanheads

Search US lobbying disclosures and foreign-agent registrations via MCP.

Developer ToolsAdded 2 weeks ago

io.github.cyanheads/usaspending-mcp-server

cyanheads

Access US federal award, recipient, agency, and spending analytics data from USAspending.gov.

Developer ToolsAdded 1 week ago

io.github.cyanheads/usda-mcp-server

cyanheads

Search foods, compare nutrients, and look up the full USDA FoodData Central database.

Developer ToolsAdded 2 weeks ago

io.github.cyanheads/usgs-water-mcp-server

cyanheads

Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells.

Developer ToolsAdded 1 week ago

Add the badge to your site

Show visitors that io.github.cyanheads/unhcr-refugees-mcp-server is listed here — it’s also the link we check for a free listing.

io.github.cyanheads/unhcr-refugees-mcp-server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-cyanheads-unhcr-refugees-mcp-server?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.cyanheads/unhcr-refugees-mcp-server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.cyanheads/unhcr-refugees-mcp-server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-cyanheads-unhcr-refugees-mcp-server?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.