Global Poverty & Inequality Data

Available ActionsEach successful request consumes credits as outlined below.

query_poverty_data^5cr

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.

Use Cases

Development analysis, poverty research, inequality studies, SDG monitoring, policy research

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

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

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -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
    }
  }'

import requests
import json

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

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

data = {
    "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
    }
}

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: "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
  }
};

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: "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
  }
};

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.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:6980d4fd71cad8f61bf5b1a4
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/6980d4fd71cad8f61bf5b1a4/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Actions(1)

query_poverty_data^5cr5 params(1 required)

Fetch poverty and inequality data for a country or region from the World Bank World Development Indicators database.

country_or_regionrequiredstring

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.

metric_typestring

Type of poverty/inequality metric to query.

Values:

poverty_headcountextreme_povertygini_indexginiinequalityincome_distributionall

Default: all

time_periodstring

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

include_regional_comparisonboolean

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

include_trendsboolean

Include trend analysis showing direction, absolute change, percent change, and data point count when historical data is available.

Default: true

Usage Instructions

Usage guidance provided directly by the developer for this product.

Global Poverty & Inequality Data

Name: Global Poverty & Inequality Data
Brand: Apoth3osis
SKU: 6980d4fd71cad8f61bf5b1a4
Price: 0.05 USD
Availability: InStock

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:

{
  "action": "query_poverty_data",
  "country_or_region": "India",
  "metric_type": "all",
  "time_period": "latest"
}

Example — Inequality trends over a decade:

{
  "action": "query_poverty_data",
  "country_or_region": "Brazil",
  "metric_type": "inequality",
  "time_period": "2010:2022",
  "include_trends": true
}

Example — Regional poverty overview:

{
  "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:

{
  "action": "query_poverty_data",
  "country_or_region": "South Africa",
  "metric_type": "gini_index",
  "time_period": "latest"
}

Example — Extreme poverty with no comparisons:

{
  "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

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.
Track progress over time — Use time_period: "2010:2022" with include_trends: true to see whether poverty is improving or worsening.
Cross-country comparison — Make separate calls for different countries with the same metric and time period, then compare the results.
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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Global Poverty & Inequality Data

Description