# kardashev-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/kardashev-lab/kardashev-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kardashev-mcp

## Description
US grid data for agents: LMP, carbon, load, queues, ERCOT large loads, RT−DA spread forecasts.

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

```json
"mcpServers": {
  "kardashev-mcp": {
    "command": "npx",
    "args": ["-y","kardashev-mcp"]
  }
}
```

## Documentation & README

# kardashev-mcp

[![npm](https://img.shields.io/npm/v/kardashev-mcp.svg)](https://www.npmjs.com/package/kardashev-mcp)

MCP server for [Kardashev Labs](https://kardashevlabs.org) US grid data. Gives agents live LMP, carbon intensity, load, curtailment, interconnection queues, ERCOT large loads, and the public RT−DA spread forecast track record. No API key required.

Data comes from the public API at [data.kardashevlabs.org](https://data.kardashevlabs.org).

## Install

```bash
npx -y kardashev-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "kardashev": {
      "command": "npx",
      "args": ["-y", "kardashev-mcp"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add kardashev -- npx -y kardashev-mcp
```

## Tools

| Tool | What it returns |
| --- | --- |
| `list_isos` | Covered ISOs/RTOs and live ingest status |
| `get_fuel_mix` | Generation by fuel type (MW) |
| `get_carbon` | Carbon intensity (lbs CO₂/MWh) |
| `get_lmp` | Locational marginal prices (RT/DA) |
| `get_load` | Actual grid load (MW) |
| `get_load_forecast` | Near-term load forecast |
| `get_curtailment` | Solar/wind curtailment |
| `get_queue` | Interconnection queue projects |
| `get_large_load` | ERCOT large-load interconnection snapshot |
| `get_spread_forecast` | Live ERCOT RT−DA spread forecast (issued before delivery) |
| `get_forecast_track_record` | Scored public track record for the spread models |

Row-returning tools default to `limit=50` (hard max 500) so agents stay within context budgets.

## Optional env

| Variable | Default | Purpose |
| --- | --- | --- |
| `KARDASHEV_BASE_URL` | `https://data.kardashevlabs.org` | Override API base (local data plane) |
| `KARDASHEV_TIMEOUT_MS` | `30000` | Per-request timeout |

## Develop

```bash
npm install
npm run build
npm start                 # stdio
npm run inspect           # MCP Inspector
```

## Links

- Website: [kardashevlabs.org](https://kardashevlabs.org)
- Forecast track record: [kardashevlabs.org/forecast](https://kardashevlabs.org/forecast)
- API docs: [data.kardashevlabs.org/docs](https://data.kardashevlabs.org/docs)
- Python client: [`kardashev`](https://pypi.org/project/kardashev/)
- JS/TS client: [`kardashev`](https://www.npmjs.com/package/kardashev)

## License

MIT