Skip to content

Claude Desktop unhcr refugees mcp server unhcr_dataframe_query

How to: Claude Desktop unhcr refugees mcp server unhcr_dataframe_query

client:Claude Desktop transport:streamable-http tool:unhcr_dataframe_query

Add unhcr refugees mcp server to Claude Desktop

  1. 01

    Open ~/Library/Application Support/Claude/claude_desktop_config.json and merge this in. Keep any servers already there.

{
  "mcpServers": {
    "unhcr-refugees-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://unhcr-refugees.caseyjhand.com/mcp"
      ]
    }
  }
}
  1. 02

    Save the file and restart Claude Desktop.

  2. 03

    Ask for something unhcr_dataframe_query does. Claude Desktop lists the server's tools on connect and calls unhcr_dataframe_query itself — you do not invoke it by name.

  3. 04

    If nothing happens, check the server is running and that unhcr refugees mcp server's identifier in your config matches the one above exactly.

Claude Desktop has no remote transport in its config file, so this bridges through mcp-remote. Restart the app after saving. Claude Desktop docs

Set these first

unhcr refugees mcp server will not start until these are set, so unhcr_dataframe_query never becomes available.

  • UNHCR_REQUESTS_PER_SECOND
  • UNHCR_MAX_ROWS
  • UNHCR_CACHE_MAX_MB
  • UNHCR_DATASET_TTL_SECONDS
  • UNHCR_DATAFRAME_DROP_ENABLED
  • MCP_LOG_LEVEL

Same tool, other clients

This list was read from the server itself, by connecting to it and calling tools/list on 4 October 2026. It is what the server actually exposes, not what its listing claims.

Mutating and Read-only are read off each tool's name, not its schema — a hint, not a guarantee. The registry stores tool names only; connect the server for its live schemas.