# WorldScore

> Sourced 0–100 scores for every country in the world. Every score is traceable to a real, citable
> source and is returned with full provenance — source, license, dates, confidence tier (A–D), and the
> exact normalization method and parameters. Missing values are shown as "no data", never fabricated.

## Policy

- No fabricated, interpolated, or estimated data. A score exists only if a named source published a
  value for that country; otherwise it is absent ("no data"), never a fake zero.
- Reliability is expressed through confidence tiers (A = official/robust … D = novelty), not false
  precision. Tiers C/D carry a visible caution.
- Scores using dataset-relative methods (min-max, log-minmax, percentile) are relative to the current
  country set; compare raw values across years, not scores.

## REST API (read-only, JSON, CORS-enabled)

- API docs: https://worldscore-pearl.vercel.app/api
- OpenAPI 3.1 spec: https://worldscore-pearl.vercel.app/api/openapi.json
- GET https://worldscore-pearl.vercel.app/api/v1/countries — list of countries (ISO 3166-1 alpha-3)
- GET https://worldscore-pearl.vercel.app/api/v1/countries/{iso3} — all scores for a country, with provenance
- GET https://worldscore-pearl.vercel.app/api/v1/metrics — metric catalog (tier, direction, scale, methodology)
- GET https://worldscore-pearl.vercel.app/api/v1/metrics/{slug}/ranking — full ranking with provenance
- GET https://worldscore-pearl.vercel.app/api/v1/metrics/crime/ranking?crimeType=homicide — crime family by type
- GET https://worldscore-pearl.vercel.app/api/v1/compare?countries=ESP,PRT&metrics=corruption-cpi — side-by-side comparison

Every score object includes a "provenance" block (source, license, dates, normalization). No bare numbers.

## MCP server

A Model Context Protocol server exposes the same data as read-only tools (list_metrics,
list_countries, get_country_scores, get_metric_ranking, compare_countries, get_methodology), each
returning provenance + tier. Source and setup: see /mcp-server in the repository.

## Metrics currently available (103)

