# 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
- 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-07-05T10:29:53.978Z

### 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
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp#platform=chatgpt
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp#platform=cursor
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp#platform=windsurf

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

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.

#### Product Skill Package

This product has a published Agent Skill package for product-specific operating instructions.

- Skill slug: global-energy-power-grid-data
- Version: 1.0.0
- Download SKILL.md: https://raw.githubusercontent.com/AgentPMT/agent-skills/main/skills/global-energy-power-grid-data/SKILL.md
- Package source: https://github.com/AgentPMT/agent-skills/tree/main/skills/global-energy-power-grid-data
- OpenClaw listing: https://clawhub.ai/agentpmt/global-energy-power-grid-data
- OpenClaw install: `openclaw skills install global-energy-power-grid-data`
- skills.sh install: `npx skills add AgentPMT/agent-skills --skill global-energy-power-grid-data`
- Last published: 2026-06-24T07:27:02.456Z

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

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

> Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get\_instructions' so you know how to use the tool search interface. Then call action 'get\_schema' with tool\_id 6980de6b71cad8f61bf5b1e4 ("Global Energy & Power Grid Data"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

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.