npm kardashev-mcpstdioMITupdated 24d ago
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.
What can you do with kardashev mcp?
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
Install
Add kardashev mcp to your client. Pick the one you use.
claude mcp add kardashev-mcp -- npx -y kardashev-mcpcodex mcp add kardashev-mcp -- npx -y kardashev-mcpamp mcp add kardashev-mcp -- npx -y kardashev-mcp{
"mcpServers": {
"kardashev-mcp": {
"command": "npx",
"args": [
"-y",
"kardashev-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"kardashev-mcp": {
"command": "npx",
"args": [
"-y",
"kardashev-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"kardashev-mcp","command":"npx","args":["-y","kardashev-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"kardashev-mcp": {
"command": "npx",
"args": [
"-y",
"kardashev-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"kardashev-mcp": {
"command": "npx",
"args": [
"-y",
"kardashev-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"kardashev-mcp": {
"command": "npx",
"args": [
"-y",
"kardashev-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"kardashev-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"kardashev-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"kardashev-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"kardashev-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y kardashev-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
11 tools
kardashev mcp exposes 11 tools to a connected agent.
- 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
Score
77 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust16/20
- Capability8/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 17 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 11 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.1.0Latest | Aug 13, 2026 |