get_generation_mix

Pack: carbon · Endpoint: https://gateway.pipeworx.io/carbon/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_generation_mix for the schema, then POST the same URL with its arguments for the data.

Check current UK electricity grid composition by source percentage (gas, coal, wind, solar, nuclear, hydro, biomass, imports). Use to understand real-time grid energy mix.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/carbon/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_generation_mix","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_generation_mix', {});

Response shape

Always returns: from, to, generation_mix

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Start time of the generation mix period (ISO 8601)"
    },
    "to": {
      "type": "string",
      "description": "End time of the generation mix period (ISO 8601)"
    },
    "generation_mix": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fuel": {
            "type": "string",
            "description": "Fuel type or generation source (e.g., gas, coal, wind, solar, nuclear)"
          },
          "percentage": {
            "type": "number",
            "description": "Percentage of electricity generated by this fuel type"
          }
        },
        "required": [
          "fuel",
          "percentage"
        ]
      },
      "description": "Current electricity generation mix by fuel source and percentage"
    }
  },
  "required": [
    "from",
    "to",
    "generation_mix"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "carbon": {
      "url": "https://gateway.pipeworx.io/carbon/mcp"
    }
  }
}

See Getting Started for client-specific install steps.