Global Population & Demographics Data by Apoth3osis

Name: Global Population & Demographics Data
Brand: Apoth3osis
SKU: 6980e0f571cad8f61bf5b1fb
Price: 0.10 USD
Availability: InStock

Global Population & Demographics Data

Data

Available ActionsEach successful request consumes credits as outlined below.

query_population_data^10cr

Details

Access detailed population and demographic data for every country on earth. Look up total population counts, growth rates, age distributions, fertility trends, migration patterns, and urban-rural splits. Build age pyramids, calculate dependency ratios, and compare demographic profiles across countries and regions — all from a comprehensive global data set.

Workflows Using This Tool

Workflow

Saves ~10 min

Country Data Snapshot

Fetches population and demographics data for a specified country, analyzes key trends, and generates a chart visualization of the results. No credentials or user accounts required.

Use Cases

Look up a country's total population and growth rate, Compare age distributions across countries, Analyze fertility rate trends over time, Research migration patterns by country, Calculate dependency ratios from age structure, Compare urban vs rural population splits, Build demographic profiles for market research, Study population aging trends, Support academic demographic research, Track population projections and forecasts

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

Actions(1)

query_population_data^10cr5 params(1 required)

Query World Bank population and demographic indicators by country/region and demographic aspect. Returns data on population size, growth rates, age structure, fertility/mortality, urban-rural splits, migration, dependency ratios, and demographic transition analysis.

country_or_regionrequiredstring

Country name, ISO3 code (e.g., 'USA', 'JPN'), or region (e.g., 'East Asia')

demographic_aspectstring

Demographic category to query: 'population' (total, growth, density), 'growth' (birth/death rates, migration), 'age' (age groups, dependency ratios), 'fertility' (fertility/birth rates), 'migration' (net migration), 'all' (all indicators)

Values:

populationgrowthagefertilitymigrationall

Default: all

calculate_dependency_ratiosboolean

Automatically calculate dependency ratios from age structure data when aspect is 'all' or 'age'

Default: true

include_urban_ruralboolean

Include urban vs rural population percentage breakdown

Default: false

time_periodstring

Time period for data: 'latest', a year like '2022', a range like '2010:2023', or shorthand 'last5'/'last10'

