io.github.kardashev-lab/kardashev-mcp
US grid data for agents: LMP, carbon, load, queues, ERCOT large loads, RT−DA spread forecasts.
kardashev-mcp
MCP server for Kardashev Labs 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.
Install
npx -y kardashev-mcp
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"kardashev": {
"command": "npx",
"args": ["-y", "kardashev-mcp"]
}
}
}
Claude Code
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
npm install
npm run build
npm start # stdio
npm run inspect # MCP Inspector
Links
- Website: kardashevlabs.org
- Forecast track record: kardashevlabs.org/forecast
- API docs: data.kardashevlabs.org/docs
- Python client:
kardashev - JS/TS client:
kardashev
License
MIT
Installation
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y kardashev-mcpSet up in your AI client
Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-kardashev-lab-kardashev-mcp": {
"command": "npx",
"args": [
"-y",
"kardashev-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePackage
kardashev-mcpnpmCompatible MCP Clients
io.github.kardashev-lab/kardashev-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.