- Age dependency ratio [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/age-dependency
- Fertility rate [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/fertility-rate
- Foreign-born population [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/migrant-stock
- Life expectancy gap (female − male) [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/life-expectancy-gap
- Median age [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/median-age
- Net migration rate [Demographics & migration, Tier B] — https://worldscore-pearl.vercel.app/metric/net-migration-rate
- Population change (projection) [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/population-growth-projection
- Population density [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/population-density
- Refugees (by origin) [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/refugees-origin
- Remittances received [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/remittances
- Rural population share [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/rural-share
- Sex ratio at birth [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/sex-ratio-birth
- Total population [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/population
- Urbanization [Demographics & migration, Tier A] — https://worldscore-pearl.vercel.app/metric/urbanization
- Employment-to-population ratio [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/employment-ratio
- Exports of goods & services [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/exports
- Foreign direct investment [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/fdi
- GDP growth (projection) [Economy, Tier B] — https://worldscore-pearl.vercel.app/metric/gdp-growth-projection
- GDP per capita (PPP) [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/gdp-per-capita-ppp
- Government debt [Economy, Tier B] — https://worldscore-pearl.vercel.app/metric/public-debt
- Government revenue [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/government-revenue
- Gross savings [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/gross-savings
- Income inequality (Gini) [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/income-inequality-gini
- Inflation rate [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/inflation
- Labour productivity [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/labour-productivity
- New business density [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/business-density
- Tax wedge on labour [Economy, Tier B] — https://worldscore-pearl.vercel.app/metric/tax-wedge
- Unemployment rate [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/unemployment
- Youth unemployment rate [Economy, Tier A] — https://worldscore-pearl.vercel.app/metric/youth-unemployment
- Adult literacy rate [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/adult-literacy
- Government education spending [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/education-spending
- Lower-secondary completion rate [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/secondary-completion
- Mean years of schooling [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/mean-years-schooling
- PISA maths [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/pisa-maths
- PISA reading [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/pisa-reading
- PISA science [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/pisa-science
- Pupil–teacher ratio (primary) [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/pupil-teacher-ratio
- Researchers in R&D [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/researchers
- Tertiary enrollment ratio [Education, Tier A] — https://worldscore-pearl.vercel.app/metric/tertiary-enrollment
- Access to electricity [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/electricity-access
- Air transport passengers [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/air-passengers
- CO₂ emissions per capita [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/co2-per-capita
- Climate vulnerability [Environment & infrastructure, Tier B] — https://worldscore-pearl.vercel.app/metric/climate-vulnerability
- Electricity use per capita [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/electricity-use
- Energy use per capita [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/energy-use
- Fixed broadband subscriptions [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/fixed-broadband
- Forest area [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/forest-area
- Internet users [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/internet-users
- Logistics Performance Index [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/logistics-performance
- Municipal waste per capita [Environment & infrastructure, Tier B] — https://worldscore-pearl.vercel.app/metric/municipal-waste
- PM2.5 air pollution [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/pm25-pollution
- Protected land area [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/protected-land
- Recycling rate [Environment & infrastructure, Tier B] — https://worldscore-pearl.vercel.app/metric/recycling-rate
- Renewable energy share [Environment & infrastructure, Tier A] — https://worldscore-pearl.vercel.app/metric/renewable-energy
- Corruption Perceptions Index [Governance & institutions, Tier A] — https://worldscore-pearl.vercel.app/metric/corruption-cpi
- Electoral democracy index [Governance & institutions, Tier A] — https://worldscore-pearl.vercel.app/metric/electoral-democracy
- Freedom of expression index [Governance & institutions, Tier A] — https://worldscore-pearl.vercel.app/metric/freedom-of-expression
- Government effectiveness [Governance & institutions, Tier A] — https://worldscore-pearl.vercel.app/metric/government-effectiveness
- Rule of law index [Governance & institutions, Tier A] — https://worldscore-pearl.vercel.app/metric/rule-of-law
- Women in parliament [Governance & institutions, Tier A] — https://worldscore-pearl.vercel.app/metric/women-in-parliament
- Diabetes prevalence [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/diabetes
- Health expenditure per capita [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/health-expenditure
- Hospital beds per 1,000 [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/hospital-beds
- Immunization coverage (DTP3) [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/immunization-dtp3
- Infant mortality rate [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/infant-mortality
- Life expectancy at birth [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/life-expectancy
- Maternal mortality ratio [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/maternal-mortality
- Physicians per 1,000 [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/physicians
- Safe drinking water [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/safe-water
- Safe sanitation [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/safe-sanitation
- Tobacco use [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/tobacco-use
- Under-5 mortality rate [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/under5-mortality
- Undernourishment [Health, Tier A] — https://worldscore-pearl.vercel.app/metric/undernourishment
- Human Development Index [Quality of life & wellbeing, Tier A] — https://worldscore-pearl.vercel.app/metric/hdi
- Life satisfaction (happiness) [Quality of life & wellbeing, Tier B] — https://worldscore-pearl.vercel.app/metric/life-satisfaction
- Deaths in armed conflicts [Safety & crime, Tier A] — https://worldscore-pearl.vercel.app/metric/conflict-deaths
- Homicide rate [Safety & crime, Tier A] — https://worldscore-pearl.vercel.app/metric/homicide-rate
- Internally displaced persons [Safety & crime, Tier A] — https://worldscore-pearl.vercel.app/metric/internally-displaced
- Recorded assault rate [Safety & crime, Tier C] — https://worldscore-pearl.vercel.app/metric/recorded-assault
- Recorded corruption offence rate [Safety & crime, Tier C] — https://worldscore-pearl.vercel.app/metric/recorded-corruption
- Recorded drug offence rate [Safety & crime, Tier C] — https://worldscore-pearl.vercel.app/metric/recorded-drug-offences
- Recorded kidnapping rate [Safety & crime, Tier C] — https://worldscore-pearl.vercel.app/metric/recorded-kidnapping
- Recorded robbery rate [Safety & crime, Tier C] — https://worldscore-pearl.vercel.app/metric/recorded-robbery
- Recorded sexual violence rate [Safety & crime, Tier C] — https://worldscore-pearl.vercel.app/metric/recorded-sexual-violence
- Recorded theft rate [Safety & crime, Tier C] — https://worldscore-pearl.vercel.app/metric/recorded-theft
- Road-traffic deaths [Safety & crime, Tier B] — https://worldscore-pearl.vercel.app/metric/road-deaths
- Adult male height [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/adult-male-height
- Average annual working hours [Society & culture, Tier B] — https://worldscore-pearl.vercel.app/metric/working-hours
- Child labour [Society & culture, Tier B] — https://worldscore-pearl.vercel.app/metric/child-labour
- Chocolate supply per person (proxy) [Society & culture, Tier C] — https://worldscore-pearl.vercel.app/metric/chocolate-supply
- Female labour force participation [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/female-labour-participation
- Fish & seafood supply per capita [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/fish-supply
- Fruit supply per capita [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/fruit-supply
- Gender equality (inverted GII) [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/gender-inequality
- Gender wage gap [Society & culture, Tier B] — https://worldscore-pearl.vercel.app/metric/gender-pay-gap
- Informal employment [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/informal-employment
- International tourist arrivals [Society & culture, Tier B] — https://worldscore-pearl.vercel.app/metric/tourist-arrivals
- Meat supply per capita [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/meat-supply
- Nobel laureates per capita [Society & culture, Tier B] — https://worldscore-pearl.vercel.app/metric/nobel-laureates
- Social protection coverage [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/social-protection
- Social tolerance (proxy) [Society & culture, Tier C] — https://worldscore-pearl.vercel.app/metric/social-tolerance
- Trade union density [Society & culture, Tier B] — https://worldscore-pearl.vercel.app/metric/union-density
- Vegetable supply per capita [Society & culture, Tier A] — https://worldscore-pearl.vercel.app/metric/vegetable-supply

## More

- Methodology (tiers, normalization, sources + licenses): https://worldscore-pearl.vercel.app/methodology
- Human map & explorer: https://worldscore-pearl.vercel.app/