World Population Prospects Location by Code (UN Population Division)

unpopulationdataportal/location-lookup

Looks up one to twenty locations of the United Nations World Population Prospects by code and returns each one's portal location id (the UN M49 numeric code), name, ISO alpha-3 and alpha-2 codes, longitude and latitude. Give the codes comma separated, all of one kind: M49 numbers (840,76), ISO alpha-3 (USA,BRA) or ISO alpha-2 (US,BR); mixing kinds is refused. Codes the portal does not know are left out of the answer, and when none is known the call is refused as a validation error. Data from the United Nations Department of Economic and Social Affairs, Population Division, passed through unmodified and served by Eden Engine; not an official United Nations product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

UN Department of Economic and Social Affairs, Population Division

Source: United Nations, Department of Economic and Social Affairs, Population Division. World Population Prospects (UN Population Data Portal, https://population.un.org/wpp/), licensed under Creative Commons license CC BY 3.0 IGO (https://creativecommons.org/licenses/by/3.0/igo/). Passed through unmodified. Served by Eden Engine; not an official United Nations product, and no endorsement by the United Nations is implied.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "unpopulationdataportal/location-lookup" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "unpopulationdataportal/location-lookup" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "unpopulationdataportal/location-lookup", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "unpopulationdataportal/location-lookup", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0026

Updated: Oct 21, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "codes"
  ],
  "properties": {
    "codes": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,3}(,[A-Za-z0-9]{1,3}){0,19}$",
      "description": "One to twenty location codes separated by commas, all of one kind: UN M49 numbers such as 840,76, ISO alpha-3 such as USA,BRA, or ISO alpha-2 such as US,BR."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The Data Portal's location id (the UN M49 code)."
          },
          "iso2": {
            "type": "string",
            "description": "ISO 3166 alpha-2 code."
          },
          "iso3": {
            "type": "string",
            "description": "ISO 3166 alpha-3 code."
          },
          "name": {
            "type": "string"
          },
          "latitude": {
            "type": "number"
          },
          "longitude": {
            "type": "number"
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per known code, in the portal's own order."
    }
  },
  "description": "The locations found, as the portal returns them.",
  "additionalProperties": true
}