# Federal and State Education Data Hub

## Links

- Product page URL: https://www.agentpmt.com/marketplace/education-statistics-literacy
- Product markdown URL: https://www.agentpmt.com/marketplace/education-statistics-literacy?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/education-statistics-literacy?format=agent-json

## Overview

- Product ID: 6980d5aa71cad8f61bf5b1a8
- Vendor: Apoth3osis
- Type: function
- Unit type: request
- Price: 2000 credits
- Categories: Data Science, Academic & Scientific Research, Public Records & Government Data, Public Records & FOIA, Civic Data & Demographics
- Generated at: 2026-05-30T20:24:01.929Z

### Page Description

Unified education analytics tool for public datasets covering literacy, enrollment, completion, equity, accountability, and school performance. Supports natural-language queries and routes requests across education-focused sources to return usable comparisons by country, state, and region.

### Agent Description

Natural language interface to World Bank education statistics. Query by country and education level, get enrollment rates, literacy, gender parity indices. Automatic disaggregation by gender and education level.

## Details

### Details

Unified education analytics tool for public datasets covering literacy, enrollment, completion, equity, accountability, and school performance. Supports natural-language queries and routes requests across education-focused sources to return usable comparisons by country, state, and region.

### Actions

- `query_education_data` (20 credits): Fetch education statistics for a country or region from the World Bank World Development Indicators database.

### Use Cases

Education policy analysis,School performance benchmarking,Literacy and enrollment trends,Regional equity reporting,Program impact evaluation

### 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 <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "6980d5aa71cad8f61bf5b1a8",
    "parameters": {
      "action": "query_education_data",
      "country_or_region": "example_country_or_region",
      "education_level": "all",
      "gender_disaggregation": false,
      "time_period": "latest",
      "include_gender_parity": true,
      "include_teacher_ratios": false,
      "include_completion_rates": true,
      "compare_to_region": 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_education_data": {
      "description": "Fetch education statistics 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 language (e.g., 'Kenya', 'South Africa', 'World', 'Sub-Saharan Africa').",
          "required": true
        },
        "education_level": {
          "type": "string",
          "description": "Education level to query: 'primary', 'secondary', 'tertiary', 'literacy', or 'all'.",
          "required": false,
          "default": "all",
          "enum": [
            "primary",
            "secondary",
            "tertiary",
            "literacy",
            "all"
          ]
        },
        "gender_disaggregation": {
          "type": "boolean",
          "description": "Include gender-disaggregated data (male/female breakdowns).",
          "required": false,
          "default": false
        },
        "time_period": {
          "type": "string",
          "description": "Time period: 'latest' for most recent, specific year like '2020', or range like '2015:2020'.",
          "required": false,
          "default": "latest"
        },
        "include_gender_parity": {
          "type": "boolean",
          "description": "Include gender parity indices (ratio of female to male enrollment/literacy).",
          "required": false,
          "default": true
        },
        "include_teacher_ratios": {
          "type": "boolean",
          "description": "Include pupil-teacher ratios.",
          "required": false,
          "default": false
        },
        "include_completion_rates": {
          "type": "boolean",
          "description": "Include completion rates where available.",
          "required": false,
          "default": true
        },
        "compare_to_region": {
          "type": "boolean",
          "description": "Include regional averages for comparison.",
          "required": false,
          "default": true
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Action to perform: 'get_instructions' for documentation, 'query_education_data' to fetch education statistics",
      "required": false,
      "enum": [
        "get_instructions",
        "query_education_data"
      ]
    },
    "country_or_region": {
      "type": "string",
      "description": "Country or region name in plain language (e.g., 'Kenya', 'South Africa', 'World', 'Sub-Saharan Africa'). Required for query_education_data.",
      "required": false
    },
    "education_level": {
      "type": "string",
      "description": "Education level to query: 'primary', 'secondary', 'tertiary', 'literacy', or 'all'",
      "required": false,
      "default": "all",
      "enum": [
        "primary",
        "secondary",
        "tertiary",
        "literacy",
        "all"
      ]
    },
    "gender_disaggregation": {
      "type": "boolean",
      "description": "Include gender-disaggregated data (male/female breakdowns). Must be a boolean.",
      "required": false
    },
    "time_period": {
      "type": "string",
      "description": "Time period: 'latest' for most recent, specific year like '2020', or range like '2015:2020'",
      "required": false,
      "default": "latest"
    },
    "include_gender_parity": {
      "type": "boolean",
      "description": "Include gender parity indices (ratio of female to male enrollment/literacy). Must be a boolean.",
      "required": false,
      "default": true
    },
    "include_teacher_ratios": {
      "type": "boolean",
      "description": "Include pupil-teacher ratios. Must be a boolean.",
      "required": false
    },
    "include_completion_rates": {
      "type": "boolean",
      "description": "Include completion rates where available. Must be a boolean.",
      "required": false,
      "default": true
    },
    "compare_to_region": {
      "type": "boolean",
      "description": "Include regional averages for comparison. Must be a boolean.",
      "required": false,
      "default": true
    }
  }
}
```

### Usage Instructions

# 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:**
```json
{
  "action": "query_education_data",
  "country_or_region": "Kenya",
  "education_level": "primary",
  "time_period": "latest"
}
```

**Example — All education data with gender breakdown:**
```json
{
  "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:**
```json
{
  "action": "query_education_data",
  "country_or_region": "Nigeria",
  "education_level": "literacy",
  "time_period": "2015:2020"
}
```

**Example — Tertiary enrollment without regional comparison:**
```json
{
  "action": "query_education_data",
  "country_or_region": "Brazil",
  "education_level": "tertiary",
  "compare_to_region": false
}
```

**Example — Secondary education with teacher ratios:**
```json
{
  "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.

### 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 <AGENTPMT_BEARER_TOKEN>",
        "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 6980d5aa71cad8f61bf5b1a8 ("Federal and State Education Data Hub"). Then call the same tool with action 'call\_tool', tool\_id 6980d5aa71cad8f61bf5b1a8, 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.