# caruon [Health: Active]

**Category:** 🌳 Environment & Nature  
**Repository:** https://github.com/pipeworx-io/mcp-carbon  
**GitHub Stars:** 0  
**npm Downloads (last month):** 492  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/caruon

## Description
Carbon MCP — UK Carbon Intensity API (free, no auth)

## Tools
Capabilities this server exposes over MCP:

- **get_intensity** — Check current UK electricity carbon intensity. Returns gCO2/kWh (forecast and actual) plus intensity level (very low to very high). Use to schedule energy-intensive tasks during low-carbon periods.
- **get_intensity_by_date** — Get UK electricity carbon intensity for every 30-minute period on a specific date (e.g., "2024-01-15"). Returns gCO2/kWh forecast and actual. Use to identify lowest-carbon hours.
- **get_generation_mix** — 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.
- **get_regional_intensity** — Carbon intensity (forecast gCO2/kWh + index band) and generation mix for a specific Great Britain region. Pass "postcode" (UK outcode — first half of a postcode, e.g. "RG10") or "regionid" (1–17, e.g. 13 = London). Omit both for all regions at the current half-hour. Regional figures are forecast-only.
- **get_intensity_factors** — Carbon intensity factors (gCO2/kWh) per fuel type used in the headline figures — e.g. Coal 937, Gas (Combined Cycle) 394, Nuclear 0, Wind 0, Solar 0.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "caruon": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-carbon"]
  }
}
```

## Documentation

## What caruon does

caruon exposes UK electricity carbon data as MCP tools. It connects through the Pipeworx gateway to provide current headline intensity in grams of CO2 per kilowatt-hour, historical readings at 30-minute intervals, grid generation shares, regional forecasts, and the factors used for fuel-specific calculations.

The data is suited to agents that need to reason about when electricity use may have a lower carbon impact. For example, an agent can compare intensity levels before scheduling a batch job, inspect the current contribution from wind or gas, or review a complete day's readings to identify lower-intensity periods.

## How it works

The hosted MCP endpoint is available at `https://gateway.pipeworx.io/carbon/mcp`. An MCP client connects to that URL and discovers the carbon tools. The same gateway also offers a full endpoint at `https://gateway.pipeworx.io/mcp`; the carbon endpoint lists the carbon pack directly, while the full endpoint lists tools from the wider Pipeworx catalog.

Pack endpoints also expose shared Pipeworx meta-tools, including routing and discovery tools. These can reach other catalog data sources through the gateway, even when the carbon endpoint is being used. The exact tool scope is returned during MCP initialization.

Calls can also be made over HTTP. For example, `POST https://gateway.pipeworx.io/v1/tools/get_intensity` with a JSON content type and an empty object invokes the current-intensity tool.

## Setup and configuration

For a hosted connection, add the following MCP server entry:

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

The npm package provides a local stdio bridge:

```json
{
  "mcpServers": {
    "carbon": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-carbon"]
    }
  }
}
```

The bridge forwards requests to the hosted gateway and therefore needs network access. It does not provide offline operation. Anonymous use is capped at 50 calls per day. A free Pipeworx account increases the limit to 200 calls per day; set `PIPEWORX_API_KEY` in the MCP server's environment to use the account key. Setting `PIPEWORX_META_TOOLS=1` adds the gateway-wide meta-tools to the local server's listed tools.

## Tools and capabilities

- `get_intensity` returns current forecast and actual gCO2/kWh values with an intensity band ranging from very low to very high.
- `get_intensity_by_date` returns forecast and actual readings for each 30-minute period on a specified date.
- `get_generation_mix` reports the current percentage contribution from gas, coal, wind, solar, nuclear, hydro, biomass, and imports.
- `get_regional_intensity` provides forecast intensity, an index band, and generation mix for a Great Britain region. It accepts a UK postcode outcode or a region ID; omitting both returns all regions for the current half-hour.
- `get_intensity_factors` lists the gCO2/kWh factors used for headline figures, including factors for coal, combined-cycle gas, nuclear, wind, and solar.

## Limitations and notes

Regional results are forecast-only. The local bridge depends on the Pipeworx gateway, so network connectivity is required. A hosted connection does not require an account for initial calls, while authenticated use has a higher daily allowance. The integration is independent and unofficial rather than published or endorsed by the upstream data provider.

_Full upstream README: https://allmcps.com/mcp/caruon/readme_