Default: latest

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6980e0f571cad8f61bf5b1fb",
    "parameters": {
      "action": "query_population_data",
      "country_or_region": "example_country_or_region",
      "demographic_aspect": "all",
      "calculate_dependency_ratios": true,
      "include_urban_rural": false,
      "time_period": "latest"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6980e0f571cad8f61bf5b1fb",
    "parameters": {
        "action": "query_population_data",
        "country_or_region": "example_country_or_region",
        "demographic_aspect": "all",
        "calculate_dependency_ratios": true,
        "include_urban_rural": false,
        "time_period": "latest"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6980e0f571cad8f61bf5b1fb",
  parameters: {
    "action": "query_population_data",
    "country_or_region": "example_country_or_region",
    "demographic_aspect": "all",
    "calculate_dependency_ratios": true,
    "include_urban_rural": false,
    "time_period": "latest"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6980e0f571cad8f61bf5b1fb",
  parameters: {
    "action": "query_population_data",
    "country_or_region": "example_country_or_region",
    "demographic_aspect": "all",
    "calculate_dependency_ratios": true,
    "include_urban_rural": false,
    "time_period": "latest"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Population & Demographics Data

Overview

Query World Bank population and demographic indicators for any country or region. Access data on population size, growth rates, age structure, fertility and mortality, urban/rural splits, migration, dependency ratios, and demographic transition analysis. All data sourced from the World Bank Data360 API (World Development Indicators).

Actions

query_population_data

Query demographic indicators by country/region and demographic aspect.

Required Parameters:

Parameter	Type	Description
`action`	string	Must be `"query_population_data"`
`country_or_region`	string	Country name, ISO3 code, or region. Examples: `"United States"`, `"USA"`, `"JPN"`, `"Kenya"`, `"India"`

Optional Parameters:

Parameter	Type	Default	Description
`demographic_aspect`	string	`"all"`	Category of indicators to return. One of: `"population"`, `"growth"`, `"age"`, `"fertility"`, `"migration"`, `"all"`
`calculate_dependency_ratios`	boolean	`true`	Automatically calculate dependency ratios from age structure data when aspect is `"all"` or `"age"`
`include_urban_rural`	boolean	`false`	Include urban vs rural population percentage breakdown
`time_period`	string	`"latest"`	Time period for data. Accepts: `"latest"`, a single year like `"2022"`, a range like `"2010:2023"`, or shorthand `"last5"` / `"last10"`

Demographic Aspects:

population -- Total population, population growth rate (annual %), population density (people per sq. km)
growth -- Population growth rate, birth rate (per 1,000), death rate (per 1,000), net migration
age -- Age groups (0-14, 15-64, 65+ as % of total), age dependency ratio, youth dependency, elderly dependency
fertility -- Fertility rate (births per woman), birth rate (per 1,000)
migration -- Net migration (number of people)
all -- All available indicators combined

Example: Basic country population data

{
  "action": "query_population_data",
  "country_or_region": "Japan"
}

Example: Age structure with dependency ratios

{
  "action": "query_population_data",
  "country_or_region": "Germany",
  "demographic_aspect": "age",
  "calculate_dependency_ratios": true
}

Example: Growth indicators for a specific year

{
  "action": "query_population_data",
  "country_or_region": "Nigeria",
  "demographic_aspect": "growth",
  "time_period": "2020"
}

Example: Full profile with urban/rural breakdown

{
  "action": "query_population_data",
  "country_or_region": "Brazil",
  "demographic_aspect": "all",
  "include_urban_rural": true,
  "calculate_dependency_ratios": true,
  "time_period": "latest"
}

Example: Historical fertility data over a range

{
  "action": "query_population_data",
  "country_or_region": "India",
  "demographic_aspect": "fertility",
  "time_period": "2000:2023"
}

Example: Migration data using ISO3 code

{
  "action": "query_population_data",
  "country_or_region": "MEX",
  "demographic_aspect": "migration",
  "time_period": "last5"
}

Workflows

Demographic Profile Report

Call query_population_data with demographic_aspect: "all", include_urban_rural: true, and calculate_dependency_ratios: true to get a full country profile.
The response includes indicators, dependency ratios, urban/rural split, demographic transition stage analysis, and age structure interpretation.

Country Comparison

Call query_population_data for each country with the same demographic_aspect and time_period.
Compare the returned indicator values, dependency ratios, and transition stages side by side.

Trend Analysis

Call query_population_data with a time_period range (e.g., "2000:2023") and a specific demographic_aspect.
The response contains data points across the range for tracking changes over time.

Aging Population Assessment

Call query_population_data with demographic_aspect: "age" and calculate_dependency_ratios: true.
Review the age structure interpretation (young, balanced, mature, aging), estimated median age range, and policy implications in the response.

Notes

Country input: Accepts common country names (e.g., "United States", "South Korea"), short forms (e.g., "USA", "UK"), and ISO3 codes (e.g., "GBR", "JPN"). If no country is provided, defaults to world ("WLD").
Supported countries: Major economies, African nations (Kenya, Nigeria, South Africa, Ethiopia, etc.), Asian countries (Indonesia, Pakistan, Bangladesh, etc.), European countries (Netherlands, Poland, Sweden, etc.), Latin America (Argentina, Colombia, Chile, etc.), and Middle East (Saudi Arabia, UAE, Israel, etc.).
Supported regions: Use ISO3 codes or common names. No separate region aggregation endpoint; individual country queries only.
Demographic transition analysis: Automatically included when aspect is "all", "growth", or "fertility". Classifies countries into 5 stages: Stage 1 (High Stationary), Stage 2 (Early Expanding), Stage 3 (Late Expanding), Stage 4 (Low Stationary), Stage 5 (Declining).
Dependency ratios: When calculate_dependency_ratios is true and aspect is "all" or "age", the tool returns age dependency ratio, youth dependency ratio, and elderly dependency ratio (dependents per 100 working-age persons). If API-provided ratios are unavailable, they are calculated from age structure percentages.
Urban/rural split: When include_urban_rural is true, returns urban and rural percentages plus an urbanization level classification (Highly urbanized >= 80%, Moderately urbanized >= 60%, Partially urbanized >= 40%, Predominantly rural < 40%).
Age structure interpretation: Included when aspect is "all" or "age". Categorizes population as "Very young" (youth > 40%), "Young" (youth > 30%), "Aging" (elderly > 20%), "Mature" (elderly > 14%), or "Balanced", with estimated median age range and policy implications.
Replacement fertility: The tool flags whether the fertility rate is below the replacement level of 2.1 births per woman.
Data availability: World Bank data may lag 1-3 years behind the current year. Some indicators may not be available for all countries or years.
Values are rounded to 2 decimal places where applicable.
time_period validation: Accepts "latest", "last5", "last10", a 4-digit year, or a YYYY:YYYY range. Invalid formats return a validation error.
Unrecognized countries return a descriptive error suggesting valid country names or ISO3 codes.
Data source: World Bank Data360 API (World Development Indicators), updated regularly.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 6980e0f571cad8f61bf5b1fb ("Global Population & Demographics Data"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.