# Global Energy & Power Grid Data

## Links

- Product page URL: https://www.agentpmt.com/marketplace/energy-access-production
- Product markdown URL: https://www.agentpmt.com/marketplace/energy-access-production?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/energy-access-production?format=agent-json

## Overview

- Product ID: 6980de6b71cad8f61bf5b1e4
- Vendor: Apoth3osis
- Type: data
- Unit type: request
- Price: 1000 credits
- Categories: Data Science, Data Processing, Academic & Scientific Research, Public Records & Government Data, Environmental & Climate Data, Civic Data & Demographics
- Generated at: 2026-05-21T08:23:38.919Z

### Page Description

Explore energy production and access data for any country in the world. Look up electricity access rates, renewable energy adoption, fossil fuel usage, energy efficiency metrics, and power grid coverage. Compare energy mixes across countries, track the shift toward clean energy, and identify urban-rural electricity gaps — all from a comprehensive global data set.

### Agent Description

Query electricity access rates, renewable vs fossil energy mix, per capita consumption, energy intensity, and clean cooking fuel access for any country or region. Supports urban-rural gap analysis, energy mix breakdowns, and time-series trends.

## Details

### Details

Explore energy production and access data for any country in the world. Look up electricity access rates, renewable energy adoption, fossil fuel usage, energy efficiency metrics, and power grid coverage. Compare energy mixes across countries, track the shift toward clean energy, and identify urban-rural electricity gaps — all from a comprehensive global data set.

### Actions

- `query_energy_data` (10 credits): Fetch energy indicators for a country or region, including electricity access rates, renewable and fossil energy mix, per capita consumption, energy efficiency, and clean cooking access with SDG 7 tracking.

### Use Cases

Research electricity access rates by country, Compare renewable energy adoption across regions, Track fossil fuel vs clean energy trends, Analyze urban vs rural electricity gaps, Study energy consumption per capita, Monitor energy efficiency and intensity metrics, Assess progress toward SDG 7 clean energy targets, Compare energy mix breakdowns between countries, Research clean cooking fuel access, Evaluate energy transition progress over time

### 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

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.

