io.github.kardashev-lab/kardashev-mcp
US grid data for agents: LMP, carbon, load, queues, ERCOT large loads, RT−DA spread forecasts.
Open source Open in the app JSON README (API)
About
US grid data for agents: LMP, carbon, load, queues, ERCOT large loads, RT−DA spread forecasts.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- kardashev-lab
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.0
- Last push
- 2026-08-15T12:01:41Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:20
- Updated
- 2026-08-29 04:00:20
- Origin id
io.github.kardashev-lab/kardashev-mcp
README
# kardashev-mcp
[](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