{
  "markdown": "# kardashev-mcp\n\n[![npm](https://img.shields.io/npm/v/kardashev-mcp.svg)](https://www.npmjs.com/package/kardashev-mcp)\n\nMCP 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.\n\nData comes from the public API at [data.kardashevlabs.org](https://data.kardashevlabs.org).\n\n## Install\n\n```bash\nnpx -y kardashev-mcp\n```\n\n### Cursor (`~/.cursor/mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"kardashev\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kardashev-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add kardashev -- npx -y kardashev-mcp\n```\n\n## Tools\n\n| Tool | What it returns |\n| --- | --- |\n| `list_isos` | Covered ISOs/RTOs and live ingest status |\n| `get_fuel_mix` | Generation by fuel type (MW) |\n| `get_carbon` | Carbon intensity (lbs CO₂/MWh) |\n| `get_lmp` | Locational marginal prices (RT/DA) |\n| `get_load` | Actual grid load (MW) |\n| `get_load_forecast` | Near-term load forecast |\n| `get_curtailment` | Solar/wind curtailment |\n| `get_queue` | Interconnection queue projects |\n| `get_large_load` | ERCOT large-load interconnection snapshot |\n| `get_spread_forecast` | Live ERCOT RT−DA spread forecast (issued before delivery) |\n| `get_forecast_track_record` | Scored public track record for the spread models |\n\nRow-returning tools default to `limit=50` (hard max 500) so agents stay within context budgets.\n\n## Optional env\n\n| Variable | Default | Purpose |\n| --- | --- | --- |\n| `KARDASHEV_BASE_URL` | `https://data.kardashevlabs.org` | Override API base (local data plane) |\n| `KARDASHEV_TIMEOUT_MS` | `30000` | Per-request timeout |\n\n## Develop\n\n```bash\nnpm install\nnpm run build\nnpm start                 # stdio\nnpm run inspect           # MCP Inspector\n```\n\n## Links\n\n- Website: [kardashevlabs.org](https://kardashevlabs.org)\n- Forecast track record: [kardashevlabs.org/forecast](https://kardashevlabs.org/forecast)\n- API docs: [data.kardashevlabs.org/docs](https://data.kardashevlabs.org/docs)\n- Python client: [`kardashev`](https://pypi.org/project/kardashev/)\n- JS/TS client: [`kardashev`](https://www.npmjs.com/package/kardashev)\n\n## License\n\nMIT\n",
  "bytes": 2275,
  "sha": "8f3691b365b4e96c6b70f84a84c6f7423a3e438fc9a4283fed37c0ff051b2832",
  "repo_slug": "kardashev-lab/kardashev-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kardashev_lab_kardashev_mcp_1f24eed2/readme"
}