# Global Poverty & Inequality Data ## Links - Product page URL: https://www.agentpmt.com/marketplace/global-poverty-inequality-data - Product markdown URL: https://www.agentpmt.com/marketplace/global-poverty-inequality-data?format=agent-md - Product JSON URL: https://www.agentpmt.com/marketplace/global-poverty-inequality-data?format=agent-json ## Overview - Product ID: 6980d4fd71cad8f61bf5b1a4 - Vendor: Apoth3osis - Type: data - Unit type: request - Price: 500 credits - Categories: Data Science, Financial Data, News & Media Monitoring, Academic & Scientific Research, Public Records & Government Data, Civic Data & Demographics - Generated at: 2026-05-30T23:09:25.142Z ### Page Description Explore how poverty and wealth are distributed across 200+ countries using data from the World Bank. Find out what share of a nation's population lives below the international poverty line, how income is split between the richest and poorest households, and whether conditions are improving or getting worse over time. Compare any country against its region or the world, track progress toward ending extreme poverty, and uncover the story behind the numbers with built-in trend analysis and contextual insights. ### Agent Description Query World Bank poverty and inequality data by country or region name. Returns poverty headcount at $2.15/$3.65/$6.85 thresholds, Gini index, income shares by quintile/decile, and extreme poverty metrics. Supports metric filtering (poverty_headcount, inequality, gini_index, income_distribution), time ranges (latest, last_5_years, YYYY:YYYY), trend analysis, and regional comparisons. Use action 'get_instructions' for full documentation. ## Details ### Details Explore how poverty and wealth are distributed across 200+ countries using data from the World Bank. Find out what share of a nation's population lives below the international poverty line, how income is split between the richest and poorest households, and whether conditions are improving or getting worse over time. Compare any country against its region or the world, track progress toward ending extreme poverty, and uncover the story behind the numbers with built-in trend analysis and contextual insights. ### Actions - `query_poverty_data` (5 credits): Fetch poverty and inequality data for a country or region from the World Bank World Development Indicators database. ### Use Cases Development analysis, poverty research, inequality studies, SDG monitoring, policy research ### Workflows Using This Tool No public workflows currently reference this product. ### Related Content No related content is currently linked to this product. ## Integration Details ### DynamicMCP - Setup page URL: https://www.agentpmt.com/dynamic-mcp - Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally. ```bash npm install -g @agentpmt/mcp-router agentpmt-setup ``` ### REST API The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials. - Purchase endpoint: https://api.agentpmt.com/products/purchase - Authorization format: `Bearer ` ```bash curl -X POST "https://api.agentpmt.com/products/purchase" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \ -d '{ "product_id": "6980d4fd71cad8f61bf5b1a4", "parameters": { "action": "query_poverty_data", "country_or_region": "example_country_or_region", "metric_type": "all", "time_period": "latest", "include_regional_comparison": true, "include_trends": true } }' ``` ### Autonomous Agents Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below. - Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents - Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md - Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress - AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls. - Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state. - Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche. ### Schema #### Parameters - Schema type: actions ```json { "actions": { "query_poverty_data": { "description": "Fetch poverty and inequality data for a country or region from the World Bank World Development Indicators database.", "properties": { "country_or_region": { "type": "string", "description": "Country or region name in plain English. Supports 200+ countries (e.g., India, Kenya, Brazil), regional aggregations (e.g., Sub-Saharan Africa, South Asia, Latin America and Caribbean), income groups (e.g., Low Income, High Income, OECD), and global (World or Global). Common abbreviations like USA, UK, UAE are accepted.", "required": true }, "metric_type": { "type": "string", "description": "Type of poverty/inequality metric to query.", "enum": [ "poverty_headcount", "extreme_poverty", "gini_index", "gini", "inequality", "income_distribution", "all" ], "default": "all", "required": false }, "time_period": { "type": "string", "description": "Time period for data retrieval: 'latest' for most recent year, 'last_5_years', 'last_10_years', or a specific range like '2015:2020'.", "default": "latest", "required": false }, "include_regional_comparison": { "type": "boolean", "description": "Include regional and global averages (World, Sub-Saharan Africa, South Asia, Latin America & Caribbean, East Asia & Pacific, Middle East & North Africa) for context.", "default": true, "required": false }, "include_trends": { "type": "boolean", "description": "Include trend analysis showing direction, absolute change, percent change, and data point count when historical data is available.", "default": true, "required": false } } } }, "properties": { "action": { "type": "string", "description": "Action to perform: 'get_instructions' for documentation, 'query_poverty_data' to fetch poverty and inequality data", "required": false, "enum": [ "get_instructions", "query_poverty_data" ] }, "country_or_region": { "type": "string", "description": "Country or region name in plain language (e.g., 'India', 'Sub-Saharan Africa', 'Bangladesh', 'World'). Supports 200+ countries and major regional aggregations.", "required": false }, "metric_type": { "type": "string", "description": "Type of poverty/inequality metric to query:\n- poverty_headcount: Poverty rates at $2.15, $3.65, $6.85/day thresholds\n- extreme_poverty: $2.15/day poverty line with gap analysis\n- gini_index: Gini coefficient (0-100 inequality measure)\n- inequality: Gini coefficient plus income share distribution\n- income_distribution: Income shares by quintile and decile\n- all: All available metrics", "required": false, "default": "all", "enum": [ "poverty_headcount", "extreme_poverty", "gini_index", "gini", "inequality", "income_distribution", "all" ] }, "time_period": { "type": "string", "description": "Time period for data retrieval:\n- 'latest': Most recent available data point\n- 'last_5_years': Data from past 5 years\n- 'last_10_years': Data from past 10 years\n- 'YYYY:YYYY': Specific year range (e.g., '2015:2020', '2010:2022')", "required": false, "default": "latest" }, "include_regional_comparison": { "type": "boolean", "description": "Include regional and global comparison data for context (World, Sub-Saharan Africa, South Asia, etc.)", "required": false, "default": true }, "include_trends": { "type": "boolean", "description": "Include trend analysis showing changes over time if historical data is available", "required": false, "default": true } } } ``` ### Usage Instructions # Global Poverty & Inequality Data Access poverty rates, Gini coefficients, income distribution, and inequality metrics for 200+ countries from World Bank data. Query by country name in plain language with optional trend analysis and regional comparisons. ## Actions ### query_poverty_data Fetch poverty and inequality data for a country or region from the World Bank World Development Indicators database. **Required fields:** - `action` — `"query_poverty_data"` - `country_or_region` (string) — Country or region name in plain English. Supports 200+ countries (e.g., `"India"`, `"Kenya"`, `"Brazil"`), regional aggregations (e.g., `"Sub-Saharan Africa"`, `"South Asia"`, `"Latin America and Caribbean"`, `"East Asia and Pacific"`, `"Middle East"`), income groups (e.g., `"Low Income"`, `"Upper Middle Income"`, `"High Income"`, `"OECD"`), and global (`"World"` or `"Global"`). Common abbreviations like `"USA"`, `"UK"`, `"UAE"` are accepted. Names longer than 100 characters are rejected. **Optional fields:** - `metric_type` (string) — Type of metric to query. Default: `"all"`. - `"poverty_headcount"` — Poverty rates at $2.15, $3.65, and $6.85/day thresholds (2017 PPP) - `"extreme_poverty"` — $2.15/day poverty line plus poverty gap analysis - `"gini_index"` — Gini coefficient (0 = perfect equality, 100 = perfect inequality) - `"gini"` — Alias for `gini_index` - `"inequality"` — Gini coefficient plus income share held by lowest 20% and highest 20% - `"income_distribution"` — Income shares by lowest 10%, lowest 20%, highest 20%, and highest 10% - `"all"` — All available metrics including multidimensional poverty headcount - `time_period` (string) — Time period for data retrieval. Default: `"latest"`. - `"latest"` — Most recent complete year - `"last_5_years"` — Data from past 5 years - `"last_10_years"` — Data from past 10 years - `"YYYY:YYYY"` — Specific year range (e.g., `"2015:2020"`, `"2010:2022"`). A dash-separated range like `"2015-2020"` is also accepted and converted automatically. - `include_regional_comparison` (boolean) — Include regional and global averages (World, Sub-Saharan Africa, South Asia, Latin America & Caribbean, East Asia & Pacific, Middle East & North Africa) for context. Default: `true`. Only the first 3 indicators are compared per region. - `include_trends` (boolean) — Include trend analysis showing direction (improving/worsening/stable), absolute and percent change, and data point count when historical data is available. Default: `true`. For poverty and inequality indicators, a decrease is classified as "improving." **Example — Latest poverty data for a country:** ```json { "action": "query_poverty_data", "country_or_region": "India", "metric_type": "all", "time_period": "latest" } ``` **Example — Inequality trends over a decade:** ```json { "action": "query_poverty_data", "country_or_region": "Brazil", "metric_type": "inequality", "time_period": "2010:2022", "include_trends": true } ``` **Example — Regional poverty overview:** ```json { "action": "query_poverty_data", "country_or_region": "Sub-Saharan Africa", "metric_type": "poverty_headcount", "time_period": "latest", "include_regional_comparison": true } ``` **Example — Gini coefficient lookup:** ```json { "action": "query_poverty_data", "country_or_region": "South Africa", "metric_type": "gini_index", "time_period": "latest" } ``` **Example — Extreme poverty with no comparisons:** ```json { "action": "query_poverty_data", "country_or_region": "Nigeria", "metric_type": "extreme_poverty", "time_period": "last_5_years", "include_regional_comparison": false, "include_trends": true } ``` ## Response Format Responses include: - **data** — Per-indicator results with indicator name, latest value, year, unit (% of population, index 0-100, or % of total income), country name, and source attribution. - **trends** — When enabled, shows oldest/newest year and value, absolute change, percent change, direction (improving/worsening/stable), and data point count. - **regional_comparison** — When enabled, latest values for the same indicators across World, Sub-Saharan Africa, South Asia, Latin America & Caribbean, East Asia & Pacific, and Middle East & North Africa. - **insights** — Auto-generated observations such as poverty level severity, inequality classification, trend direction, and comparison to global averages. - **sdg_alignment** — SDG 1: No Poverty alignment note. - **data_notes** — Contextual notes about PPP, indicator interpretation, and data freshness. If a country name is not recognized, the response returns an error with a hint to use full English country names. ## Supported Metric Indicators | Metric Type | Indicators Included | |---|---| | poverty_headcount | Poverty at $2.15/day, $3.65/day, $6.85/day | | extreme_poverty | Poverty at $2.15/day, Poverty gap at $2.15/day | | gini_index / gini | Gini coefficient | | inequality | Gini coefficient, Income share lowest 20%, Income share highest 20% | | income_distribution | Income share lowest 10%, lowest 20%, highest 20%, highest 10% | | all | All of the above plus Multidimensional poverty headcount | ## Common Workflows 1. **Country poverty profile** — Call with `metric_type: "all"` and `time_period: "latest"` to get a complete snapshot of a country's poverty and inequality status. 2. **Track progress over time** — Use `time_period: "2010:2022"` with `include_trends: true` to see whether poverty is improving or worsening. 3. **Cross-country comparison** — Make separate calls for different countries with the same metric and time period, then compare the results. 4. **Regional benchmarking** — Set `include_regional_comparison: true` to see how a country compares to its region and the world. ## Important Notes - Data is sourced from the World Bank World Development Indicators database. - PPP values are in constant 2017 international dollars. - Most recent data is typically 1-3 years behind the current year due to collection and processing delays. - Data availability varies by country and indicator; some countries may have gaps. - Boolean fields must be actual booleans (`true`/`false`), not strings. - If an unrecognized `metric_type` is provided, the tool defaults to returning all metrics. - Aligns with SDG 1 (No Poverty) and SDG 10 (Reduced Inequalities) monitoring. ### Frequently Asked Questions #### How do I connect this tool to an external agent? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md You can install the local MCP server by opening a terminal and running: ``` 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: ``` { "mcpServers": { "agentpmt": { "type": "streamable-http", "url": "https://api.agentpmt.com/mcp", "headers": { "Authorization": "Bearer ", "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}" } } } } ``` [View MCP Connection Instructions](/docs/mcp-reference/connection) for more details. #### How does an external agent use this tool? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent: > Call the AgentPMT-Tool-Search-and-Execution tool with action 'get\_schema' and tool\_id 6980d4fd71cad8f61bf5b1a4 ("Global Poverty & Inequality Data"). Then call the same tool with action 'call\_tool', tool\_id 6980d4fd71cad8f61bf5b1a4, and the parameters needed for my request. The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT. ### Dependencies This product has no public dependency products.