```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": "6980de6b71cad8f61bf5b1e4",
    "parameters": {
      "action": "query_energy_data",
      "country_or_region": "example_country_or_region",
      "energy_type": "all",
      "include_urban_rural_gaps": false,
      "include_energy_mix": true,
      "time_period": "latest"
    }
  }'
```

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "query_energy_data": {
      "description": "Fetch energy indicators for a country or region, including electricity access rates, renewable and fossil energy mix, per capita consumption, energy efficiency, and clean cooking access with SDG 7 tracking.",
      "properties": {
        "country_or_region": {
          "type": "string",
          "description": "Country name, ISO3 code (e.g., 'USA', 'KEN'), or region (e.g., 'Sub-Saharan Africa')",
          "required": true
        },
        "energy_type": {
          "type": "string",
          "description": "Energy category: 'electricity', 'renewable', 'fossil', 'efficiency', 'cooking', or 'all'",
          "required": false,
          "default": "all",
          "enum": [
            "electricity",
            "renewable",
            "fossil",
            "efficiency",
            "cooking",
            "all"
          ]
        },
        "include_urban_rural_gaps": {
          "type": "boolean",
          "description": "Calculate urban/rural electricity access gap analysis with percentage points difference",
          "required": false,
          "default": false
        },
        "include_energy_mix": {
          "type": "boolean",
          "description": "Calculate energy mix breakdown showing renewable, fossil, nuclear, and other percentages",
          "required": false,
          "default": true
        },
        "time_period": {
          "type": "string",
          "description": "Time period: 'latest', single year 'YYYY' (e.g., '2020'), or range 'YYYY:YYYY' (e.g., '2015:2023')",
          "required": false,
          "default": "latest"
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Action to perform",
      "required": true,
      "enum": [
        "get_instructions",
        "query_energy_data"
      ]
    },
    "country_or_region": {
      "type": "string",
      "description": "Country name, ISO code (e.g., 'USA', 'KEN'), or region (e.g., 'Sub-Saharan Africa')",
      "required": false
    },
    "energy_type": {
      "type": "string",
      "description": "Energy category: 'electricity', 'renewable', 'fossil', 'efficiency', 'cooking', 'all'. Default: 'all'",
      "required": false
    },
    "include_urban_rural_gaps": {
      "type": "boolean",
      "description": "For electricity queries, include urban/rural access gap analysis",
      "required": false
    },
    "include_energy_mix": {
      "type": "boolean",
      "description": "Calculate energy mix percentages (renewable/fossil/nuclear breakdown)",
      "required": false,
      "default": true
    },
    "time_period": {
      "type": "string",
      "description": "Time period: 'latest', 'YYYY' (e.g., '2020'), 'YYYY:YYYY' (range, e.g., '2015:2023')",
      "required": false,
      "default": "latest"
    }
  }
}
```

### Usage Instructions

# Energy Access & Production Data

Access World Bank energy indicators including electricity access, renewable energy mix, fossil fuel consumption, energy efficiency, and clean cooking access through a natural language interface.

## Overview

This tool provides natural language access to World Bank energy data covering electricity access rates (total, urban, rural), energy mix breakdowns (renewable, fossil, nuclear), per capita consumption, energy efficiency metrics, and clean cooking fuel access. It supports SDG 7 (Affordable and Clean Energy) tracking with built-in urban/rural gap analysis and energy mix calculations.

Data is sourced from the World Bank Data API (World Development Indicators).

## Actions

### query_energy_data

Query energy indicators for any country or region.

#### Required Parameters

- **action** (string): Must be `"query_energy_data"`
- **country_or_region** (string): Country name, ISO3 code, or region
  - Country names: `"Kenya"`, `"India"`, `"United States"`, `"Germany"`
  - ISO3 codes: `"USA"`, `"KEN"`, `"IND"`
  - If not provided or empty, defaults to `"WLD"` (World)

#### Optional Parameters

- **energy_type** (string, default: `"all"`): Energy category to query
  - `"electricity"` - Electricity access rates: total population, urban, and rural
  - `"renewable"` - Renewable energy share in total final energy consumption and electricity output
  - `"fossil"` - Fossil fuel energy consumption as percentage of total
  - `"efficiency"` - Energy intensity (MJ per $2017 PPP GDP) and energy use per capita
  - `"cooking"` - Clean cooking fuel access as percentage of population
  - `"all"` - All available energy indicators (11 indicators)

- **include_urban_rural_gaps** (boolean, default: `false`): Calculate urban/rural electricity access gap analysis. Returns urban access %, rural access %, and the gap in percentage points. Most useful with `energy_type: "electricity"` or `"all"`.

- **include_energy_mix** (boolean, default: `true`): Calculate energy mix breakdown showing renewable, fossil fuel, and nuclear percentages with an "other" category for the remainder. Applies when `energy_type` is `"all"`, `"renewable"`, or `"fossil"`.

- **time_period** (string, default: `"latest"`): Time period for data retrieval
  - `"latest"` - Most recent available data point
  - `"YYYY"` - Single specific year (e.g., `"2020"`), must be between 1960 and current year
  - `"YYYY:YYYY"` - Year range (e.g., `"2015:2023"`), both years must be between 1960 and current year

#### Example: Electricity access for a country

```json
{
  "action": "query_energy_data",
  "country_or_region": "Kenya",
  "energy_type": "electricity",
  "include_urban_rural_gaps": true
}
```

#### Example: Renewable energy overview

```json
{
  "action": "query_energy_data",
  "country_or_region": "Germany",
  "energy_type": "renewable",
  "time_period": "latest"
}
```

#### Example: Full energy profile with mix breakdown

```json
{
  "action": "query_energy_data",
  "country_or_region": "India",
  "energy_type": "all",
  "include_energy_mix": true,
  "include_urban_rural_gaps": true
}
```

#### Example: Energy efficiency comparison

```json
{
  "action": "query_energy_data",
  "country_or_region": "Japan",
  "energy_type": "efficiency",
  "time_period": "2015:2023"
}
```

#### Example: Clean cooking access

```json
{
  "action": "query_energy_data",
  "country_or_region": "Ethiopia",
  "energy_type": "cooking"
}
```

## Response Structure

Responses include:

- **country**: Resolved country name from the data
- **energy_type**: The energy category queried
- **indicators**: Object with each indicator containing:
  - `value`: The numeric value
  - `date`: Year of the data point
  - `unit`: Unit of measurement (e.g., "% of population", "kg of oil equivalent per capita")
- **energy_mix** (when `include_energy_mix` is true): Breakdown with renewable_percent, fossil_percent, nuclear_percent, other_percent, and corresponding dates
- **urban_rural_gap** (when `include_urban_rural_gaps` is true): urban_access_percent, rural_access_percent, access_gap_percentage_points, and date
- **sdg_7_context**: SDG 7 tracking with target values, current values, and gap-to-universal for electricity access and clean cooking; renewable energy share note; energy intensity assessment

## Key Indicators Reference

| Indicator | Unit | Description |
|-----------|------|-------------|
| electricity_access | % of population | Total population with electricity access |
| electricity_urban | % of urban population | Urban electricity access rate |
| electricity_rural | % of rural population | Rural electricity access rate |
| clean_cooking_access | % of population | Access to clean cooking fuels |
| renewable_energy | % of total final energy | Renewable share in energy consumption |
| fossil_fuel_energy | % of total energy | Fossil fuel share of energy |
| renewable_electricity | % of total electricity output | Renewable share in electricity generation |
| alternative_nuclear | % of total energy use | Alternative and nuclear energy share |
| energy_use_per_capita | kg of oil equivalent per capita | Per capita energy consumption |
| electric_power_consumption | kWh per capita | Per capita electricity consumption |
| energy_intensity | MJ/$2017 PPP GDP | Energy intensity (lower = more efficient) |

## Workflows

1. **Energy Access Assessment**: Query `energy_type: "electricity"` with `include_urban_rural_gaps: true` to identify electrification gaps between urban and rural areas
2. **Energy Transition Tracking**: Query `energy_type: "all"` with `include_energy_mix: true` to see the renewable/fossil/nuclear breakdown and track transition progress
3. **SDG 7 Progress Monitoring**: Query `energy_type: "all"` to get the full sdg_7_context with gap-to-universal calculations for electricity and clean cooking
4. **Efficiency Benchmarking**: Query `energy_type: "efficiency"` for multiple countries to compare energy intensity and per capita consumption

## Notes

- Data sourced from World Bank World Development Indicators
- Most recent data may be 1-3 years behind the current year due to collection delays
- Data availability varies by country; some indicators may return null for certain countries
- Energy mix percentages may not sum to exactly 100% due to data collection timing differences across indicators
- The "other" category in energy mix is calculated as 100 minus the sum of renewable, fossil, and nuclear
- Urban/rural gap analysis requires both urban and rural data to be available; returns null if either is missing
- SDG 7 context is always included in responses regardless of parameters
- When a country name is not recognized, a ValueError is raised with guidance
- If country_or_region is empty or null, defaults to World (WLD) data
- Country codes that are already 3 uppercase letters pass through directly

## Pricing

$0.05 per request

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.