Federal and State Education Data Hub

Access education statistics for 200+ countries from the World Bank. Query enrollment rates, literacy rates, gender parity indices, pupil-teacher ratios, completion rates, and learning poverty data by country and education level.

Actions

query_education_data

Fetch education statistics for a country or region from the World Bank World Development Indicators database.

Required fields:

• action — "query_education_data"
• country_or_region (string) — Country or region name in plain English (e.g., "Kenya", "United States", "India", "South Africa", "World"). The tool first checks a built-in mapping of common country names, then falls back to fuzzy matching against the World Bank countries API for exact and partial matches.

Optional fields:

• education_level (string) — Education level to query. Default: "all".
  • "primary" — Primary enrollment, completion, gender parity, pupil-teacher ratio, out-of-school rate, and learning poverty
  • "secondary" — Secondary enrollment, completion, gender parity, and pupil-teacher ratio
  • "tertiary" — Tertiary enrollment and gender parity
  • "literacy" — Adult literacy and youth literacy rates
  • "all" — All of the above combined
• gender_disaggregation (boolean) — Include male/female breakdowns for literacy, primary enrollment, and secondary enrollment. Default: false.
• time_period (string) — Time period for data. Default: "latest".
  • "latest" — Most recent available data point
  • "YYYY" — Specific year (e.g., "2020")
  • "YYYY:YYYY" — Year range (e.g., "2015:2020")
• include_gender_parity (boolean) — Include gender parity indices (ratio of female to male enrollment/literacy) for each education level. Default: true.
• include_teacher_ratios (boolean) — Include pupil-teacher ratios for primary and secondary levels. Default: false.
• include_completion_rates (boolean) — Include primary and secondary completion rates where available. Default: true.
• compare_to_region (boolean) — Include regional averages for key indicators (primary enrollment, secondary enrollment, adult literacy) based on the country's World Bank region. Skipped when querying "World". Default: true.

Example — Primary education data for a country:

{
  "action": "query_education_data",
  "country_or_region": "Kenya",
  "education_level": "primary",
  "time_period": "latest"
}

Example — All education data with gender breakdown:

{
  "action": "query_education_data",
  "country_or_region": "India",
  "education_level": "all",
  "gender_disaggregation": true,
  "include_gender_parity": true,
  "include_teacher_ratios": true
}

Example — Literacy rates over a time range:

{
  "action": "query_education_data",
  "country_or_region": "Nigeria",
  "education_level": "literacy",
  "time_period": "2015:2020"
}

Example — Tertiary enrollment without regional comparison:

{
  "action": "query_education_data",
  "country_or_region": "Brazil",
  "education_level": "tertiary",
  "compare_to_region": false
}

Example — Secondary education with teacher ratios:

{
  "action": "query_education_data",
  "country_or_region": "South Africa",
  "education_level": "secondary",
  "include_teacher_ratios": true,
  "include_completion_rates": true
}

Response Format

Responses include:

• data — Per-indicator results. Each indicator contains:
  • indicator — World Bank indicator code
  • values — Array of data points with year, value, and country name
  • available — Whether data was found
• metadata — Query context: country code, country name, education level, time period, and query timestamp.
• regional_comparison — When enabled, regional average data for key indicators from the country's World Bank region.
• gender_parity_analysis — When enabled, parity indices per education level with interpretation:
  • Index < 0.97 = female disadvantage
  • Index 0.97-1.03 = gender parity achieved
  • Index > 1.03 = female advantage
• sdg_alignment — SDG 4 (Quality Education) target analysis:
  • Target 4.1: Primary completion (on track if >= 90%)
  • Target 4.3: Tertiary access (expanding if > 30%)
  • Target 4.5: Gender equality in education
  • Target 4.6: Adult literacy progress (high >= 95%, moderate >= 80%, low < 80%)

If a country name cannot be resolved, the tool returns an error.

Education Indicators by Level

Level	Indicators
literacy	Adult literacy rate, Youth literacy rate, Female literacy*, Male literacy*
primary	Primary enrollment, Primary completion, Gender parity (primary), Pupil-teacher ratio*, Out-of-school rate, Learning poverty, Female enrollment*, Male enrollment*
secondary	Secondary enrollment, Secondary completion, Gender parity (secondary), Pupil-teacher ratio*, Female enrollment*, Male enrollment*
tertiary	Tertiary enrollment, Gender parity (tertiary)

*Included only when the corresponding optional flag is enabled.

Common Workflows

1. Country education profile — Call with education_level: "all" to get a comprehensive snapshot of a country's education system.
2. Gender equity analysis — Enable gender_disaggregation: true and include_gender_parity: true to get male/female breakdowns and parity indices.
3. SDG 4 progress check — Query with education_level: "all" and review the sdg_alignment section for target progress.
4. Cross-country comparison — Make separate calls for different countries with the same parameters, then compare results.
5. Resource allocation review — Enable include_teacher_ratios: true and include_completion_rates: true to assess education system capacity.

Important Notes

• Data is sourced from the World Bank World Development Indicators database.
• Boolean fields must be actual booleans (true/false), not strings like "yes" or "no".
• Data availability varies by country and indicator; some countries may have gaps.
• Most recent data may be 1-3 years behind the current year.
• The education_level value is validated and must be one of: primary, secondary, tertiary, literacy, all.
• Regional comparison is automatically skipped when querying "World" data.