io.github.kardashev-lab/kardashev-mcp

NPM · KARDASHEV-MCP · SCANNED AUG 18

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

Available components

69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security98

No malware found by supply-chain analysis.Pass
No known CVEs affecting this package version or its production dependencies.Pass
No install/post-install scripts declared.Pass
30 of 95 dependencies flagged as unhealthy. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 5 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability79

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1256 tokens (~114/item across 11 items; 11 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · kardashev-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add kardashev-lab-kardashev-mcp -- npx -y kardashev-mcp

# add to Codex CLI

codex mcp add kardashev-lab-kardashev-mcp -- npx -y kardashev-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kardashev-lab-kardashev-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kardashev-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add kardashev-lab-kardashev-mcp --command npx --arg -y --arg kardashev-mcp

# ~/.hermes/config.yaml

mcp_servers:
  kardashev-lab-kardashev-mcp:
    command: "npx"
    args: ["-y", "kardashev-mcp"]

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

13 Aug 26 69

First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 18 Aug 2026 · Analysed npm/kardashev-mcp@0.1.0

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	npm

Dependencies 95 packages

Packages resolved	95
Stale	30
Tree resolution	Complete

MCP tools · 11 exposed · ~1,256 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

get_carbon Get carbon intensity ~148

Grid carbon intensity in lbs CO₂/MWh. Omit iso with latest=true for all balancing authorities; pass iso for one region. Prefer this over raw fuel-mix when the question is about emissions intensity.

Input Output Examples

Name	Type	Req	Description
end	string	–	End date YYYY-MM-DD for history.
hours	integer	–	Trailing hours of history.
iso	string	–	ISO/BA code. Optional when latest=true (returns all).
latest	boolean	–	If true, return latest snapshot(s). Default true when no history window.
limit	integer	–	Max rows (default 50, max 500).
start	string	–	Start date YYYY-MM-DD for history.

No output schema declared.

No examples provided.

get_curtailment Get renewable curtailment ~113

Solar and wind curtailment (MWh) by ISO. Strongest coverage for CAISO, ERCOT, SPP.

Input Output Examples

Name	Type	Req	Description
days	integer	–	Trailing days if start/end omitted.
end	string	–	End date YYYY-MM-DD.
iso	string	–	ISO code filter, e.g. CAISO or ERCOT.
limit	integer	–	Max rows after fetch (default 50, max 500).
start	string	–	Start date YYYY-MM-DD.

No output schema declared.

No examples provided.

get_forecast_track_record Get spread forecast track record ~60

Public scored track record for Kardashev Labs ERCOT RT−DA spread models (MAE/RMSE/coverage/DART PnL). Use this to evaluate forecast quality; use get_spread_forecast for the live forward issuance.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_fuel_mix Get fuel mix ~157

Generation by fuel type (MW) for a US ISO. Use latest=true for the newest snapshot; otherwise returns recent history (row-capped).

Input Output Examples

Name	Type	Req	Description
end	string	–	End date YYYY-MM-DD.
fuel_type	string	–	Optional fuel filter, e.g. solar, wind, gas.
iso	string	yes	ISO/RTO code, e.g. CAISO, ERCOT, MISO, NYISO, ISONE, SPP, PJM.
latest	boolean	–	If true, return only the latest fuel-mix snapshot. Default false.
limit	integer	–	Max rows (default 50, max 500).
start	string	–	Start date YYYY-MM-DD.

No output schema declared.

No examples provided.

get_large_load Get ERCOT large loads ~82

ERCOT large-load interconnection queue snapshot and summary (data centers, crypto, industrial). ERCOT-only. Use summary=true for aggregates; default returns latest rows.

Input Output Examples

Name	Type	Req	Description
limit	integer	–	Max rows when summary=false (default 50, max 500).
summary	boolean	–	If true, return aggregate summary instead of project rows. Default false.

No output schema declared.

No examples provided.

get_lmp Get LMP prices ~182

Locational marginal prices (LMP) for a US ISO. market=RT (real-time) or DA (day-ahead). Optionally filter by node_id. This is settled/observed prices — for Kardashev's forward RT−DA spread forecast use get_spread_forecast instead.

Input Output Examples

Name	Type	Req	Description
end	string	–	End date YYYY-MM-DD.
iso	string	yes	ISO/RTO code, e.g. CAISO, ERCOT, MISO, NYISO, ISONE, SPP, PJM.
limit	integer	–	Max rows (default 50, max 500).
market	string	–	RT (real-time) or DA (day-ahead). Default RT.
node_id	string	–	Optional price node / hub id.
start	string	–	Start date YYYY-MM-DD.

No output schema declared.

No examples provided.

get_load Get grid load ~120

Actual electricity demand (MW) for a US ISO or zone.

Input Output Examples

Name	Type	Req	Description
end	string	–	End date YYYY-MM-DD.
hours	integer	–	Trailing hours.
iso	string	yes	ISO/RTO code, e.g. CAISO, ERCOT, MISO, NYISO, ISONE, SPP, PJM.
limit	integer	–	Max rows (default 50, max 500).
start	string	–	Start date YYYY-MM-DD.
zone	string	–	Optional zone/load zone filter.

No output schema declared.

No examples provided.

get_load_forecast Get load forecast ~83

Near-term ISO load forecast (MW). Not the ERCOT RT−DA price-spread forecast — use get_spread_forecast for that.

Input Output Examples

Name	Type	Req	Description
hours	integer	–	Forecast horizon in hours. Default 24.
include_recent	boolean	–	Include recent actuals alongside the forecast.
iso	string	–	ISO code. Optional for default coverage.

No output schema declared.

No examples provided.

get_queue Get interconnection queue ~143

Search generator interconnection queue projects across US ISOs/RTOs — projects waiting to connect to the grid. Filter by iso, fuel_type, status, state, or min_mw.

Input Output Examples

Name	Type	Req	Description
fuel_type	string	–	Fuel/technology filter, e.g. Solar, Wind, Storage.
iso	string	–	ISO filter, e.g. ERCOT, MISO, PJM.
limit	integer	–	Max rows (default 50, max 500).
min_mw	number	–	Minimum capacity MW.
state	string	–	US state code filter, e.g. TX.
status	string	–	Queue status filter.

No output schema declared.

No examples provided.

get_spread_forecast Get ERCOT RT−DA spread forecast ~113

Kardashev Labs live ERCOT day-ahead RT−DA price spread forecast (p10/p50/p90), issued before delivery and never revised. spread = RT − DA. Optional node_id filter (e.g. HB_BUSAVG, HB_NORTH). For scored historical performance use get_forecast_track_record.

Input Output Examples

Name	Type	Req	Description
limit	integer	–	Max rows (default 50, max 500).
node_id	string	–	ERCOT hub/node id filter, e.g. HB_BUSAVG.

No output schema declared.

No examples provided.

list_isos List covered ISOs ~55

List US ISOs/RTOs covered by Kardashev Labs and their live ingest status. Call this first to discover valid iso codes for other tools.

Input Output Examples

Name	Type	Req	Description
include_bas	boolean	–	Include smaller balancing authorities. Default false.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

13 Aug 18 Aug