`population`

Pack: unhcr · Endpoint: https://gateway.pipeworx.io/unhcr/mcp

Forcibly displaced & stateless persons by year and country: refugees, asylum_seekers, idps (internally displaced), returned_refugees, returned_idps, stateless, others. Filter by coo (country of origin) and/or coa (country of asylum). coo_all/coa_all=true breaks the totals DOWN by that dimension (one row per origin or asylum country). NOTE: coo/coa take UNHCR’s 3-letter code (e.g. Germany=‘GFR’, not ISO3 ‘DEU’) — resolve with list_countries first.

Parameters

Name	Type	Required	Description
`yearFrom`	integer	no	Start year, inclusive (data spans 1951+).
`yearTo`	integer	no	End year, inclusive.
`coo`	string	no	Country of ORIGIN — UNHCR 3-letter code (see list_countries.code).
`coa`	string	no	Country of ASYLUM — UNHCR 3-letter code (see list_countries.code).
`coo_all`	boolean	no	true = break results down per country of origin.
`coa_all`	boolean	no	true = break results down per country of asylum.
`limit`	integer	no	Rows per page (default 25).
`page`	integer	no	1-based page; response.maxPages tells you the total.

Example call

Arguments

{
  "yearFrom": 2019,
  "yearTo": 2023
}

curl

curl -X POST https://gateway.pipeworx.io/unhcr/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"population","arguments":{"yearFrom":2019,"yearTo":2023}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('population', {
  "yearFrom": 2019,
  "yearTo": 2023
});

More examples

{
  "yearFrom": 2020,
  "yearTo": 2023,
  "coo": "SYR",
  "coa": "TUR",
  "coa_all": true
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "unhcr": {
      "url": "https://gateway.pipeworx.io/unhcr/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

population