DOE-MCP home

DOE-MCP demos

Explore recorded results for free, without an account or API key.

Soil carbon recovery in Kenya

Skill: trace-soil-carbon

GCAM assigns a soil carbon recovery time of 25 years to the region containing Kenya.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The regional parameter describes recovery after land-use change. It is not a measurement from a Kenyan field.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo kenya-soil --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Country regions

Coverage and source notes

economy.country_regions {"filters": {"iso": "ken"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-economy

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
isocountry_nameregion_GCAM3GCAM_region_ID
kenKenyaAfrica2

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: iso_GCAM_regID.csv
  • Title: ISO to GCAM region mapping
  • Units: NA
  • Description: Maps iso codes to GCAM regions (including composites as necessary)
  • Column types: ccci
Record sources
  • data row 114
    GCAM: Regional economics · record data row 114
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "country_regions",
    "columns": [
      "iso",
      "country_name",
      "region_GCAM3",
      "GCAM_region_ID"
    ],
    "records": [
      {
        "row_number": 114,
        "values": {
          "iso": "ken",
          "country_name": "Kenya",
          "region_GCAM3": "Africa",
          "GCAM_region_ID": "2"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
    "source_notes": [
      "File: iso_GCAM_regID.csv",
      "Title: ISO to GCAM region mapping",
      "Units: NA",
      "Description: Maps iso codes to GCAM regions (including composites as necessary)",
      "Column types: ccci",
      "----------"
    ],
    "filters": {
      "iso": "ken"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 248,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-economy",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Regional economics",
      "dataset": "iso_GCAM_regID.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 114",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-economy"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-economy"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "economy.country_regions",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Soil timescales

Coverage and source notes

land.soil_timescales {"filters": {"GCAM_region_ID": "2"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-land

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
GCAM_region_IDsoilTimeScale
225

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A_soil_time_scale_R.csv
  • Title: A_soil_tim_scale_R
  • Units: NA
  • Description: sets the number of years for soil carbon recovery following LUC
  • Original source: NA
  • Column types: ii
Record sources
  • data row 2
    GCAM: Land and agriculture · record data row 2
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "soil_timescales",
    "columns": [
      "GCAM_region_ID",
      "soilTimeScale"
    ],
    "records": [
      {
        "row_number": 2,
        "values": {
          "GCAM_region_ID": "2",
          "soilTimeScale": "25"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/aglu/A_soil_time_scale_R.csv",
    "source_notes": [
      "File: A_soil_time_scale_R.csv",
      "Title: A_soil_tim_scale_R",
      "Units: NA",
      "Description: sets the number of years for soil carbon recovery following LUC",
      "Original source: NA",
      "Column types: ii",
      "----------"
    ],
    "filters": {
      "GCAM_region_ID": "2"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 32,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-land",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Land and agriculture",
      "dataset": "A_soil_time_scale_R.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 2",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/aglu/A_soil_time_scale_R.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-land"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-land"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "land.soil_timescales",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-economy.json2026-11-10T04:46:58.414403+00:00e51120caad276d93a52d9dbf50ea2faa5c298c9ac88f17c3e5f1869be685bb78
gcam-land.json2026-11-10T04:46:57.498065+00:00d77c9781b292feb3265cabc2ffa484c7ef27dd7fe27f93f95a29115e2c693e65

Japan's geothermal supply curve

Skill: read-geothermal-grades

The second grade in GCAM's Japan curve supplies 0.56582 thermal EJ per year of heat input.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The quantity is heat input. Electrical output would also require a conversion efficiency.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo japan-geothermal --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Country regions

Coverage and source notes

economy.country_regions {"filters": {"iso": "jpn"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-economy

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
isocountry_nameregion_GCAM3GCAM_region_ID
jpnJapanJapan19

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: iso_GCAM_regID.csv
  • Title: ISO to GCAM region mapping
  • Units: NA
  • Description: Maps iso codes to GCAM regions (including composites as necessary)
  • Column types: ccci
Record sources
  • data row 112
    GCAM: Regional economics · record data row 112
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "country_regions",
    "columns": [
      "iso",
      "country_name",
      "region_GCAM3",
      "GCAM_region_ID"
    ],
    "records": [
      {
        "row_number": 112,
        "values": {
          "iso": "jpn",
          "country_name": "Japan",
          "region_GCAM3": "Japan",
          "GCAM_region_ID": "19"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
    "source_notes": [
      "File: iso_GCAM_regID.csv",
      "Title: ISO to GCAM region mapping",
      "Units: NA",
      "Description: Maps iso codes to GCAM regions (including composites as necessary)",
      "Column types: ccci",
      "----------"
    ],
    "filters": {
      "iso": "jpn"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 248,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-economy",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Regional economics",
      "dataset": "iso_GCAM_regID.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 112",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-economy"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-economy"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "economy.country_regions",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Geothermal curves

Coverage and source notes

power.geothermal_curves {"filters": {"grade": "grade 2", "region_GCAM3": "Japan"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-power

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
region_GCAM3resourcesubresourcegradeavailableextractioncost
Japangeothermalhydrothermalgrade 20.565820.569

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A16.geo_curves.csv
  • Title: Supply curves of hydrothermal geothermal resources, inherited from GCAM 3.0
  • Units: available in Thermal EJ/yr (i.e. heat input to geothermal power plants); extractioncost in 1975$/GJ
  • Description: available: quantity available; extractioncost: costs of production
  • Reference: Hannam, P., P. Kyle, and S.J. Smith. 2009. Global Deployment of Geothermal Energy Using a New Characterization in GCAM 1.0. PNNL-19231, Pacitic Northwest National Laboratory. http://www.pnl.gov/main/publications/external/technical_reports/PNNL-19231.pdf
  • Column types: ccccnn
Record sources
  • data row 18
    GCAM: Power technology · record data row 18
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "geothermal_curves",
    "columns": [
      "region_GCAM3",
      "resource",
      "subresource",
      "grade",
      "available",
      "extractioncost"
    ],
    "records": [
      {
        "row_number": 18,
        "values": {
          "region_GCAM3": "Japan",
          "resource": "geothermal",
          "subresource": "hydrothermal",
          "grade": "grade 2",
          "available": "0.56582",
          "extractioncost": "0.569"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A16.geo_curves.csv",
    "source_notes": [
      "File: A16.geo_curves.csv",
      "Title: Supply curves of hydrothermal geothermal resources, inherited from GCAM 3.0",
      "Units: available in Thermal EJ/yr (i.e. heat input to geothermal power plants); extractioncost in 1975$/GJ",
      "Description: available: quantity available; extractioncost: costs of production",
      "Reference: Hannam, P., P. Kyle, and S.J. Smith. 2009. Global Deployment of Geothermal Energy Using a New Characterization in GCAM 1.0. PNNL-19231, Pacitic Northwest National Laboratory. http://www.pnl.gov/main/publications/external/technical_reports/PNNL-19231.pdf",
      "Column types: ccccnn",
      "----------"
    ],
    "filters": {
      "grade": "grade 2",
      "region_GCAM3": "Japan"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 28,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-power",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Power technology",
      "dataset": "A16.geo_curves.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 18",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A16.geo_curves.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-power"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-power"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "power.geothermal_curves",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-economy.json2026-11-10T04:46:58.414403+00:00e51120caad276d93a52d9dbf50ea2faa5c298c9ac88f17c3e5f1869be685bb78
gcam-power.json2026-11-10T04:46:58.079479+00:007485cdd26030b7c15f0812c534223aca205cba855c96bd61c767668207b9cbc8

Power plant cooling in Western Europe

Skill: trace-plant-cooling

The model's 2020 share for recirculating freshwater cooling in Western European coal plants is 0.64.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The table covers Western Europe as a group. It cannot establish the share at German plants.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo germany-cooling --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Country regions

Coverage and source notes

economy.country_regions {"filters": {"iso": "deu"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-economy

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
isocountry_nameregion_GCAM3GCAM_region_ID
deuGermanyWestern Europe13

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: iso_GCAM_regID.csv
  • Title: ISO to GCAM region mapping
  • Units: NA
  • Description: Maps iso codes to GCAM regions (including composites as necessary)
  • Column types: ccci
Record sources
  • data row 58
    GCAM: Regional economics · record data row 58
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "country_regions",
    "columns": [
      "iso",
      "country_name",
      "region_GCAM3",
      "GCAM_region_ID"
    ],
    "records": [
      {
        "row_number": 58,
        "values": {
          "iso": "deu",
          "country_name": "Germany",
          "region_GCAM3": "Western Europe",
          "GCAM_region_ID": "13"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
    "source_notes": [
      "File: iso_GCAM_regID.csv",
      "Title: ISO to GCAM region mapping",
      "Units: NA",
      "Description: Maps iso codes to GCAM regions (including composites as necessary)",
      "Column types: ccci",
      "----------"
    ],
    "filters": {
      "iso": "deu"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 248,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-economy",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Regional economics",
      "dataset": "iso_GCAM_regID.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 58",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-economy"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-economy"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "economy.country_regions",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Cooling shares

Coverage and source notes

water.cooling_shares {"filters": {"cooling_system": "recirculating", "plant_type": "coal", "region_GCAM3": "Western Europe", "water_type": "fresh"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-water

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
region_GCAM3plant_typecooling_systemwater_type1971200520102015201720202100
Western Europecoalrecirculatingfresh0.6956365380.6956365380.6956365380.6956365380.6956365380.640.64

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A23.CoolingSystemShares_RG3.csv
  • Title: Cooling system shares for GCAM3 regions
  • Units: Unitless
  • Source: Various sources. USA values are from UCS data. WEUR future are from Schakel inventory.
  • Column types: ccccnnnnnnn
Record sources
  • data row 57
    GCAM: Water use · record data row 57
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "cooling_shares",
    "columns": [
      "region_GCAM3",
      "plant_type",
      "cooling_system",
      "water_type",
      "1971",
      "2005",
      "2010",
      "2015",
      "2017",
      "2020",
      "2100"
    ],
    "records": [
      {
        "row_number": 57,
        "values": {
          "region_GCAM3": "Western Europe",
          "plant_type": "coal",
          "cooling_system": "recirculating",
          "water_type": "fresh",
          "1971": "0.695636538",
          "2005": "0.695636538",
          "2010": "0.695636538",
          "2015": "0.695636538",
          "2017": "0.695636538",
          "2020": "0.64",
          "2100": "0.64"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/water/A23.CoolingSystemShares_RG3.csv",
    "source_notes": [
      "File: A23.CoolingSystemShares_RG3.csv",
      "Title: Cooling system shares for GCAM3 regions",
      "Units: Unitless",
      "Source: Various sources. USA values are from UCS data. WEUR future are from Schakel inventory.",
      "Column types: ccccnnnnnnn",
      "----------"
    ],
    "filters": {
      "plant_type": "coal",
      "cooling_system": "recirculating",
      "water_type": "fresh",
      "region_GCAM3": "Western Europe"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 378,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-water",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Water use",
      "dataset": "A23.CoolingSystemShares_RG3.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 57",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/water/A23.CoolingSystemShares_RG3.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-water"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-water"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "water.cooling_shares",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-economy.json2026-11-10T04:46:58.414403+00:00e51120caad276d93a52d9dbf50ea2faa5c298c9ac88f17c3e5f1869be685bb78
gcam-water.json2026-11-10T04:46:57.016956+00:00ecd273d3b6eeea1cd569b2b70ef51ca0ef203bb2233d4c32f4eebab9c2947869

Brazil's bioenergy preference

Skill: trace-bioenergy-support

GCAM assigns Brazil the bioenergy supply preference “High”.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The table adjusts model share weights. Its category does not identify a subsidy or its size.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo brazil-bioenergy --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Country regions

Coverage and source notes

economy.country_regions {"filters": {"iso": "bra"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-economy

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
isocountry_nameregion_GCAM3GCAM_region_ID
braBrazilLatin America7

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: iso_GCAM_regID.csv
  • Title: ISO to GCAM region mapping
  • Units: NA
  • Description: Maps iso codes to GCAM regions (including composites as necessary)
  • Column types: ccci
Record sources
  • data row 31
    GCAM: Regional economics · record data row 31
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "country_regions",
    "columns": [
      "iso",
      "country_name",
      "region_GCAM3",
      "GCAM_region_ID"
    ],
    "records": [
      {
        "row_number": 31,
        "values": {
          "iso": "bra",
          "country_name": "Brazil",
          "region_GCAM3": "Latin America",
          "GCAM_region_ID": "7"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
    "source_notes": [
      "File: iso_GCAM_regID.csv",
      "Title: ISO to GCAM region mapping",
      "Units: NA",
      "Description: Maps iso codes to GCAM regions (including composites as necessary)",
      "Column types: ccci",
      "----------"
    ],
    "filters": {
      "iso": "bra"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 248,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-economy",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Regional economics",
      "dataset": "iso_GCAM_regID.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 31",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-economy"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-economy"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "economy.country_regions",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Bioenergy preferences

Coverage and source notes

land.bioenergy_preferences {"filters": {"GCAM_region_ID": "7"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-land

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
GCAM_region_IDregionpreferencepreference_alternative
7BrazilHighHigh

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A_biomassSupplyShare_R.csv
  • Title: Whether a region currently has bioenergy supports
  • Units: NA
  • Comments: These data include preference assumptions to adjust supply side share weights, possibly by region. Regions not included here are set to USA's value. Only the preference column is used
  • Source: NA
  • Column types: iccc
Record sources
  • data row 7
    GCAM: Land and agriculture · record data row 7
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "bioenergy_preferences",
    "columns": [
      "GCAM_region_ID",
      "region",
      "preference",
      "preference_alternative"
    ],
    "records": [
      {
        "row_number": 7,
        "values": {
          "GCAM_region_ID": "7",
          "region": "Brazil",
          "preference": "High",
          "preference_alternative": "High"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/aglu/A_biomassSupplyShare_R.csv",
    "source_notes": [
      "File: A_biomassSupplyShare_R.csv",
      "Title: Whether a region currently has bioenergy supports",
      "Units: NA",
      "Comments: These data include preference assumptions to adjust supply side share weights, possibly by region. Regions not included here are set to USA's value. Only the preference column is used",
      "Source: NA",
      "Column types: iccc",
      "----------"
    ],
    "filters": {
      "GCAM_region_ID": "7"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 32,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-land",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Land and agriculture",
      "dataset": "A_biomassSupplyShare_R.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 7",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/aglu/A_biomassSupplyShare_R.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-land"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-land"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "land.bioenergy_preferences",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-economy.json2026-11-10T04:46:58.414403+00:00e51120caad276d93a52d9dbf50ea2faa5c298c9ac88f17c3e5f1869be685bb78
gcam-land.json2026-11-10T04:46:57.498065+00:00d77c9781b292feb3265cabc2ffa484c7ef27dd7fe27f93f95a29115e2c693e65

Labor mobility in Pakistan

Skill: trace-labor-mobility

Pakistan's labor supply row sets the sector mobility exponent to 2.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • An exponent controls the model's wage response. It does not count workers who changed jobs.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo pakistan-labor --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Country regions

Coverage and source notes

economy.country_regions {"filters": {"iso": "pak"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-economy

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
isocountry_nameregion_GCAM3GCAM_region_ID
pakPakistanSoutheast Asia22

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: iso_GCAM_regID.csv
  • Title: ISO to GCAM region mapping
  • Units: NA
  • Description: Maps iso codes to GCAM regions (including composites as necessary)
  • Column types: ccci
Record sources
  • data row 169
    GCAM: Regional economics · record data row 169
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "country_regions",
    "columns": [
      "iso",
      "country_name",
      "region_GCAM3",
      "GCAM_region_ID"
    ],
    "records": [
      {
        "row_number": 169,
        "values": {
          "iso": "pak",
          "country_name": "Pakistan",
          "region_GCAM3": "Southeast Asia",
          "GCAM_region_ID": "22"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
    "source_notes": [
      "File: iso_GCAM_regID.csv",
      "Title: ISO to GCAM region mapping",
      "Units: NA",
      "Description: Maps iso codes to GCAM regions (including composites as necessary)",
      "Column types: ccci",
      "----------"
    ],
    "filters": {
      "iso": "pak"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 248,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-economy",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Regional economics",
      "dataset": "iso_GCAM_regID.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 169",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-economy"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-economy"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "economy.country_regions",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Labor sectors

Coverage and source notes

economy.labor_sectors {"filters": {"GCAM_region_ID": "22"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-economy

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
GCAM_region_IDregionsupplysectoroutput.unitinput.unitregion_AgProdGrowthlogit.exponentprice.unitlogit.year.filloutlogit.type
22PakistanLabor_Totalmil persmil persHigh21990$/pers1975Unknown

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A_labor_supply_sector.csv
  • Title: logit exponent in labor supply
  • Units: NA
  • Comments: regional assumpations for labor productivity growth and mobility
  • region_AgProdGrowth defines ag labor productivity scaling relative to land productivity:
  • Low = 2X (mature economies), Med = 3X (transitional), High = 4X (structural transformation)
  • logit_exponent controls labor mobility across sectors; higher values increase wage responsiveness.
  • High-growth regions (e.g., India, Pakistan, parts of Africa) use higher responsiveness (1.25)
  • Applied consistently across SSPs under CMP-411
  • Source: NA
  • Column types: icccccncic
Record sources
  • data row 22
    GCAM: Regional economics · record data row 22
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "labor_sectors",
    "columns": [
      "GCAM_region_ID",
      "region",
      "supplysector",
      "output.unit",
      "input.unit",
      "region_AgProdGrowth",
      "logit.exponent",
      "price.unit",
      "logit.year.fillout",
      "logit.type"
    ],
    "records": [
      {
        "row_number": 22,
        "values": {
          "GCAM_region_ID": "22",
          "region": "Pakistan",
          "supplysector": "Labor_Total",
          "output.unit": "mil pers",
          "input.unit": "mil pers",
          "region_AgProdGrowth": "High",
          "logit.exponent": "2",
          "price.unit": "1990$/pers",
          "logit.year.fillout": "1975",
          "logit.type": null
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/socioeconomics/A_labor_supply_sector.csv",
    "source_notes": [
      "File: A_labor_supply_sector.csv",
      "Title: logit exponent in labor supply",
      "Units: NA",
      "Comments: regional assumpations for labor productivity growth and mobility",
      "region_AgProdGrowth defines ag labor productivity scaling relative to land productivity:",
      "Low = 2X (mature economies), Med = 3X (transitional), High = 4X (structural transformation)",
      "logit_exponent controls labor mobility across sectors; higher values increase wage responsiveness.",
      "High-growth regions (e.g., India, Pakistan, parts of Africa) use higher responsiveness (1.25)",
      "Applied consistently across SSPs under CMP-411",
      "Source: NA",
      "Column types: icccccncic",
      "----------"
    ],
    "filters": {
      "GCAM_region_ID": "22"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 32,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-economy",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Regional economics",
      "dataset": "A_labor_supply_sector.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 22",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/socioeconomics/A_labor_supply_sector.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-economy"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-economy"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "economy.labor_sectors",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-economy.json2026-11-10T04:46:58.414403+00:00e51120caad276d93a52d9dbf50ea2faa5c298c9ac88f17c3e5f1869be685bb78

The energy cost of reverse osmosis

Skill: separate-desalination-inputs

For 2100 the reverse osmosis inputs are 0.0063 GJ of electricity and 0.38 in 1975 US dollars per cubic metre.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • These inputs have different units. Converting them to a total cost requires an electricity price.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo desalination-inputs --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Desalination inputs

Coverage and source notes

water.desalination_inputs {"filters": {"minicam.energy.input": "elect_td_ind", "technology": "reverse osmosis"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-water

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
supplysectorsubsectortechnologyminicam.energy.input1971201520172100
desalinated waterelectricityreverse osmosiselect_td_ind0.04320.00990.00990.0063

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A71.globaltech_coef.csv
  • Title: Desalination energy-for-water coefficients
  • Units: GJ of energy per cubic meter of water (GJ/m3)
  • Source: Liu et al. 2016. DOI: 10.1021/acs.est.6b01065
  • Column types: ccccnnnn
Record sources
  • data row 1
    GCAM: Water use · record data row 1
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "desalination_inputs",
    "columns": [
      "supplysector",
      "subsector",
      "technology",
      "minicam.energy.input",
      "1971",
      "2015",
      "2017",
      "2100"
    ],
    "records": [
      {
        "row_number": 1,
        "values": {
          "supplysector": "desalinated water",
          "subsector": "electricity",
          "technology": "reverse osmosis",
          "minicam.energy.input": "elect_td_ind",
          "1971": "0.0432",
          "2015": "0.0099",
          "2017": "0.0099",
          "2100": "0.0063"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/water/A71.globaltech_coef.csv",
    "source_notes": [
      "File: A71.globaltech_coef.csv",
      "Title: Desalination energy-for-water coefficients",
      "Units: GJ of energy per cubic meter of water (GJ/m3)",
      "Source: Liu et al. 2016. DOI: 10.1021/acs.est.6b01065",
      "Column types: ccccnnnn"
    ],
    "filters": {
      "technology": "reverse osmosis",
      "minicam.energy.input": "elect_td_ind"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 6,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-water",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Water use",
      "dataset": "A71.globaltech_coef.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 1",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/water/A71.globaltech_coef.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-water"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-water"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "water.desalination_inputs",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Desalination costs

Coverage and source notes

water.desalination_costs {"filters": {"technology": "reverse osmosis"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-water

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
supplysectorsubsectortechnologyminicam.non.energy.input19712100
desalinated waterelectricityreverse osmosisnon-energy0.380.38

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A71.globaltech_cost.csv
  • Title: Desalination non-energy costs
  • Units: 1975$ per cubic meter of desalinated water (1975$/m3)
  • Source: RO tech cost estimated as total costs (about $2400/acre-foot, in 2016 dollars) minus fuel costs (36%), from CA Dept of Water Resources 2016. https://water.ca.gov/-/media/DWR-Website/Web-Pages/Programs/California-Water-Plan/Docs/RMS/2016/09_Desalination_July2016.pdf
  • Column types: ccccnn
Record sources
  • data row 1
    GCAM: Water use · record data row 1
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "desalination_costs",
    "columns": [
      "supplysector",
      "subsector",
      "technology",
      "minicam.non.energy.input",
      "1971",
      "2100"
    ],
    "records": [
      {
        "row_number": 1,
        "values": {
          "supplysector": "desalinated water",
          "subsector": "electricity",
          "technology": "reverse osmosis",
          "minicam.non.energy.input": "non-energy",
          "1971": "0.38",
          "2100": "0.38"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/water/A71.globaltech_cost.csv",
    "source_notes": [
      "File: A71.globaltech_cost.csv",
      "Title: Desalination non-energy costs",
      "Units: 1975$ per cubic meter of desalinated water (1975$/m3)",
      "Source: RO tech cost estimated as total costs (about $2400/acre-foot, in 2016 dollars) minus fuel costs (36%), from CA Dept of Water Resources 2016. https://water.ca.gov/-/media/DWR-Website/Web-Pages/Programs/California-Water-Plan/Docs/RMS/2016/09_Desalination_July2016.pdf",
      "Column types: ccccnn"
    ],
    "filters": {
      "technology": "reverse osmosis"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 3,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-water",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Water use",
      "dataset": "A71.globaltech_cost.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 1",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/water/A71.globaltech_cost.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-water"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-water"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "water.desalination_costs",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-water.json2026-11-10T04:46:57.016956+00:00ecd273d3b6eeea1cd569b2b70ef51ca0ef203bb2233d4c32f4eebab9c2947869

Compare two fluorinated gases

Skill: compare-model-warming-potentials

GCAM uses 100-year warming potentials of 1430 for HFC134a and 7390 for CF4.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The source identifies the 2007 IPCC assessment. These factors alone do not quantify emissions.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo fluorinated-gases --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Warming potentials

Coverage and source notes

emissions.warming_potentials {"filters": {"Gas": "HFC134a"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-emissions

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
GasHFC_PFCGWP
HFC134aHFC1430

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A41.GWP.csv
  • Title: Global warming potential values for fgases
  • Units: tonnes
  • Source: 2007 IPCC AR4 p212
  • Description: The global warming potential of Fgases over a 100-year time horizon
  • Column types: cci
Record sources
  • data row 4
    GCAM: Emissions · record data row 4
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "warming_potentials",
    "columns": [
      "Gas",
      "HFC_PFC",
      "GWP"
    ],
    "records": [
      {
        "row_number": 4,
        "values": {
          "Gas": "HFC134a",
          "HFC_PFC": "HFC",
          "GWP": "1430"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/emissions/A41.GWP.csv",
    "source_notes": [
      "File: A41.GWP.csv",
      "Title: Global warming potential values for fgases",
      "Units: tonnes",
      "Source: 2007 IPCC AR4 p212",
      "Description: The global warming potential of Fgases over a 100-year time horizon",
      "Column types: cci",
      "----------"
    ],
    "filters": {
      "Gas": "HFC134a"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 14,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-emissions",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Emissions",
      "dataset": "A41.GWP.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 4",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/emissions/A41.GWP.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-emissions"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-emissions"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "emissions.warming_potentials",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Warming potentials

Coverage and source notes

emissions.warming_potentials {"filters": {"Gas": "CF4"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-emissions

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
GasHFC_PFCGWP
CF4PFC7390

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A41.GWP.csv
  • Title: Global warming potential values for fgases
  • Units: tonnes
  • Source: 2007 IPCC AR4 p212
  • Description: The global warming potential of Fgases over a 100-year time horizon
  • Column types: cci
Record sources
  • data row 2
    GCAM: Emissions · record data row 2
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "warming_potentials",
    "columns": [
      "Gas",
      "HFC_PFC",
      "GWP"
    ],
    "records": [
      {
        "row_number": 2,
        "values": {
          "Gas": "CF4",
          "HFC_PFC": "PFC",
          "GWP": "7390"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/emissions/A41.GWP.csv",
    "source_notes": [
      "File: A41.GWP.csv",
      "Title: Global warming potential values for fgases",
      "Units: tonnes",
      "Source: 2007 IPCC AR4 p212",
      "Description: The global warming potential of Fgases over a 100-year time horizon",
      "Column types: cci",
      "----------"
    ],
    "filters": {
      "Gas": "CF4"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 14,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-emissions",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Emissions",
      "dataset": "A41.GWP.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "cache",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 2",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/emissions/A41.GWP.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-emissions"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-emissions"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "emissions.warming_potentials",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-emissions.json2026-11-10T04:46:57.828491+00:007f582259a874c533a6fe55f65d0c2e0936e84ea1c500e9f9b7b186868315bacd

Two offshore wind assumptions

Skill: separate-offshore-wind-classes

Wind class c7 has a capacity factor of 0.4. The deep-water capital cost input is 1370 in 1975 dollars per GJ.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Wind class and depth class are separate dimensions. Neither table locates a project or predicts its output.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo offshore-wind --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Wind capacity factors

Coverage and source notes

power.wind_capacity_factors {"filters": {"wind_class": "c7"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-power

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
wind_classCF
c70.4

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A20.wind_class_CFs.csv
  • Title: Capacity factor assumptions for global offshore wind classes
  • Units: Unitless
  • Source: Eurek et. al (2017); https://doi.org/10.1016/j.eneco.2016.11.015; raw data at https://catalog.data.gov/dataset/global-cfdda-based-onshore-and-offshore-wind-potential-supply-curves-by-country-class-and-
  • Column types: cn
Record sources
  • data row 7
    GCAM: Power technology · record data row 7
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "wind_capacity_factors",
    "columns": [
      "wind_class",
      "CF"
    ],
    "records": [
      {
        "row_number": 7,
        "values": {
          "wind_class": "c7",
          "CF": "0.4"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A20.wind_class_CFs.csv",
    "source_notes": [
      "File: A20.wind_class_CFs.csv",
      "Title: Capacity factor assumptions for global offshore wind classes",
      "Units: Unitless",
      "Source: Eurek et. al (2017); https://doi.org/10.1016/j.eneco.2016.11.015; raw data at https://catalog.data.gov/dataset/global-cfdda-based-onshore-and-offshore-wind-potential-supply-curves-by-country-class-and-",
      "Column types: cn",
      "----------"
    ],
    "filters": {
      "wind_class": "c7"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 9,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-power",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Power technology",
      "dataset": "A20.wind_class_CFs.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 7",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A20.wind_class_CFs.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-power"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-power"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "power.wind_capacity_factors",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Offshore depth costs

Coverage and source notes

power.offshore_depth_costs {"filters": {"depth_class": "deep"}, "rows": 2}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: gcam-power

  • This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.
ReturnedTotal matches
11
GCAM v9.1
depth_classcapital.overnight
deep1370

GCAM data system, Copyright 2019 Battelle Memorial Institute. Educational Community License 2.0.

Publisher table notes and units
  • File: A20.offshore_wind_depth_cap_cost.csv
  • Title: Depth class and capital cost for offshore wind
  • Units: 1975$ per GJ
  • Comments: Depth class-specific cost assumptions
  • Source: Based on data from the literature such as Cranmer (2017), Beiter (2016), EIA (2017), and Lazard (2016)
  • Column types: ci
Record sources
  • data row 3
    GCAM: Power technology · record data row 3
    Publisher record
    Record date: Unknown
Full response and evidence
{
  "data": {
    "table": "offshore_depth_costs",
    "columns": [
      "depth_class",
      "capital.overnight"
    ],
    "records": [
      {
        "row_number": 3,
        "values": {
          "depth_class": "deep",
          "capital.overnight": "1370"
        },
        "evidence_ref": "evidence_01"
      }
    ],
    "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A20.offshore_wind_depth_cap_cost.csv",
    "source_notes": [
      "File: A20.offshore_wind_depth_cap_cost.csv",
      "Title: Depth class and capital cost for offshore wind",
      "Units: 1975$ per GJ",
      "Comments: Depth class-specific cost assumptions",
      "Source: Based on data from the literature such as Cranmer (2017), Beiter (2016), EIA (2017), and Lazard (2016)",
      "Column types: ci",
      "----------"
    ],
    "filters": {
      "depth_class": "deep"
    },
    "offset": 0,
    "record_count": 1,
    "total_matches": 1,
    "table_rows": 3,
    "release": "GCAM v9.1"
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "gcam-power",
      "steward": "Pacific Northwest National Laboratory",
      "system": "GCAM: Power technology",
      "dataset": "A20.offshore_wind_depth_cap_cost.csv",
      "dataset_version": "GCAM v9.1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "data row 3",
      "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A20.offshore_wind_depth_cap_cost.csv",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "parse_csv",
        "empty_cell_to_null"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "gcam-power"
    ],
    "known_limitations": [
      "Rows are model inputs, not scenario outputs or measurements of current conditions.",
      "GCAM3 region labels and numeric GCAM region IDs use different groupings."
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
      "source_id": "gcam-power"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "power.offshore_depth_costs",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
gcam-power.json2026-11-10T04:46:58.079479+00:007485cdd26030b7c15f0812c534223aca205cba855c96bd61c767668207b9cbc8

DOE evidence finder

Skill: doe-literature-review

5 distinct records returned. Followed record 3484888: Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells.

Read 3 of 8,313 from OSTI.GOV Search API; 3 of 5,669 from DOE PAGES (Public Access Gateway for Energy and Science). A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • A sampled literature search is not a systematic review.
  • A common topic does not prove that a paper and dataset are linked.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo evidence --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Search literature

Coverage and source notes

research.search_literature {"query": "perovskite solar", "rows": 3}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: osti-gov-records, osti-doe-pages

  • No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.
  • No published rate limit, same as the rest of the OSTI family.
Counts reported by each collection; totals can overlap
CollectionMatchesReturned
OSTI.GOV Search API83133
DOE PAGES (Public Access Gateway for Energy and Science)56693

Publisher access recipes

  • Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells
    OSTI.GOV Search API · record 3484888
    Publisher record
    Record date: 2026-08-27T11:00:26Z
  • Semi-Transparent Perovskite Solar Cells in a Stacked Tandem Module: Cooperative Research and Development Final Report, CRADA Number CRD-19-00810
    OSTI.GOV Search API · record 3625672
    Publisher record
    Record date: 2026-09-02T10:56:05Z
  • Reducing non-radiative recombination in perovskite solar cells with a SiO2-graphene oxide buried interface layer
    OSTI.GOV Search API · record 3409109
    Publisher record
    Record date: 2026-09-18T15:49:56Z
  • Reducing non-radiative recombination in perovskite solar cells with a SiO2-graphene oxide buried interface layer
    DOE PAGES (Public Access Gateway for Energy and Science) · record 3409109
    Publisher record
    Record date: 2026-09-18T11:49:56Z
  • Direct Microscale Observation of Additive-Triggered Reduction in Tin Halide Perovskites
    DOE PAGES (Public Access Gateway for Energy and Science) · record 3818255
    Publisher record
    Record date: 2026-09-17T10:27:35Z
  • Mixed-Ligand-Driven Phase-Pure 2D Perovskite for Interfacial Passivation of Perovskite Photovoltaics
    DOE PAGES (Public Access Gateway for Energy and Science) · record 3818626
    Publisher record
    Record date: 2026-09-18T08:11:09Z
Full response and evidence
{
  "data": {
    "records": [
      {
        "id": "3484888",
        "title": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells",
        "authors": [
          "Yan, Feng [Materials Science and Engineering Program, School for Engineering of Matter, Transport and Energy, Arizona State University, Tempe, AZ, 85287]"
        ],
        "publication_date": "2026-08-26",
        "product_type": "Technical Report",
        "doi": "10.2172/3484888",
        "report_number": "EE0009833",
        "research_orgs": [
          "Univ. of Alabama, Tuscaloosa, AL (United States)",
          "Arizona State Univ., Tempe, AZ (United States)",
          "National Renewable Energy Laboratory (NREL), Golden, CO (United States)"
        ]
      },
      {
        "id": "3625672",
        "title": "Semi-Transparent Perovskite Solar Cells in a Stacked Tandem Module: Cooperative Research and Development Final Report, CRADA Number CRD-19-00810",
        "authors": [
          "Luther, Joey [National Laboratory of the Rockies, Golden, CO (United States)]",
          "Larson, Bryon [National Laboratory of the Rockies, Golden, CO (United States)]",
          "Reiter, Kyle [National Laboratory of the Rockies, Golden, CO (United States)]"
        ],
        "publication_date": "2026-08-26",
        "product_type": "Technical Report",
        "doi": "10.66816/tp5080615",
        "report_number": "NLR/TP-5F00-99345",
        "research_orgs": [
          "National Laboratory of the Rockies (NLR), Golden, CO (United States)"
        ]
      },
      {
        "id": "3409109",
        "title": "Reducing non-radiative recombination in perovskite solar cells with a SiO<sub>2</sub>-graphene oxide buried interface layer",
        "authors": [
          "Cao, Zikun [Univ. of Texas, Arlington, TX (United States); Univ. of Miami, FL (United States)]",
          "You, Shuai [National Laboratory of the Rockies (NLR), Golden, CO (United States)]",
          "Zhang, Xiyao [Univ. of Texas, Arlington, TX (United States); Univ. of Akron, OH (United States)]",
          "Liu, Lei [Univ. of Akron, OH (United States)]",
          "Zhang, Haixing [Univ. of Miami, FL (United States)]"
        ],
        "publication_date": "2026-09-01",
        "product_type": "Journal Article",
        "authors_truncated": 4,
        "doi": "10.1016/j.nanoen.2026.112209",
        "journal": "Nano Energy",
        "report_number": "NLR/JA-5900-101333",
        "research_orgs": [
          "National Laboratory of the Rockies (NLR), Golden, CO (United States)"
        ]
      },
      {
        "id": "3818255",
        "title": "Direct Microscale Observation of Additive-Triggered Reduction in Tin Halide Perovskites",
        "authors": [
          "Westbrook, Robert J. E. [University of Washington, Seattle, WA (United States)] (ORCID:0000000212030712)",
          "Taddei, Margherita [University of Washington, Seattle, WA (United States)] (ORCID:0000000341228418)",
          "Sanchez-Diaz, Jes\u00fas [Universitat Jaume, Castell\u00f3n (Spain)]",
          "Mushtaq, Tehmina [Universitat Jaume, Castell\u00f3n (Spain)]",
          "S\u00e1nchez, Rafael S [Universitat Jaume, Castell\u00f3n (Spain)] (ORCID:0000000189486120)"
        ],
        "publication_date": "2026-08-26",
        "product_type": "Journal Article",
        "authors_truncated": 4,
        "doi": "10.1021/acsenergylett.6c01751",
        "journal": "ACS Energy Letters",
        "research_orgs": [
          "University of Washington, Seattle, WA (United States)"
        ]
      },
      {
        "id": "3818626",
        "title": "Mixed-Ligand-Driven Phase-Pure 2D Perovskite for Interfacial Passivation of Perovskite Photovoltaics",
        "authors": [
          "Shih, Meng-Chen",
          "Tan, Shaun",
          "Lu, Yongli",
          "Kodalle, Tim",
          "Terlier, Tanguy"
        ],
        "publication_date": "2026-08-11",
        "product_type": "Journal Article",
        "authors_truncated": 10,
        "doi": "10.1021/jacs.6c05503",
        "journal": "Journal of the American Chemical Society",
        "research_orgs": [
          "Lawrence Berkeley National Laboratory (LBNL), Berkeley, CA (United States)"
        ]
      }
    ],
    "record_count": 5,
    "per_source": [
      {
        "source_id": "osti-gov-records",
        "system": "OSTI.GOV Search API",
        "total_matches": 8313,
        "returned": 3
      },
      {
        "source_id": "osti-doe-pages",
        "system": "DOE PAGES (Public Access Gateway for Energy and Science)",
        "total_matches": 5669,
        "returned": 3
      }
    ],
    "deduplicated_by_doi": 1
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "osti-gov-records",
      "steward": "Office of Scientific and Technical Information",
      "system": "OSTI.GOV Search API",
      "dataset": "OSTI.GOV Search API",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    },
    {
      "id": "source_02",
      "source_id": "osti-doe-pages",
      "steward": "Office of Scientific and Technical Information",
      "system": "DOE PAGES (Public Access Gateway for Energy and Science)",
      "dataset": "DOE PAGES (Public Access Gateway for Energy and Science)",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "3484888",
      "locator": "https://www.osti.gov/biblio/3484888",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-27T11:00:26Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "3625672",
      "locator": "https://www.osti.gov/biblio/3625672",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-02T10:56:05Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "3409109",
      "locator": "https://www.osti.gov/biblio/3409109",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-18T15:49:56Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_02",
      "record_id": "3409109",
      "locator": "https://www.osti.gov/biblio/3409109",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-18T11:49:56Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_02",
      "record_id": "3818255",
      "locator": "https://www.osti.gov/biblio/3818255",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-17T10:27:35Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_06",
      "source_ref": "source_02",
      "record_id": "3818626",
      "locator": "https://www.osti.gov/biblio/3818626",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-18T08:11:09Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "osti-gov-records",
      "osti-doe-pages"
    ],
    "known_limitations": [
      "A 12-month administrative embargo interval applies before an accepted manuscript appears. Recent DOE-funded work is therefore systematically absent, and an empty result for a 2026 paper means \"not yet released\", not \"does not exist\".",
      "A fulltext link is present when `has_fulltext` is true and absent otherwise; the servlet URL pattern resolves for those records only. Constructing one for a record without full text produces a dead link, so the adapter emits only what the API supplies or the manifest templates for records the API marked as having full text.",
      "An index of DOE-funded results, not of all energy research. Absence here says nothing about whether work exists; it says DOE did not fund or receive it.",
      "DOIs arrive as full https://doi.org/ URLs rather than bare DOIs, which breaks naive deduplication against OSTI.GOV records of the same work. The adapter normalizes both to a bare DOI and keeps the URL form as the locator.",
      "ScienceCinema was retired as a standalone product on 2025-09-05 and its ~3,600 multimedia items folded into this collection. Whether they can be isolated by any filter here is unverified.",
      "Sixteen times smaller than OSTI.GOV (260K against 4.38M) by design, not by omission. A literature search that finds nothing here should try OSTI.GOV before concluding anything.",
      "Some records carry future `publication_date` values, which is correct rather than a data error: OSTI accepts scheduled-publication metadata. Sorting by date puts unpublished work first unless a range is set.",
      "`product_type` filters on OSTI's own vocabulary \u2014 \"Technical Report\", \"Journal Article\" \u2014 and the value \"Dataset\" returns zero here even though datasets exist, because dataset records live in DOE Data Explorer. Checked live 2026-09-02. A caller filtering for datasets on this API gets an empty result that means \"wrong API\", not \"none\"."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.",
      "source_id": "osti-gov-records"
    },
    {
      "code": "terms_note",
      "message": "No published rate limit, same as the rest of the OSTI family.",
      "source_id": "osti-doe-pages"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.2172/3484888",
      "label": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3484888",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.66816/tp5080615",
      "label": "Semi-Transparent Perovskite Solar Cells in a Stacked Tandem Module\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3625672",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.1016/j.nanoen.2026.112209",
      "label": "Reducing non-radiative recombination in perovskite solar cells with a\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3409109",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.1021/acsenergylett.6c01751",
      "label": "Direct Microscale Observation of Additive-Triggered Reduction in Tin Halide\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3818255",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.1021/jacs.6c05503",
      "label": "Mixed-Ligand-Driven Phase-Pure 2D Perovskite for Interfacial Passivation of\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3818626",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "next_actions": [
    {
      "finding": "More matches exist than the 3 returned.",
      "suggested_capability": "literature.search",
      "reason": "Call again with a higher page number, or narrow the filters. Do not describe these as all the results."
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "research.search_literature",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Get record

Coverage and source notes

research.get_record {"collection": "literature", "record_id": "3484888"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: osti-gov-records

  • No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.

Publisher access recipes

  • Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells
    OSTI.GOV Search API · record 3484888
    Publisher record
    Record date: 2026-08-27T11:00:26Z
Full response and evidence
{
  "data": {
    "record": {
      "id": "3484888",
      "title": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells",
      "authors": [
        "Yan, Feng [Materials Science and Engineering Program, School for Engineering of Matter, Transport and Energy, Arizona State University, Tempe, AZ, 85287]"
      ],
      "publication_date": "2026-08-26",
      "product_type": "Technical Report",
      "doi": "10.2172/3484888",
      "report_number": "EE0009833",
      "research_orgs": [
        "Univ. of Alabama, Tuscaloosa, AL (United States)",
        "Arizona State Univ., Tempe, AZ (United States)",
        "National Renewable Energy Laboratory (NREL), Golden, CO (United States)"
      ],
      "description": "This Final Technical Report summarizes work completed under Award Number DEEE0009833, titled \"Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells.\" The project addressed the central technical problem that carbon-electrode perovskite solar cells (C-PSCs) can reduce electrode costs and improve environmental durability, but they have historically lagged noble-metalcontact devices due to poor carbon/perovskite contact, high carbon-electrode resistance, imperfect hole extraction, and insufficient operational stability. The Statement of Project Objectives (SOPO), therefore, required systematic engineering of thermally pressed carbon-based planar perovskite solar cells by improving the carbon/perovskite interface quality, improving carbon-electrode conductivity, and further increasing device stability. The work advanced understanding of carbon-based perovskite photovoltaics by connecting device performance to three coupled mechanisms: interfacial recombination at the perovskite/hole-transport-layer/carbon stack; lateral and vertical transport losses in carbon contacts; and instability driven by moisture, heat, illumination, ion migration, and slow/variable manufacturing steps.",
      "subjects": [
        "14 SOLAR ENERGY",
        "Perovskite Solar Cell, Carbon electrode, Efficiency, Stability"
      ],
      "sponsor_orgs": [
        "USDOE Office of Energy Efficiency and Renewable Energy (EERE), Renewable Power Office. Solar Energy Technologies Office",
        "USDOE Office of Critical Minerals and Energy Innovation (CMEI)"
      ]
    },
    "fulltext": {
      "available": true,
      "url": "https://www.osti.gov/servlets/purl/3484888",
      "doi_fallback": "https://doi.org/10.2172/3484888",
      "note": "OSTI serves the full text directly at this URL."
    }
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "osti-gov-records",
      "steward": "Office of Scientific and Technical Information",
      "system": "OSTI.GOV Search API",
      "dataset": "OSTI.GOV Search API",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": "10.2172/3484888",
        "recommended": null,
        "required": false
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "3484888",
      "locator": "https://www.osti.gov/biblio/3484888",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-27T11:00:26Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "osti-gov-records"
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.",
      "source_id": "osti-gov-records"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.2172/3484888",
      "label": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3484888",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://www.osti.gov/biblio/3484888",
      "label": "OSTI record page",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "research.get_record",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
osti-doe-pages.json2026-09-22T12:33:16.478603+00:00d985dce1d781b9a7484437ab297f66f39c5d89febdf5acc3527d09b3316e19d8
osti-gov-records.json2026-09-22T12:33:14.364511+00:00c6fd5ded484f83064397a670a15639a4c3903b1add64a6ddcb849cf6da404d17

Perovskite bibliography worksheet

Skill: genesis-build-bibliography

3 DOE PAGES records for a bibliography. The worksheet marks how many authors each catalog summary omitted.

Read 3 of 5,669 from DOE PAGES (Public Access Gateway for Energy and Science). A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Only the first DOE PAGES results page was read. No full text or citation counts were retrieved.
  • Author strings come from the catalog. Check omitted authors against the publisher before citing.

Download JSON evidenceDownload CSV evidence indexDownload worksheet CSV

Bibliography worksheet

Based on the Genesis literature-search skill. DOE-MCP builds this worksheet locally.

Each evidence ID refers to step 1 in the JSON download.
Record IDTitleListed authorsAuthors omitted by DOE-MCPPublication dateJournalDOIStep 1 evidence ID
3409109Reducing non-radiative recombination in perovskite solar cells with a SiO2-graphene oxide buried interface layerCao, Zikun [Univ. of Texas, Arlington, TX (United States); Univ. of Miami, FL (United States)]; You, Shuai [National Laboratory of the Rockies (NLR), Golden, CO (United States)]; Zhang, Xiyao [Univ. of Texas, Arlington, TX (United States); Univ. of Akron, OH (United States)]; Liu, Lei [Univ. of Akron, OH (United States)]; Zhang, Haixing [Univ. of Miami, FL (United States)]42026-08-31Nano Energy10.1016/j.nanoen.2026.112209evidence_01
3818255Direct Microscale Observation of Additive-Triggered Reduction in Tin Halide PerovskitesWestbrook, Robert J. E. [University of Washington, Seattle, WA (United States)] (ORCID:0000000212030712); Taddei, Margherita [University of Washington, Seattle, WA (United States)] (ORCID:0000000341228418); Sanchez-Diaz, Jesús [Universitat Jaume, Castellón (Spain)]; Mushtaq, Tehmina [Universitat Jaume, Castellón (Spain)]; Sánchez, Rafael S [Universitat Jaume, Castellón (Spain)] (ORCID:0000000189486120)42026-08-26ACS Energy Letters10.1021/acsenergylett.6c01751evidence_02
3818626Mixed-Ligand-Driven Phase-Pure 2D Perovskite for Interfacial Passivation of Perovskite PhotovoltaicsShih, Meng-Chen; Tan, Shaun; Lu, Yongli; Kodalle, Tim; Terlier, Tanguy102026-08-11Journal of the American Chemical Society10.1021/jacs.6c05503evidence_03
Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo bibliography --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Search literature

Coverage and source notes

research.search_literature {"public_access_only": true, "query": "perovskite solar", "rows": 3}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: osti-doe-pages

  • No published rate limit, same as the rest of the OSTI family.
  • Restricted to DOE PAGES, which holds public-access literature after a 12-month administrative embargo. Recent work is systematically absent; search without public_access_only to see the wider index.
Counts reported by each collection; totals can overlap
CollectionMatchesReturned
DOE PAGES (Public Access Gateway for Energy and Science)56693

Publisher access recipes

  • Reducing non-radiative recombination in perovskite solar cells with a SiO2-graphene oxide buried interface layer
    DOE PAGES (Public Access Gateway for Energy and Science) · record 3409109
    Publisher record
    Record date: 2026-09-18T11:49:56Z
  • Direct Microscale Observation of Additive-Triggered Reduction in Tin Halide Perovskites
    DOE PAGES (Public Access Gateway for Energy and Science) · record 3818255
    Publisher record
    Record date: 2026-09-17T10:27:35Z
  • Mixed-Ligand-Driven Phase-Pure 2D Perovskite for Interfacial Passivation of Perovskite Photovoltaics
    DOE PAGES (Public Access Gateway for Energy and Science) · record 3818626
    Publisher record
    Record date: 2026-09-18T08:11:09Z
Full response and evidence
{
  "data": {
    "records": [
      {
        "id": "3409109",
        "title": "Reducing non-radiative recombination in perovskite solar cells with a SiO<sub>2</sub>-graphene oxide buried interface layer",
        "authors": [
          "Cao, Zikun [Univ. of Texas, Arlington, TX (United States); Univ. of Miami, FL (United States)]",
          "You, Shuai [National Laboratory of the Rockies (NLR), Golden, CO (United States)]",
          "Zhang, Xiyao [Univ. of Texas, Arlington, TX (United States); Univ. of Akron, OH (United States)]",
          "Liu, Lei [Univ. of Akron, OH (United States)]",
          "Zhang, Haixing [Univ. of Miami, FL (United States)]"
        ],
        "publication_date": "2026-08-31",
        "product_type": "Journal Article",
        "authors_truncated": 4,
        "doi": "10.1016/j.nanoen.2026.112209",
        "journal": "Nano Energy",
        "report_number": "NLR/JA-5900-101333",
        "research_orgs": [
          "National Laboratory of the Rockies (NLR), Golden, CO (United States)"
        ]
      },
      {
        "id": "3818255",
        "title": "Direct Microscale Observation of Additive-Triggered Reduction in Tin Halide Perovskites",
        "authors": [
          "Westbrook, Robert J. E. [University of Washington, Seattle, WA (United States)] (ORCID:0000000212030712)",
          "Taddei, Margherita [University of Washington, Seattle, WA (United States)] (ORCID:0000000341228418)",
          "Sanchez-Diaz, Jes\u00fas [Universitat Jaume, Castell\u00f3n (Spain)]",
          "Mushtaq, Tehmina [Universitat Jaume, Castell\u00f3n (Spain)]",
          "S\u00e1nchez, Rafael S [Universitat Jaume, Castell\u00f3n (Spain)] (ORCID:0000000189486120)"
        ],
        "publication_date": "2026-08-26",
        "product_type": "Journal Article",
        "authors_truncated": 4,
        "doi": "10.1021/acsenergylett.6c01751",
        "journal": "ACS Energy Letters",
        "research_orgs": [
          "University of Washington, Seattle, WA (United States)"
        ]
      },
      {
        "id": "3818626",
        "title": "Mixed-Ligand-Driven Phase-Pure 2D Perovskite for Interfacial Passivation of Perovskite Photovoltaics",
        "authors": [
          "Shih, Meng-Chen",
          "Tan, Shaun",
          "Lu, Yongli",
          "Kodalle, Tim",
          "Terlier, Tanguy"
        ],
        "publication_date": "2026-08-11",
        "product_type": "Journal Article",
        "authors_truncated": 10,
        "doi": "10.1021/jacs.6c05503",
        "journal": "Journal of the American Chemical Society",
        "research_orgs": [
          "Lawrence Berkeley National Laboratory (LBNL), Berkeley, CA (United States)"
        ]
      }
    ],
    "record_count": 3,
    "per_source": [
      {
        "source_id": "osti-doe-pages",
        "system": "DOE PAGES (Public Access Gateway for Energy and Science)",
        "total_matches": 5669,
        "returned": 3
      }
    ]
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "osti-doe-pages",
      "steward": "Office of Scientific and Technical Information",
      "system": "DOE PAGES (Public Access Gateway for Energy and Science)",
      "dataset": "DOE PAGES (Public Access Gateway for Energy and Science)",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "3409109",
      "locator": "https://www.osti.gov/biblio/3409109",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-18T11:49:56Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "3818255",
      "locator": "https://www.osti.gov/biblio/3818255",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-17T10:27:35Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "3818626",
      "locator": "https://www.osti.gov/biblio/3818626",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-18T08:11:09Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "osti-doe-pages"
    ],
    "known_limitations": [
      "A 12-month administrative embargo interval applies before an accepted manuscript appears. Recent DOE-funded work is therefore systematically absent, and an empty result for a 2026 paper means \"not yet released\", not \"does not exist\".",
      "DOIs arrive as full https://doi.org/ URLs rather than bare DOIs, which breaks naive deduplication against OSTI.GOV records of the same work. The adapter normalizes both to a bare DOI and keeps the URL form as the locator.",
      "Sixteen times smaller than OSTI.GOV (260K against 4.38M) by design, not by omission. A literature search that finds nothing here should try OSTI.GOV before concluding anything."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit, same as the rest of the OSTI family.",
      "source_id": "osti-doe-pages"
    },
    {
      "code": "terms_note",
      "message": "Restricted to DOE PAGES, which holds public-access literature after a 12-month administrative embargo. Recent work is systematically absent; search without public_access_only to see the wider index.",
      "source_id": "osti-doe-pages"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.1016/j.nanoen.2026.112209",
      "label": "Reducing non-radiative recombination in perovskite solar cells with a\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3409109",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.1021/acsenergylett.6c01751",
      "label": "Direct Microscale Observation of Additive-Triggered Reduction in Tin Halide\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3818255",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.1021/jacs.6c05503",
      "label": "Mixed-Ligand-Driven Phase-Pure 2D Perovskite for Interfacial Passivation of\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3818626",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "next_actions": [
    {
      "finding": "More matches exist than the 3 returned.",
      "suggested_capability": "literature.search",
      "reason": "Call again with a higher page number, or narrow the filters. Do not describe these as all the results."
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "research.search_literature",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
osti-doe-pages.json2026-09-22T12:33:16.478603+00:00d985dce1d781b9a7484437ab297f66f39c5d89febdf5acc3527d09b3316e19d8

The missing Daymet date

Skill: genesis-package-weather-data

Requested 2024-12-26 through 2024-12-31. Daymet returned 5 daily maxima, ending 2024-12-30. Its leap-year calendar ends on December 30.

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Daymet models the 1 km grid cell around the requested point. These are not station readings.
  • The CSV contains only the returned dates. A missing date has no temperature value.

Download JSON evidenceDownload CSV evidence indexDownload temperatures CSVDownload Croissant metadata

The Genesis Croissant skill describes how to document a CSV. Download both files into one directory. The Croissant file names each column and gives the SHA-256 checksum of the temperature CSV.

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo daymet-calendar --output ./demo-output

1. Get daymet point

Coverage and source notes

earth.get_daymet_point {"end": "2024-12-31", "latitude": 35.9313, "longitude": -84.3104, "start": "2024-12-26", "variables": "tmax"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: ornl-daac

  • Values are modelled estimates for the 1 km cell containing the point, interpolated from ground stations. They are not a station observation and the service reports no cell centre, so a value here is the model's account of that kilometre rather than a measurement at the coordinates given.
Oak Ridge · modelled daily maximum temperature16.4312.722024-12-262024-12-30
Oak Ridge · modelled daily maximum temperature
Publisher time/date°C
2024-12-2614.51
2024-12-2712.72
2024-12-2814.22
2024-12-2915.9
2024-12-3016.43
Record sources
  • tile:11208@35.9313,-84.3104
    ORNL DAAC (Daymet, MODIS/VIIRS subsets) · record tile:11208@35.9313,-84.3104
    No publisher locator supplied
    Record date: 2024-12-26
Full response and evidence
{
  "data": {
    "latitude": 35.9313,
    "longitude": -84.3104,
    "elevation_meters": 261.0,
    "tile": "11208",
    "projected_coordinates": "1352953.24 -569846.6",
    "software_version": "All years; all variables; Daymet Software Version 4.0",
    "publisher_citation": "Thornton; M.M.; R. Shrestha; Y. Wei; P.E. Thornton; S-C. Kao; and B.E. Wilson. 2022. Daymet: Daily Surface Weather Data on a 1-km Grid for North America; Version 4 R1. ORNL DAAC; Oak Ridge; Tennessee; USA. https://doi.org/10.3334/ORNLDAAC/2129",
    "columns": [
      {
        "name": "tmax",
        "units": "deg c",
        "description": "Daily maximum 2-metre air temperature, degrees Celsius"
      }
    ],
    "days": [
      {
        "date": "2024-12-26",
        "yday": 361,
        "values": {
          "tmax": 14.51
        }
      },
      {
        "date": "2024-12-27",
        "yday": 362,
        "values": {
          "tmax": 12.72
        }
      },
      {
        "date": "2024-12-28",
        "yday": 363,
        "values": {
          "tmax": 14.22
        }
      },
      {
        "date": "2024-12-29",
        "yday": 364,
        "values": {
          "tmax": 15.9
        }
      },
      {
        "date": "2024-12-30",
        "yday": 365,
        "values": {
          "tmax": 16.43
        }
      }
    ],
    "record_count": 5,
    "requested_range": {
      "from": "2024-12-26",
      "to": "2024-12-31"
    },
    "returned_range": {
      "from": "2024-12-26",
      "to": "2024-12-30"
    },
    "calendar": "Daymet's year is always 365 days. 29 February is present and 31 December is dropped in leap years, so an annual total from a leap year is a 365-day total and the missing date is named on any answer whose range covers it.",
    "note": "Daily modelled surface weather for the 1 km cell holding this point. Precipitation is a daily total; tmax and tmin are daily extremes, so a daily mean has to be computed and is not published. For observations at a station rather than a modelled grid cell, this is the wrong source.",
    "dates_absent": [
      "2024-12-31"
    ],
    "dates_absent_note": "Daymet's year is 365 days long: 29 February is present and 31 December is dropped. The date(s) above are inside the range requested and are absent from the dataset rather than missing from this answer. An annual total for such a year is a 365-day total."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "ornl-daac",
      "steward": "Oak Ridge National Laboratory",
      "funder": "National Aeronautics and Space Administration",
      "system": "ORNL DAAC (Daymet, MODIS/VIIRS subsets)",
      "dataset": "Daymet single-pixel extraction",
      "dataset_version": "Daymet V4 R1",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "tile:11208@35.9313,-84.3104",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2024-12-26",
      "transformations": [
        "day-of-year converted to calendar date"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "ornl-daac"
    ],
    "time_range": {
      "from": "2024-12-26",
      "to": "2024-12-30"
    }
  },
  "warnings": [
    {
      "code": "derived_layer",
      "message": "Values are modelled estimates for the 1 km cell containing the point, interpolated from ground stations. They are not a station observation and the service reports no cell centre, so a value here is the model's account of that kilometre rather than a measurement at the coordinates given.",
      "source_id": "ornl-daac"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "earth.get_daymet_point",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
ornl-daac.jsonUnknown; old recording9fea63aa5e38eaa7fdf8d095bec8d6a70b291f4cc6a9751facf53548d565574a

Check a load prediction band

Skill: genesis-check-prediction-bands

The 90th percentile of the first 15 absolute errors was 62 MW. A band that far either side of the prior reading covered 7 of the next 8 readings.

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The band uses the nearest-rank percentile of earlier errors. Later readings do not set its width.
  • Coverage describes this short window. Serially related readings do not establish a future coverage guarantee.

Download JSON evidenceDownload CSV evidence indexDownload worksheet CSV

Five-minute load prediction bands

Based on the Genesis uncertainty-quantification skill. DOE-MCP builds this worksheet locally.

Each evidence ID refers to step 1 in the JSON download.
PhasePrior reading (Pacific Time)Target reading (Pacific Time)Prediction (MW)Reported load (MW)Absolute error (MW)Lower bound (MW)Upper bound (MW)Inside bandPrior evidence IDTarget evidence ID
calibration09/03/2026 00:0009/03/2026 00:056005604944UnknownUnknownUnknownevidence_01evidence_02
calibration09/03/2026 00:0509/03/2026 00:106049602425UnknownUnknownUnknownevidence_02evidence_03
calibration09/03/2026 00:1009/03/2026 00:156024600123UnknownUnknownUnknownevidence_03evidence_04
calibration09/03/2026 00:1509/03/2026 00:20600160098UnknownUnknownUnknownevidence_04evidence_05
calibration09/03/2026 00:2009/03/2026 00:256009591396UnknownUnknownUnknownevidence_05evidence_06
calibration09/03/2026 00:2509/03/2026 00:305913596956UnknownUnknownUnknownevidence_06evidence_07
calibration09/03/2026 00:3009/03/2026 00:355969600435UnknownUnknownUnknownevidence_07evidence_08
calibration09/03/2026 00:3509/03/2026 00:406004595054UnknownUnknownUnknownevidence_08evidence_09
calibration09/03/2026 00:4009/03/2026 00:455950592921UnknownUnknownUnknownevidence_09evidence_10
calibration09/03/2026 00:4509/03/2026 00:505929590722UnknownUnknownUnknownevidence_10evidence_11
calibration09/03/2026 00:5009/03/2026 00:555907586641UnknownUnknownUnknownevidence_11evidence_12
calibration09/03/2026 00:5509/03/2026 01:005866589428UnknownUnknownUnknownevidence_12evidence_13
calibration09/03/2026 01:0009/03/2026 01:055894583262UnknownUnknownUnknownevidence_13evidence_14
calibration09/03/2026 01:0509/03/2026 01:105832581220UnknownUnknownUnknownevidence_14evidence_15
calibration09/03/2026 01:1009/03/2026 01:155812582311UnknownUnknownUnknownevidence_15evidence_16
holdout09/03/2026 01:1509/03/2026 01:20582358775457615885Trueevidence_16evidence_17
holdout09/03/2026 01:2009/03/2026 01:2558775874358155939Trueevidence_17evidence_18
holdout09/03/2026 01:2509/03/2026 01:3058745866858125936Trueevidence_18evidence_19
holdout09/03/2026 01:3009/03/2026 01:35586658771158045928Trueevidence_19evidence_20
holdout09/03/2026 01:3509/03/2026 01:40587758393858155939Trueevidence_20evidence_21
holdout09/03/2026 01:4009/03/2026 01:45583958261357775901Trueevidence_21evidence_22
holdout09/03/2026 01:4509/03/2026 01:50582658012557645888Trueevidence_22evidence_23
holdout09/03/2026 01:5009/03/2026 01:55580157287357395863Falseevidence_23evidence_24
Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo load-interval-check --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Get bpa operations

Coverage and source notes

grid.get_bpa_operations {"intervals": 24}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: bpa-operations

  • Operational SCADA readings published minutes after the fact. They are situational awareness, not settled, revision-controlled or billing-quality figures, and should not be used as a system-of-record number.
BPA load · Pacific Time6049572809/03/2026 00:0009/03/2026 01:55
BPA load · Pacific Time
Publisher time/dateMW
09/03/2026 00:006005
09/03/2026 00:056049
09/03/2026 00:106024
09/03/2026 00:156001
09/03/2026 00:206009
09/03/2026 00:255913
09/03/2026 00:305969
09/03/2026 00:356004
09/03/2026 00:405950
09/03/2026 00:455929
09/03/2026 00:505907
09/03/2026 00:555866
09/03/2026 01:005894
09/03/2026 01:055832
09/03/2026 01:105812
09/03/2026 01:155823
09/03/2026 01:205877
09/03/2026 01:255874
09/03/2026 01:305866
09/03/2026 01:355877
09/03/2026 01:405839
09/03/2026 01:455826
09/03/2026 01:505801
09/03/2026 01:555728

The file ends with 12 timestamps without measurements. These trailing slots are excluded from the returned intervals.

Across the file through the latest measurement, 24 of 24 slots contain readings. Empty slots: 0.

Record sources
  • balancing_authority_interchange#09/03/2026 00:00
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:00
    No publisher locator supplied
    Record date: 09/03/2026 00:00
  • balancing_authority_interchange#09/03/2026 00:05
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:05
    No publisher locator supplied
    Record date: 09/03/2026 00:05
  • balancing_authority_interchange#09/03/2026 00:10
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:10
    No publisher locator supplied
    Record date: 09/03/2026 00:10
  • balancing_authority_interchange#09/03/2026 00:15
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:15
    No publisher locator supplied
    Record date: 09/03/2026 00:15
  • balancing_authority_interchange#09/03/2026 00:20
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:20
    No publisher locator supplied
    Record date: 09/03/2026 00:20
  • balancing_authority_interchange#09/03/2026 00:25
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:25
    No publisher locator supplied
    Record date: 09/03/2026 00:25
  • balancing_authority_interchange#09/03/2026 00:30
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:30
    No publisher locator supplied
    Record date: 09/03/2026 00:30
  • balancing_authority_interchange#09/03/2026 00:35
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:35
    No publisher locator supplied
    Record date: 09/03/2026 00:35
  • balancing_authority_interchange#09/03/2026 00:40
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:40
    No publisher locator supplied
    Record date: 09/03/2026 00:40
  • balancing_authority_interchange#09/03/2026 00:45
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:45
    No publisher locator supplied
    Record date: 09/03/2026 00:45
  • balancing_authority_interchange#09/03/2026 00:50
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:50
    No publisher locator supplied
    Record date: 09/03/2026 00:50
  • balancing_authority_interchange#09/03/2026 00:55
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 00:55
    No publisher locator supplied
    Record date: 09/03/2026 00:55
  • balancing_authority_interchange#09/03/2026 01:00
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:00
    No publisher locator supplied
    Record date: 09/03/2026 01:00
  • balancing_authority_interchange#09/03/2026 01:05
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:05
    No publisher locator supplied
    Record date: 09/03/2026 01:05
  • balancing_authority_interchange#09/03/2026 01:10
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:10
    No publisher locator supplied
    Record date: 09/03/2026 01:10
  • balancing_authority_interchange#09/03/2026 01:15
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:15
    No publisher locator supplied
    Record date: 09/03/2026 01:15
  • balancing_authority_interchange#09/03/2026 01:20
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:20
    No publisher locator supplied
    Record date: 09/03/2026 01:20
  • balancing_authority_interchange#09/03/2026 01:25
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:25
    No publisher locator supplied
    Record date: 09/03/2026 01:25
  • balancing_authority_interchange#09/03/2026 01:30
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:30
    No publisher locator supplied
    Record date: 09/03/2026 01:30
  • balancing_authority_interchange#09/03/2026 01:35
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:35
    No publisher locator supplied
    Record date: 09/03/2026 01:35
  • balancing_authority_interchange#09/03/2026 01:40
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:40
    No publisher locator supplied
    Record date: 09/03/2026 01:40
  • balancing_authority_interchange#09/03/2026 01:45
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:45
    No publisher locator supplied
    Record date: 09/03/2026 01:45
  • balancing_authority_interchange#09/03/2026 01:50
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:50
    No publisher locator supplied
    Record date: 09/03/2026 01:50
  • balancing_authority_interchange#09/03/2026 01:55
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:55
    No publisher locator supplied
    Record date: 09/03/2026 01:55
Full response and evidence
{
  "data": {
    "feed": "balancing_authority_interchange",
    "title": "BPA Balancing Authority Load & Total VER",
    "units": "MW",
    "columns": [
      "Load",
      "VER",
      "Hydro",
      "Fossil/Biomass",
      "Interchange",
      "Nuclear"
    ],
    "latest": {
      "timestamp": "09/03/2026 01:55",
      "values": {
        "Load": 5728,
        "VER": 623,
        "Hydro": 3726,
        "Fossil/Biomass": 804,
        "Interchange": 600,
        "Nuclear": 1134
      }
    },
    "intervals": [
      {
        "timestamp": "09/03/2026 00:00",
        "values": {
          "Load": 6005,
          "VER": 490,
          "Hydro": 4243,
          "Fossil/Biomass": 802,
          "Interchange": 705,
          "Nuclear": 1135
        }
      },
      {
        "timestamp": "09/03/2026 00:05",
        "values": {
          "Load": 6049,
          "VER": 488,
          "Hydro": 4216,
          "Fossil/Biomass": 802,
          "Interchange": 635,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 00:10",
        "values": {
          "Load": 6024,
          "VER": 511,
          "Hydro": 4105,
          "Fossil/Biomass": 802,
          "Interchange": 568,
          "Nuclear": 1134
        }
      },
      {
        "timestamp": "09/03/2026 00:15",
        "values": {
          "Load": 6001,
          "VER": 528,
          "Hydro": 3961,
          "Fossil/Biomass": 801,
          "Interchange": 467,
          "Nuclear": 1137
        }
      },
      {
        "timestamp": "09/03/2026 00:20",
        "values": {
          "Load": 6009,
          "VER": 542,
          "Hydro": 3982,
          "Fossil/Biomass": 801,
          "Interchange": 492,
          "Nuclear": 1137
        }
      },
      {
        "timestamp": "09/03/2026 00:25",
        "values": {
          "Load": 5913,
          "VER": 526,
          "Hydro": 3952,
          "Fossil/Biomass": 802,
          "Interchange": 543,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 00:30",
        "values": {
          "Load": 5969,
          "VER": 521,
          "Hydro": 3984,
          "Fossil/Biomass": 801,
          "Interchange": 509,
          "Nuclear": 1132
        }
      },
      {
        "timestamp": "09/03/2026 00:35",
        "values": {
          "Load": 6004,
          "VER": 522,
          "Hydro": 3989,
          "Fossil/Biomass": 800,
          "Interchange": 483,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 00:40",
        "values": {
          "Load": 5950,
          "VER": 521,
          "Hydro": 3988,
          "Fossil/Biomass": 802,
          "Interchange": 532,
          "Nuclear": 1131
        }
      },
      {
        "timestamp": "09/03/2026 00:45",
        "values": {
          "Load": 5929,
          "VER": 538,
          "Hydro": 3985,
          "Fossil/Biomass": 801,
          "Interchange": 573,
          "Nuclear": 1137
        }
      },
      {
        "timestamp": "09/03/2026 00:50",
        "values": {
          "Load": 5907,
          "VER": 590,
          "Hydro": 3950,
          "Fossil/Biomass": 802,
          "Interchange": 612,
          "Nuclear": 1137
        }
      },
      {
        "timestamp": "09/03/2026 00:55",
        "values": {
          "Load": 5866,
          "VER": 610,
          "Hydro": 3926,
          "Fossil/Biomass": 802,
          "Interchange": 650,
          "Nuclear": 1138
        }
      },
      {
        "timestamp": "09/03/2026 01:00",
        "values": {
          "Load": 5894,
          "VER": 603,
          "Hydro": 3863,
          "Fossil/Biomass": 801,
          "Interchange": 548,
          "Nuclear": 1134
        }
      },
      {
        "timestamp": "09/03/2026 01:05",
        "values": {
          "Load": 5832,
          "VER": 600,
          "Hydro": 3988,
          "Fossil/Biomass": 801,
          "Interchange": 735,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 01:10",
        "values": {
          "Load": 5812,
          "VER": 593,
          "Hydro": 3954,
          "Fossil/Biomass": 801,
          "Interchange": 709,
          "Nuclear": 1132
        }
      },
      {
        "timestamp": "09/03/2026 01:15",
        "values": {
          "Load": 5823,
          "VER": 635,
          "Hydro": 3913,
          "Fossil/Biomass": 803,
          "Interchange": 700,
          "Nuclear": 1131
        }
      },
      {
        "timestamp": "09/03/2026 01:20",
        "values": {
          "Load": 5877,
          "VER": 663,
          "Hydro": 3898,
          "Fossil/Biomass": 803,
          "Interchange": 665,
          "Nuclear": 1138
        }
      },
      {
        "timestamp": "09/03/2026 01:25",
        "values": {
          "Load": 5874,
          "VER": 682,
          "Hydro": 3895,
          "Fossil/Biomass": 803,
          "Interchange": 683,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 01:30",
        "values": {
          "Load": 5866,
          "VER": 671,
          "Hydro": 3906,
          "Fossil/Biomass": 804,
          "Interchange": 694,
          "Nuclear": 1139
        }
      },
      {
        "timestamp": "09/03/2026 01:35",
        "values": {
          "Load": 5877,
          "VER": 649,
          "Hydro": 3810,
          "Fossil/Biomass": 802,
          "Interchange": 557,
          "Nuclear": 1132
        }
      },
      {
        "timestamp": "09/03/2026 01:40",
        "values": {
          "Load": 5839,
          "VER": 654,
          "Hydro": 3793,
          "Fossil/Biomass": 802,
          "Interchange": 585,
          "Nuclear": 1134
        }
      },
      {
        "timestamp": "09/03/2026 01:45",
        "values": {
          "Load": 5826,
          "VER": 669,
          "Hydro": 3756,
          "Fossil/Biomass": 803,
          "Interchange": 579,
          "Nuclear": 1137
        }
      },
      {
        "timestamp": "09/03/2026 01:50",
        "values": {
          "Load": 5801,
          "VER": 660,
          "Hydro": 3795,
          "Fossil/Biomass": 804,
          "Interchange": 632,
          "Nuclear": 1133
        }
      },
      {
        "timestamp": "09/03/2026 01:55",
        "values": {
          "Load": 5728,
          "VER": 623,
          "Hydro": 3726,
          "Fossil/Biomass": 804,
          "Interchange": 600,
          "Nuclear": 1134
        }
      }
    ],
    "record_count": 24,
    "reported_through": "09/03/2026 01:55",
    "window": "Dates: 03Sep2026 - 10Sep2026 (last updated 9Sep2026 07:26:18) Pacific Time",
    "window_intervals": 24,
    "populated_intervals": 24,
    "gap_intervals": 0,
    "pending_intervals": 12,
    "publisher_last_updated": "9Sep2026 07:26:18",
    "timestamps": "The file uses Pacific Time. Rows may carry PDT or PST; keep the label when supplied. Last-Modified dates the file, not an individual reading.",
    "note": "Five-minute SCADA readings from BPA's balancing authority, in megawatts. VER is variable energy resources \u2014 wind and solar together. The balancing authority includes loads and resources that are not BPA's own and excludes BPA loads served by transfer, so this is not a figure for 'BPA the utility'. For hourly history, or for any other balancing authority, use energy.grid_status; BPA's EIA-930 respondent code is BPAT.",
    "pending_note": "The file ends with 12 timestamps without measurements. These trailing slots are excluded from the returned intervals."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "bpa-operations",
      "steward": "Bonneville Power Administration",
      "system": "BPA transmission operations feeds",
      "dataset": "BPA Balancing Authority Load & Total VER",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:05",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:05",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:10",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:10",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:15",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:15",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:20",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:20",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_06",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:25",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:25",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_07",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:30",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:30",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_08",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:35",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:35",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_09",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:40",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:40",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_10",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:45",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:45",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_11",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:50",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:50",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_12",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 00:55",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 00:55",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_13",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_14",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:05",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:05",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_15",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:10",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:10",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_16",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:15",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:15",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_17",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:20",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:20",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_18",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:25",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:25",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_19",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:30",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:30",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_20",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:35",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:35",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_21",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:40",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:40",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_22",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:45",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:45",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_23",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:50",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:50",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_24",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:55",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:55",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "bpa-operations"
    ],
    "time_range": {
      "from": "09/03/2026 00:00",
      "to": "09/03/2026 01:55"
    }
  },
  "warnings": [
    {
      "code": "screening_only",
      "message": "Operational SCADA readings published minutes after the fact. They are situational awareness, not settled, revision-controlled or billing-quality figures, and should not be used as a system-of-record number.",
      "source_id": "bpa-operations"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "grid.get_bpa_operations",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
bpa-operations.jsonUnknown; old recording4d69703d9b889d9a1c13fb09ec2476a79e4c0977f5f2a2b79a1fc4fd0139e394

Five-minute BPA load prediction

Skill: genesis-score-load-errors

Each prediction uses the preceding load reading. Across 11 five-minute comparisons, the mean absolute error was 28.91 MW and the root mean squared error was 36.98 MW.

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The prediction repeats the prior reading. BPA supplied the load measurements, not these predictions.
  • The scores describe this window alone. No model was trained and no prediction interval was estimated.
  • Pairs must be five minutes apart on the publisher’s Pacific clock. Blank load values do not count as zero.

Download JSON evidenceDownload CSV evidence indexDownload worksheet CSV

Five-minute load predictions and errors

Based on the Genesis uq-metrics-evaluator skill. DOE-MCP builds this worksheet locally.

Each evidence ID refers to step 1 in the JSON download.
Prior reading (Pacific Time)Target reading (Pacific Time)Prediction (MW)Reported load (MW)Prediction minus reported (MW)Prior evidence IDTarget evidence ID
09/03/2026 01:0009/03/2026 01:055894583262evidence_01evidence_02
09/03/2026 01:0509/03/2026 01:105832581220evidence_02evidence_03
09/03/2026 01:1009/03/2026 01:1558125823-11evidence_03evidence_04
09/03/2026 01:1509/03/2026 01:2058235877-54evidence_04evidence_05
09/03/2026 01:2009/03/2026 01:25587758743evidence_05evidence_06
09/03/2026 01:2509/03/2026 01:30587458668evidence_06evidence_07
09/03/2026 01:3009/03/2026 01:3558665877-11evidence_07evidence_08
09/03/2026 01:3509/03/2026 01:405877583938evidence_08evidence_09
09/03/2026 01:4009/03/2026 01:455839582613evidence_09evidence_10
09/03/2026 01:4509/03/2026 01:505826580125evidence_10evidence_11
09/03/2026 01:5009/03/2026 01:555801572873evidence_11evidence_12
Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo load-baseline --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Get bpa operations

Coverage and source notes

grid.get_bpa_operations {"intervals": 12}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: bpa-operations

  • Operational SCADA readings published minutes after the fact. They are situational awareness, not settled, revision-controlled or billing-quality figures, and should not be used as a system-of-record number.
BPA load · Pacific Time5894572809/03/2026 01:0009/03/2026 01:55
BPA load · Pacific Time
Publisher time/dateMW
09/03/2026 01:005894
09/03/2026 01:055832
09/03/2026 01:105812
09/03/2026 01:155823
09/03/2026 01:205877
09/03/2026 01:255874
09/03/2026 01:305866
09/03/2026 01:355877
09/03/2026 01:405839
09/03/2026 01:455826
09/03/2026 01:505801
09/03/2026 01:555728

The file ends with 12 timestamps without measurements. These trailing slots are excluded from the returned intervals.

Across the file through the latest measurement, 24 of 24 slots contain readings. Empty slots: 0.

Record sources
  • balancing_authority_interchange#09/03/2026 01:00
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:00
    No publisher locator supplied
    Record date: 09/03/2026 01:00
  • balancing_authority_interchange#09/03/2026 01:05
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:05
    No publisher locator supplied
    Record date: 09/03/2026 01:05
  • balancing_authority_interchange#09/03/2026 01:10
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:10
    No publisher locator supplied
    Record date: 09/03/2026 01:10
  • balancing_authority_interchange#09/03/2026 01:15
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:15
    No publisher locator supplied
    Record date: 09/03/2026 01:15
  • balancing_authority_interchange#09/03/2026 01:20
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:20
    No publisher locator supplied
    Record date: 09/03/2026 01:20
  • balancing_authority_interchange#09/03/2026 01:25
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:25
    No publisher locator supplied
    Record date: 09/03/2026 01:25
  • balancing_authority_interchange#09/03/2026 01:30
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:30
    No publisher locator supplied
    Record date: 09/03/2026 01:30
  • balancing_authority_interchange#09/03/2026 01:35
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:35
    No publisher locator supplied
    Record date: 09/03/2026 01:35
  • balancing_authority_interchange#09/03/2026 01:40
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:40
    No publisher locator supplied
    Record date: 09/03/2026 01:40
  • balancing_authority_interchange#09/03/2026 01:45
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:45
    No publisher locator supplied
    Record date: 09/03/2026 01:45
  • balancing_authority_interchange#09/03/2026 01:50
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:50
    No publisher locator supplied
    Record date: 09/03/2026 01:50
  • balancing_authority_interchange#09/03/2026 01:55
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:55
    No publisher locator supplied
    Record date: 09/03/2026 01:55
Full response and evidence
{
  "data": {
    "feed": "balancing_authority_interchange",
    "title": "BPA Balancing Authority Load & Total VER",
    "units": "MW",
    "columns": [
      "Load",
      "VER",
      "Hydro",
      "Fossil/Biomass",
      "Interchange",
      "Nuclear"
    ],
    "latest": {
      "timestamp": "09/03/2026 01:55",
      "values": {
        "Load": 5728,
        "VER": 623,
        "Hydro": 3726,
        "Fossil/Biomass": 804,
        "Interchange": 600,
        "Nuclear": 1134
      }
    },
    "intervals": [
      {
        "timestamp": "09/03/2026 01:00",
        "values": {
          "Load": 5894,
          "VER": 603,
          "Hydro": 3863,
          "Fossil/Biomass": 801,
          "Interchange": 548,
          "Nuclear": 1134
        }
      },
      {
        "timestamp": "09/03/2026 01:05",
        "values": {
          "Load": 5832,
          "VER": 600,
          "Hydro": 3988,
          "Fossil/Biomass": 801,
          "Interchange": 735,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 01:10",
        "values": {
          "Load": 5812,
          "VER": 593,
          "Hydro": 3954,
          "Fossil/Biomass": 801,
          "Interchange": 709,
          "Nuclear": 1132
        }
      },
      {
        "timestamp": "09/03/2026 01:15",
        "values": {
          "Load": 5823,
          "VER": 635,
          "Hydro": 3913,
          "Fossil/Biomass": 803,
          "Interchange": 700,
          "Nuclear": 1131
        }
      },
      {
        "timestamp": "09/03/2026 01:20",
        "values": {
          "Load": 5877,
          "VER": 663,
          "Hydro": 3898,
          "Fossil/Biomass": 803,
          "Interchange": 665,
          "Nuclear": 1138
        }
      },
      {
        "timestamp": "09/03/2026 01:25",
        "values": {
          "Load": 5874,
          "VER": 682,
          "Hydro": 3895,
          "Fossil/Biomass": 803,
          "Interchange": 683,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 01:30",
        "values": {
          "Load": 5866,
          "VER": 671,
          "Hydro": 3906,
          "Fossil/Biomass": 804,
          "Interchange": 694,
          "Nuclear": 1139
        }
      },
      {
        "timestamp": "09/03/2026 01:35",
        "values": {
          "Load": 5877,
          "VER": 649,
          "Hydro": 3810,
          "Fossil/Biomass": 802,
          "Interchange": 557,
          "Nuclear": 1132
        }
      },
      {
        "timestamp": "09/03/2026 01:40",
        "values": {
          "Load": 5839,
          "VER": 654,
          "Hydro": 3793,
          "Fossil/Biomass": 802,
          "Interchange": 585,
          "Nuclear": 1134
        }
      },
      {
        "timestamp": "09/03/2026 01:45",
        "values": {
          "Load": 5826,
          "VER": 669,
          "Hydro": 3756,
          "Fossil/Biomass": 803,
          "Interchange": 579,
          "Nuclear": 1137
        }
      },
      {
        "timestamp": "09/03/2026 01:50",
        "values": {
          "Load": 5801,
          "VER": 660,
          "Hydro": 3795,
          "Fossil/Biomass": 804,
          "Interchange": 632,
          "Nuclear": 1133
        }
      },
      {
        "timestamp": "09/03/2026 01:55",
        "values": {
          "Load": 5728,
          "VER": 623,
          "Hydro": 3726,
          "Fossil/Biomass": 804,
          "Interchange": 600,
          "Nuclear": 1134
        }
      }
    ],
    "record_count": 12,
    "reported_through": "09/03/2026 01:55",
    "window": "Dates: 03Sep2026 - 10Sep2026 (last updated 9Sep2026 07:26:18) Pacific Time",
    "window_intervals": 24,
    "populated_intervals": 24,
    "gap_intervals": 0,
    "pending_intervals": 12,
    "publisher_last_updated": "9Sep2026 07:26:18",
    "timestamps": "The file uses Pacific Time. Rows may carry PDT or PST; keep the label when supplied. Last-Modified dates the file, not an individual reading.",
    "note": "Five-minute SCADA readings from BPA's balancing authority, in megawatts. VER is variable energy resources \u2014 wind and solar together. The balancing authority includes loads and resources that are not BPA's own and excludes BPA loads served by transfer, so this is not a figure for 'BPA the utility'. For hourly history, or for any other balancing authority, use energy.grid_status; BPA's EIA-930 respondent code is BPAT.",
    "pending_note": "The file ends with 12 timestamps without measurements. These trailing slots are excluded from the returned intervals."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "bpa-operations",
      "steward": "Bonneville Power Administration",
      "system": "BPA transmission operations feeds",
      "dataset": "BPA Balancing Authority Load & Total VER",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:05",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:05",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:10",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:10",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:15",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:15",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:20",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:20",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_06",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:25",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:25",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_07",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:30",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:30",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_08",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:35",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:35",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_09",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:40",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:40",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_10",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:45",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:45",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_11",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:50",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:50",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_12",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:55",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:55",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "bpa-operations"
    ],
    "time_range": {
      "from": "09/03/2026 01:00",
      "to": "09/03/2026 01:55"
    }
  },
  "warnings": [
    {
      "code": "screening_only",
      "message": "Operational SCADA readings published minutes after the fact. They are situational awareness, not settled, revision-controlled or billing-quality figures, and should not be used as a system-of-record number.",
      "source_id": "bpa-operations"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "grid.get_bpa_operations",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
bpa-operations.jsonUnknown; old recording4d69703d9b889d9a1c13fb09ec2476a79e4c0977f5f2a2b79a1fc4fd0139e394

Soil sample field check

Skill: genesis-audit-sample-fields

Missing fields among 5 returned samples — collection date: 0; coordinate pair: 0; depth in metres: 5.

Read 5 of 188 matches. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The place filter matches text containing Washington; it does not test state boundaries.
  • Counts describe this page only. Depth counts as present if the response gives a value or a range bound in metres.

Download JSON evidenceDownload CSV evidence indexDownload worksheet CSV

Soil sample field check

Based on the Genesis data-exploration skill. DOE-MCP builds this worksheet locally.

Each evidence ID refers to step 1 in the JSON download.
Sample IDPlaceCollectedLatitudeLongitudeDepth (m)Minimum depth (m)Maximum depth (m)Step 1 evidence ID
nmdc:bsm-13-mrzb2q96USA: Columbia River, Washington2014-04-0146.372-119.272UnknownUnknownUnknownevidence_01
nmdc:bsm-13-4aw9ra87USA: Columbia River, Washington2014-04-0146.372-119.272UnknownUnknownUnknownevidence_02
nmdc:bsm-13-z9wten89USA: Columbia River, Washington2014-04-0146.372-119.272UnknownUnknownUnknownevidence_03
nmdc:bsm-13-wktc3357USA: Columbia River, Washington2014-04-0146.372-119.272UnknownUnknownUnknownevidence_04
nmdc:bsm-13-ap544f22USA: Columbia River, Washington2014-04-0146.372-119.272UnknownUnknownUnknownevidence_05
Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo soil-metadata --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Samples

Coverage and source notes

bio.search_biosamples {"ecosystem_type": "Soil", "place": "washington", "rows": 5}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: nmdc-runtime

  • No published rate limit and no data-use statement on the API itself; the data portal's usage terms were not found in a scripted read.
ReturnedTotal matches
5188
Sample metadata; no sequence data retrieved
SamplePlaceCollectedEnvironment
nmdc:bsm-13-mrzb2q96USA: Columbia River, Washington2014-04-01Environmental, Terrestrial, Soil, Sand
nmdc:bsm-13-4aw9ra87USA: Columbia River, Washington2014-04-01Environmental, Terrestrial, Soil, Sand
nmdc:bsm-13-z9wten89USA: Columbia River, Washington2014-04-01Environmental, Terrestrial, Soil, Sand
nmdc:bsm-13-wktc3357USA: Columbia River, Washington2014-04-01Environmental, Terrestrial, Soil, Sand
nmdc:bsm-13-ap544f22USA: Columbia River, Washington2014-04-01Environmental, Terrestrial, Soil, Sand
Record sources
  • Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_20_30
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-13-mrzb2q96
    No publisher locator supplied
    Record date: 2014-04-01
  • Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_30_40
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-13-4aw9ra87
    No publisher locator supplied
    Record date: 2014-04-01
  • Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_00_10
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-13-z9wten89
    No publisher locator supplied
    Record date: 2014-04-01
  • Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_40_50
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-13-wktc3357
    No publisher locator supplied
    Record date: 2014-04-01
  • Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N2_00_30
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-13-ap544f22
    No publisher locator supplied
    Record date: 2014-04-01
Full response and evidence
{
  "data": {
    "biosamples": [
      {
        "sample_id": "nmdc:bsm-13-mrzb2q96",
        "name": "Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_20_30",
        "studies": [
          "nmdc:sty-11-aygzgv51"
        ],
        "collected": "2014-04-01",
        "latitude": 46.372,
        "longitude": -119.272,
        "place": "USA: Columbia River, Washington",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Soil",
          "Sand"
        ],
        "env_broad_scale": "ENVO:00000873",
        "env_local_scale": "ENVO:00000022",
        "env_medium": "ENVO:01000017",
        "depth_m": null
      },
      {
        "sample_id": "nmdc:bsm-13-4aw9ra87",
        "name": "Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_30_40",
        "studies": [
          "nmdc:sty-11-aygzgv51"
        ],
        "collected": "2014-04-01",
        "latitude": 46.372,
        "longitude": -119.272,
        "place": "USA: Columbia River, Washington",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Soil",
          "Sand"
        ],
        "env_broad_scale": "ENVO:00000873",
        "env_local_scale": "ENVO:00000022",
        "env_medium": "ENVO:01000017",
        "depth_m": null
      },
      {
        "sample_id": "nmdc:bsm-13-z9wten89",
        "name": "Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_00_10",
        "studies": [
          "nmdc:sty-11-aygzgv51"
        ],
        "collected": "2014-04-01",
        "latitude": 46.372,
        "longitude": -119.272,
        "place": "USA: Columbia River, Washington",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Soil",
          "Sand"
        ],
        "env_broad_scale": "ENVO:00000873",
        "env_local_scale": "ENVO:00000022",
        "env_medium": "ENVO:01000017",
        "depth_m": null
      },
      {
        "sample_id": "nmdc:bsm-13-wktc3357",
        "name": "Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N1_40_50",
        "studies": [
          "nmdc:sty-11-aygzgv51"
        ],
        "collected": "2014-04-01",
        "latitude": 46.372,
        "longitude": -119.272,
        "place": "USA: Columbia River, Washington",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Soil",
          "Sand"
        ],
        "env_broad_scale": "ENVO:00000873",
        "env_local_scale": "ENVO:00000022",
        "env_medium": "ENVO:01000017",
        "depth_m": null
      },
      {
        "sample_id": "nmdc:bsm-13-ap544f22",
        "name": "Groundwater microbial communities from the Columbia River, Washington, USA - GW-RW N2_00_30",
        "studies": [
          "nmdc:sty-11-aygzgv51"
        ],
        "collected": "2014-04-01",
        "latitude": 46.372,
        "longitude": -119.272,
        "place": "USA: Columbia River, Washington",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Soil",
          "Sand"
        ],
        "env_broad_scale": "ENVO:00000873",
        "env_local_scale": "ENVO:00000022",
        "env_medium": "ENVO:01000017",
        "depth_m": null
      }
    ],
    "record_count": 5,
    "total_matches": 188,
    "page": 1,
    "filter_applied": {
      "ecosystem_type": {
        "$regex": "(?i)^Soil$"
      },
      "geo_loc_name.has_raw_value": {
        "$regex": "(?i)washington"
      }
    },
    "note": "Sample metadata as submitted. ecosystem_type matches NMDC's whole value without regard to case ('soil', 'Freshwater'); env_medium and place match a substring without regard to case; collected matches the start of the date as written ('2017', '2017-06'). Depth is reported only where it was stated in metres. Metadata only. Reads, assemblies and annotations are held at JGI, EMSL and the sequence archives; a study's DOIs in access_recipes lead to them and are never fetched here."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "nmdc-runtime",
      "steward": "Lawrence Berkeley National Laboratory",
      "funder": "Office of Science",
      "system": "National Microbiome Data Collaborative Runtime API",
      "dataset": "National Microbiome Data Collaborative Runtime API",
      "dataset_version": "current",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-13-mrzb2q96",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-04-01",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-13-4aw9ra87",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-04-01",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-13-z9wten89",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-04-01",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-13-wktc3357",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-04-01",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-13-ap544f22",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-04-01",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "nmdc-runtime"
    ],
    "known_limitations": [
      "Metadata, not sequence data. Reads, assemblies and annotations live in the sequence archives and at JGI, and are reached through a study's DOIs rather than through this source.",
      "Only 8 of 85 studies carry an ecosystem classification of their own; the rest are classified sample by sample. An ecosystem filter on studies therefore misses most of them, and the biosample filter is the one to use.",
      "Place is free text as submitted ('USA: Washington, Abby Road'), so a place search is a substring match and a state name may miss samples recorded only by site or coordinates.",
      "Studies NMDC has ingested, not every microbiome study. Most of the 85 are JGI or EMSL projects and a consortium study such as NEON's appears once with thousands of samples, so counts describe NMDC's holdings rather than the field."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit and no data-use statement on the API itself; the data portal's usage terms were not found in a scripted read.",
      "source_id": "nmdc-runtime"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "bio.search_biosamples",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
nmdc-runtime.json2026-10-08T23:37:56.653277+00:00a47cb8d2a0a93dcec1b30c3de2eca0769c8e5fb4fe9eca8edda61eb580432b78

Geothermal dataset-card starter

Skill: genesis-draft-dataset-card

2 metadata drafts from DOE Data Explorer. File checksums, reuse permissions and governance still need review.

Read 2 of 1,035 matches. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • A documentation starter, not a validated Genesis datacard or Croissant record.
  • Only catalog metadata was read; no dataset files were downloaded or inspected.
  • A public metadata record does not establish that the underlying data is freely accessible or licensed for reuse.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo dataset-card --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

Utah FORGE: Seismic DAS and Geophone Borehole Data Processing and 3D Imaging of Vp/Vs Ratio in the 2024 Stimulated Reservoir

Draft metadata only — not schema validated
Catalog fieldValue
id2541598
titleUtah FORGE: Seismic DAS and Geophone Borehole Data Processing and 3D Imaging of Vp/Vs Ratio in the 2024 Stimulated Reservoir
authorsGritto, Roland [EMR Solutions and Technology] (ORCID:0000000320927201), Jarpe, Steve P. (ORCID:0009000493428416)
publication_date2025-03-16
product_typeDataset
doi10.15121/2541598
research_orgsDOE Geothermal Data Repository, EMR Solutions and Technology
site_codeDOE-GDR

Still needs owner review

  • Downloadable files and access conditions
  • File formats, sizes and checksums
  • License and permitted reuse
  • Sensitivity and governance review
  • Data quality and suitability for AI use

Utah FORGE: Well 16B(78)-32 DTS, RFS DSS Strain, and Absolute Strain Circulation Test Fiber Optic Data - August 2024

Draft metadata only — not schema validated
Catalog fieldValue
id2531108
titleUtah FORGE: Well 16B(78)-32 DTS, RFS DSS Strain, and Absolute Strain Circulation Test Fiber Optic Data - August 2024
authorsJurick, Dana [Neubrex Energy Services (US), LLC], Khatara, Sajan, Guzik, Artur
publication_date2024-08-29
product_typeDataset
doi10.15121/2531108
research_orgsDOE Geothermal Data Repository, Neubrex Energy Services (US), LLC
site_codeDOE-GDR

Still needs owner review

  • Downloadable files and access conditions
  • File formats, sizes and checksums
  • License and permitted reuse
  • Sensitivity and governance review
  • Data quality and suitability for AI use

1. Search datasets

Coverage and source notes

research.search_datasets {"rows": 2, "site_code": "DOE-GDR"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: osti-data-explorer

  • No published rate limit, same as the rest of the OSTI family.
  • Dataset discovery returns catalog metadata, not measurements. For user-facility raw data — beamlines, reactors, tokamaks — there is generally nothing to find: that data is proposal-gated by design and is not a coverage gap here.
ReturnedTotal matches
21035

Publisher access recipes

  • Utah FORGE: Seismic DAS and Geophone Borehole Data Processing and 3D Imaging of Vp/Vs Ratio in the 2024 Stimulated Reservoir
    DOE Data Explorer · record 2541598
    Publisher record
    Record date: 2025-03-31T19:08:19Z
  • Utah FORGE: Well 16B(78)-32 DTS, RFS DSS Strain, and Absolute Strain Circulation Test Fiber Optic Data - August 2024
    DOE Data Explorer · record 2531108
    Publisher record
    Record date: 2025-03-18T18:40:22Z
Full response and evidence
{
  "data": {
    "datasets": [
      {
        "id": "2541598",
        "title": "Utah FORGE: Seismic DAS and Geophone Borehole Data Processing and 3D Imaging of Vp/Vs Ratio in the 2024 Stimulated Reservoir",
        "authors": [
          "Gritto, Roland [EMR Solutions and Technology] (ORCID:0000000320927201)",
          "Jarpe, Steve P. (ORCID:0009000493428416)"
        ],
        "publication_date": "2025-03-16",
        "product_type": "Dataset",
        "doi": "10.15121/2541598",
        "research_orgs": [
          "DOE Geothermal Data Repository",
          "EMR Solutions and Technology"
        ],
        "site_code": "DOE-GDR"
      },
      {
        "id": "2531108",
        "title": "Utah FORGE: Well 16B(78)-32 DTS, RFS DSS Strain, and Absolute Strain Circulation Test Fiber Optic Data - August 2024",
        "authors": [
          "Jurick, Dana [Neubrex Energy Services (US), LLC]",
          "Khatara, Sajan",
          "Guzik, Artur"
        ],
        "publication_date": "2024-08-29",
        "product_type": "Dataset",
        "doi": "10.15121/2531108",
        "research_orgs": [
          "DOE Geothermal Data Repository",
          "Neubrex Energy Services (US), LLC"
        ],
        "site_code": "DOE-GDR"
      }
    ],
    "record_count": 2,
    "total_matches": 1035,
    "note": "These are metadata records pointing at data held elsewhere. DOE Data Explorer hosts nothing itself: use the DOI or landing page in access_recipes to reach the actual data, and expect some repositories to require an account this record does not mention."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "osti-data-explorer",
      "steward": "Office of Scientific and Technical Information",
      "system": "DOE Data Explorer",
      "dataset": "DOE Data Explorer",
      "dataset_version": "current",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "2541598",
      "locator": "https://www.osti.gov/dataexplorer/biblio/2541598",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2025-03-31T19:08:19Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "2531108",
      "locator": "https://www.osti.gov/dataexplorer/biblio/2531108",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2025-03-18T18:40:22Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "osti-data-explorer"
    ],
    "known_limitations": [
      "A record's `site_url` points wherever the submitting repository said, and that host is outside this source's egress allowlist. The URL is returned as data and never fetched.",
      "Coverage depends on submission. A repository that never registered its datasets with OSTI is invisible here however public it is, so an empty result is a statement about registration, not about existence.",
      "Points at data, never holds it. A DDE record answers \"where is this dataset and what is its DOI\"; reaching the bytes is a second step, and one that may need an account the record does not mention.",
      "`site_ownership_code` is the field that makes single-repository views possible (DOE-GDR returns 1,035 records, checked live 2026-09-02) but its vocabulary is OSTI's own and is not published as an enumerable list. Codes are discovered from returned records, not from a dictionary."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit, same as the rest of the OSTI family.",
      "source_id": "osti-data-explorer"
    },
    {
      "code": "derived_layer",
      "message": "Dataset discovery returns catalog metadata, not measurements. For user-facility raw data \u2014 beamlines, reactors, tokamaks \u2014 there is generally nothing to find: that data is proposal-gated by design and is not a coverage gap here.",
      "source_id": "osti-data-explorer"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.15121/2541598",
      "label": "Utah FORGE: Seismic DAS and Geophone Borehole Data Processing and 3D Imaging\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/dataexplorer/servlets/purl/2541598",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://gdr.openei.org/submissions/1723",
      "label": "Dataset landing page",
      "instructions": "The repository that actually holds this data. It may require an account the catalog record does not mention.",
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.15121/2531108",
      "label": "Utah FORGE: Well 16B(78)-32 DTS, RFS DSS Strain, and Absolute Strain\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/dataexplorer/servlets/purl/2531108",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://gdr.openei.org/submissions/1721",
      "label": "Dataset landing page",
      "instructions": "The repository that actually holds this data. It may require an account the catalog record does not mention.",
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "research.search_datasets",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
osti-data-explorer.jsonUnknown; old recording71a7e71e7056856c76fcebc8d0234e049c0109bd35e2b1777768e408072ad398

Microbiome study and sample finder

Skill: microbiome-data-finder

Followed one returned study. Showing 5 biosamples out of 23 matches.

Read 1 of 1 match. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Study and sample metadata only; no sequences, assemblies or annotations were downloaded.
  • At most five samples are shown; they do not establish study completeness or biological function.
  • The publisher's access recipes distinguish dataset DOIs from award DOIs; a DOI alone does not establish free access.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo microbiome --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Study

Coverage and source notes

bio.search_studies {"text": "shale"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: nmdc-runtime

  • No published rate limit and no data-use statement on the API itself; the data portal's usage terms were not found in a scripted read.
ReturnedTotal matches
11

Publisher access recipes

  • Deep subsurface shale carbon reservoir microbial communities from Ohio and West Virginia, USA
    National Microbiome Data Collaborative Runtime API · record nmdc:sty-11-8fb6t785
    No publisher locator supplied
    Record date: Unknown
Full response and evidence
{
  "data": {
    "studies": [
      {
        "study_id": "nmdc:sty-11-8fb6t785",
        "name": "Deep subsurface shale carbon reservoir microbial communities from Ohio and West Virginia, USA",
        "title": "Deep subsurface shale carbon reservoir microbial communities from Ohio and West Virginia, USA",
        "category": "research_study",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Deep subsurface"
        ],
        "description": "This project aims to improve the understanding of microbial diversity and metabolism in deep shale, with implications for novel enzyme discovery and energy development. This project was conducted along two Appalachian basin shales, the Marcellus and Utica/Point Pleasant formations in Pennsylvania and Ohio, respectively. Samples were collected from input and produced fluids up to a year after hydra\u2026",
        "investigators": [
          {
            "name": "Kelly Wrighton",
            "orcid": "orcid:0000-0003-0434-4217"
          },
          {
            "name": "Rebecca Daly",
            "orcid": "orcid:0000-0003-2223-7458"
          },
          {
            "name": "Mikayla Borton",
            "orcid": "orcid:0000-0001-8037-4253"
          },
          {
            "name": "Michael Wilkins",
            "orcid": "orcid:0000-0002-3595-0853"
          },
          {
            "name": "David Hoyt",
            "orcid": "orcid:0000-0002-2857-719X"
          }
        ],
        "dois": [
          {
            "doi": "10.25585/1487763",
            "category": "dataset_doi",
            "provider": "jgi"
          },
          {
            "doi": "10.46936/jejc.proj.2014.48483/60005501",
            "category": "award_doi",
            "provider": "emsl"
          }
        ],
        "part_of": []
      }
    ],
    "record_count": 1,
    "total_matches": 1,
    "studies_in_collection": 85,
    "offset": 0,
    "note": "Text matches every word in a study's name, title or description, without regard to case. Metadata only. Reads, assemblies and annotations are held at JGI, EMSL and the sequence archives; a study's DOIs in access_recipes lead to them and are never fetched here."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "nmdc-runtime",
      "steward": "Lawrence Berkeley National Laboratory",
      "funder": "Office of Science",
      "system": "National Microbiome Data Collaborative Runtime API",
      "dataset": "National Microbiome Data Collaborative Runtime API",
      "dataset_version": "current",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "nmdc:sty-11-8fb6t785",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "normalize",
        "drop_contact_details"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "nmdc-runtime"
    ],
    "known_limitations": [
      "Metadata, not sequence data. Reads, assemblies and annotations live in the sequence archives and at JGI, and are reached through a study's DOIs rather than through this source.",
      "Only 8 of 85 studies carry an ecosystem classification of their own; the rest are classified sample by sample. An ecosystem filter on studies therefore misses most of them, and the biosample filter is the one to use.",
      "Place is free text as submitted ('USA: Washington, Abby Road'), so a place search is a substring match and a state name may miss samples recorded only by site or coordinates.",
      "Studies NMDC has ingested, not every microbiome study. Most of the 85 are JGI or EMSL projects and a consortium study such as NEON's appears once with thousands of samples, so counts describe NMDC's holdings rather than the field."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit and no data-use statement on the API itself; the data portal's usage terms were not found in a scripted read.",
      "source_id": "nmdc-runtime"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.25585/1487763",
      "label": "Deep subsurface shale carbon reservoir microbial communities (dataset_doi)",
      "instructions": "Minted by jgi; returned as data and never fetched here.",
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.46936/jejc.proj.2014.48483/60005501",
      "label": "Deep subsurface shale carbon reservoir microbial communities (award_doi)",
      "instructions": "Minted by emsl; returned as data and never fetched here.",
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "bio.search_studies",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Samples

Coverage and source notes

bio.search_biosamples {"rows": 5, "study_id": "nmdc:sty-11-8fb6t785"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: nmdc-runtime

  • No published rate limit and no data-use statement on the API itself; the data portal's usage terms were not found in a scripted read.
ReturnedTotal matches
523
Sample metadata; no sequence data retrieved
SamplePlaceCollectedEnvironment
nmdc:bsm-11-gvp5zp51USA: Ohio2014-10-11Environmental, Terrestrial, Deep subsurface, Shale gas reservoir, Flow back/Produced fluids
nmdc:bsm-11-yvzvbr38USA: Ohio2014-10-10Environmental, Terrestrial, Deep subsurface, Shale gas reservoir, Flow back/Produced fluids
nmdc:bsm-11-7b566r47USA: Ohio2014-10-18Environmental, Terrestrial, Deep subsurface, Shale gas reservoir, Flow back/Produced fluids
nmdc:bsm-11-byzpm179USA: Ohio2014-10-16Environmental, Terrestrial, Deep subsurface, Shale gas reservoir, Flow back/Produced fluids
nmdc:bsm-11-kmpwgz16USA: Ohio2014-10-20Environmental, Terrestrial, Deep subsurface, Shale gas reservoir, Flow back/Produced fluids
Record sources
  • Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_11
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-11-gvp5zp51
    No publisher locator supplied
    Record date: 2014-10-11
  • Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_10
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-11-yvzvbr38
    No publisher locator supplied
    Record date: 2014-10-10
  • Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_18
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-11-7b566r47
    No publisher locator supplied
    Record date: 2014-10-18
  • Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_16
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-11-byzpm179
    No publisher locator supplied
    Record date: 2014-10-16
  • Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_20
    National Microbiome Data Collaborative Runtime API · record nmdc:bsm-11-kmpwgz16
    No publisher locator supplied
    Record date: 2014-10-20
Full response and evidence
{
  "data": {
    "biosamples": [
      {
        "sample_id": "nmdc:bsm-11-gvp5zp51",
        "name": "Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_11",
        "studies": [
          "nmdc:sty-11-8fb6t785"
        ],
        "collected": "2014-10-11",
        "latitude": 40.178,
        "longitude": -81.073,
        "place": "USA: Ohio",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Deep subsurface",
          "Shale gas reservoir",
          "Flow back/Produced fluids"
        ],
        "env_broad_scale": "ENVO:00000446",
        "env_local_scale": "ENVO:01000941",
        "env_medium": "ENVO:00002194",
        "depth_m": {
          "value": 2000.0
        }
      },
      {
        "sample_id": "nmdc:bsm-11-yvzvbr38",
        "name": "Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_10",
        "studies": [
          "nmdc:sty-11-8fb6t785"
        ],
        "collected": "2014-10-10",
        "latitude": 40.178,
        "longitude": -81.073,
        "place": "USA: Ohio",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Deep subsurface",
          "Shale gas reservoir",
          "Flow back/Produced fluids"
        ],
        "env_broad_scale": "ENVO:00000446",
        "env_local_scale": "ENVO:01000941",
        "env_medium": "ENVO:00002194",
        "depth_m": {
          "value": 2000.0
        }
      },
      {
        "sample_id": "nmdc:bsm-11-7b566r47",
        "name": "Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_18",
        "studies": [
          "nmdc:sty-11-8fb6t785"
        ],
        "collected": "2014-10-18",
        "latitude": 40.178,
        "longitude": -81.073,
        "place": "USA: Ohio",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Deep subsurface",
          "Shale gas reservoir",
          "Flow back/Produced fluids"
        ],
        "env_broad_scale": "ENVO:00000446",
        "env_local_scale": "ENVO:01000941",
        "env_medium": "ENVO:00002194",
        "depth_m": {
          "value": 2000.0
        }
      },
      {
        "sample_id": "nmdc:bsm-11-byzpm179",
        "name": "Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_16",
        "studies": [
          "nmdc:sty-11-8fb6t785"
        ],
        "collected": "2014-10-16",
        "latitude": 40.178,
        "longitude": -81.073,
        "place": "USA: Ohio",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Deep subsurface",
          "Shale gas reservoir",
          "Flow back/Produced fluids"
        ],
        "env_broad_scale": "ENVO:00000446",
        "env_local_scale": "ENVO:01000941",
        "env_medium": "ENVO:00002194",
        "depth_m": {
          "value": 2000.0
        }
      },
      {
        "sample_id": "nmdc:bsm-11-kmpwgz16",
        "name": "Deep subsurface shale carbon reservoir microbial communities from Ohio, USA - Utica-2 Time Series 2014_10_20",
        "studies": [
          "nmdc:sty-11-8fb6t785"
        ],
        "collected": "2014-10-20",
        "latitude": 40.178,
        "longitude": -81.073,
        "place": "USA: Ohio",
        "ecosystem": [
          "Environmental",
          "Terrestrial",
          "Deep subsurface",
          "Shale gas reservoir",
          "Flow back/Produced fluids"
        ],
        "env_broad_scale": "ENVO:00000446",
        "env_local_scale": "ENVO:01000941",
        "env_medium": "ENVO:00002194",
        "depth_m": {
          "value": 2000.0
        }
      }
    ],
    "record_count": 5,
    "total_matches": 23,
    "page": 1,
    "filter_applied": {
      "associated_studies": "nmdc:sty-11-8fb6t785"
    },
    "note": "Sample metadata as submitted. ecosystem_type matches NMDC's whole value without regard to case ('soil', 'Freshwater'); env_medium and place match a substring without regard to case; collected matches the start of the date as written ('2017', '2017-06'). Depth is reported only where it was stated in metres. Metadata only. Reads, assemblies and annotations are held at JGI, EMSL and the sequence archives; a study's DOIs in access_recipes lead to them and are never fetched here."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "nmdc-runtime",
      "steward": "Lawrence Berkeley National Laboratory",
      "funder": "Office of Science",
      "system": "National Microbiome Data Collaborative Runtime API",
      "dataset": "National Microbiome Data Collaborative Runtime API",
      "dataset_version": "current",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-11-gvp5zp51",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-10-11",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-11-yvzvbr38",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-10-10",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-11-7b566r47",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-10-18",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-11-byzpm179",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-10-16",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "nmdc:bsm-11-kmpwgz16",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2014-10-20",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "nmdc-runtime"
    ],
    "known_limitations": [
      "Metadata, not sequence data. Reads, assemblies and annotations live in the sequence archives and at JGI, and are reached through a study's DOIs rather than through this source.",
      "Only 8 of 85 studies carry an ecosystem classification of their own; the rest are classified sample by sample. An ecosystem filter on studies therefore misses most of them, and the biosample filter is the one to use.",
      "Place is free text as submitted ('USA: Washington, Abby Road'), so a place search is a substring match and a state name may miss samples recorded only by site or coordinates.",
      "Studies NMDC has ingested, not every microbiome study. Most of the 85 are JGI or EMSL projects and a consortium study such as NEON's appears once with thousands of samples, so counts describe NMDC's holdings rather than the field."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit and no data-use statement on the API itself; the data portal's usage terms were not found in a scripted read.",
      "source_id": "nmdc-runtime"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "bio.search_biosamples",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
nmdc-runtime.json2026-10-08T23:37:56.653277+00:00a47cb8d2a0a93dcec1b30c3de2eca0769c8e5fb4fe9eca8edda61eb580432b78

DOE rulemaking brief

Skill: doe-rulemaking-brief

Followed document 2026-17979. Publisher action: Notification of stay. Out-of-scope records excluded: 1.

Read 4 of 1,690 matches. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • A sampled Federal Register search, not a complete docket or a determination of current legal effect.
  • Publication, effective and comment-close dates are separate publisher fields; missing dates remain unknown.
  • Search totals include excluded FERC documents. Docket comments and supporting materials were not retrieved.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo rulemaking --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Search rulemakings

Coverage and source notes

docs.search_rulemakings {"document_type": "RULE", "rows": 5}

Coverage dimensionValue
registrypartial
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: federal-register-doe

ReturnedTotal matches
41690
Publisher metadata; dates do not establish current legal effect
DocumentActionPublishedEffectiveComments closeDockets
2026-17979Notification of stay.2026-09-02UnknownUnknownEERE-2026-FEMP-0067
2026-17872Final rule.2026-09-012026-10-01UnknownEERE-2025-OT-0031
2026-17381Direct final rule; further delay of effective date.2026-08-262025-05-16UnknownDOE-HQ-2025-0014
2026-16425Interim final rule; request for comments.2026-08-122026-08-122026-09-11DOE-HQ-2026-0529

total_matches is the Federal Register's own count for this query and includes the documents dropped above. 1 of the 5 on this page were dropped, so the number of DOE documents matching is lower than total_matches and this tool cannot say by how much without reading every page.

Record sources
  • Repeal of Fossil Fuel Restrictions for New Federal Buildings and Major Renovations of Federal Buildings
    Federal Register API (Department of Energy documents) · record 2026-17979
    Publisher record
    Record date: 2026-09-02
  • Rescission of Production Incentives for Cellulosic Biofuels
    Federal Register API (Department of Energy documents) · record 2026-17872
    Publisher record
    Record date: 2026-09-01
  • Rescinding Regulations for Loans for Minority Business Enterprises Seeking DOE Contracts and Assistance
    Federal Register API (Department of Energy documents) · record 2026-17381
    Publisher record
    Record date: 2026-08-26
  • Rescission of DOE's Procedures for Traffic Control on the Nevada Test Site
    Federal Register API (Department of Energy documents) · record 2026-16425
    Publisher record
    Record date: 2026-08-12
Full response and evidence
{
  "data": {
    "documents": [
      {
        "document_number": "2026-17979",
        "title": "Repeal of Fossil Fuel Restrictions for New Federal Buildings and Major Renovations of Federal Buildings",
        "type": "Rule",
        "action": "Notification of stay.",
        "abstract": "The Department of Energy (DOE) is reviewing its recent guidance related to the implementation of newly adopted provisions regarding Clean Energy for New Federal Buildings and Major Renovations of Federal Buildings (CER). While DOE reviews the CER implementation guidance, DOE is staying the compliance date for the newly adopted provisions in the Code of Federal Regulations (CFR).",
        "publication_date": "2026-09-02",
        "effective_on": null,
        "comments_close_on": null,
        "agencies": [
          "Energy Department"
        ],
        "docket_ids": [
          "EERE-2026-FEMP-0067"
        ],
        "regulation_id_numbers": [
          "1904-AG17"
        ],
        "cfr_references": [
          "10 CFR 433",
          "10 CFR 435"
        ],
        "html_url": "https://www.federalregister.gov/documents/2026/09/02/2026-17979/repeal-of-fossil-fuel-restrictions-for-new-federal-buildings-and-major-renovations-of-federal",
        "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-09-02/pdf/2026-17979.pdf",
        "full_text_url": "https://www.federalregister.gov/documents/full_text/text/2026/09/02/2026-17979.txt"
      },
      {
        "document_number": "2026-17872",
        "title": "Rescission of Production Incentives for Cellulosic Biofuels",
        "type": "Rule",
        "action": "Final rule.",
        "abstract": "The Office of Critical Minerals and Energy Innovation (formerly Office of Energy Efficiency and Renewable Energy) of the Department of Energy (DOE) is publishing a final rule to rescind the regulatory framework for production incentives for cellulosic biofuels, eliminating an inactive regulatory framework.",
        "publication_date": "2026-09-01",
        "effective_on": "2026-10-01",
        "comments_close_on": null,
        "agencies": [
          "Energy Department"
        ],
        "docket_ids": [
          "EERE-2025-OT-0031"
        ],
        "regulation_id_numbers": [
          "1904-AG07"
        ],
        "cfr_references": [
          "10 CFR 452"
        ],
        "html_url": "https://www.federalregister.gov/documents/2026/09/01/2026-17872/rescission-of-production-incentives-for-cellulosic-biofuels",
        "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-09-01/pdf/2026-17872.pdf",
        "full_text_url": "https://www.federalregister.gov/documents/full_text/text/2026/09/01/2026-17872.txt"
      },
      {
        "document_number": "2026-17381",
        "title": "Rescinding Regulations for Loans for Minority Business Enterprises Seeking DOE Contracts and Assistance",
        "type": "Rule",
        "action": "Direct final rule; further delay of effective date.",
        "abstract": "The U.S. Department of Energy (DOE) is further extending the effective date of the direct final rule \"Rescinding Regulations for Loans for Minority Business Enterprises Seeking DOE Contracts and Assistance,\" published on May 16, 2025.",
        "publication_date": "2026-08-26",
        "effective_on": "2025-05-16",
        "comments_close_on": null,
        "agencies": [
          "Energy Department"
        ],
        "docket_ids": [
          "DOE-HQ-2025-0014"
        ],
        "regulation_id_numbers": [
          "1903-AA23"
        ],
        "cfr_references": [
          "10 CFR 800"
        ],
        "html_url": "https://www.federalregister.gov/documents/2026/08/26/2026-17381/rescinding-regulations-for-loans-for-minority-business-enterprises-seeking-doe-contracts-and",
        "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-08-26/pdf/2026-17381.pdf",
        "full_text_url": "https://www.federalregister.gov/documents/full_text/text/2026/08/26/2026-17381.txt"
      },
      {
        "document_number": "2026-16425",
        "title": "Rescission of DOE's Procedures for Traffic Control on the Nevada Test Site",
        "type": "Rule",
        "action": "Interim final rule; request for comments.",
        "abstract": "This interim final rule rescinds DOE's regulations outlining the establishment of traffic control regulations on the Nevada National Security Site (NNSS), formerly known as the Nevada Test Site. This action is being taken to remove regulations that are obsolete because the NNSS uses Nevada traffic enforcement statutes. The effect of this action will be the removal of obsolete regulations.",
        "publication_date": "2026-08-12",
        "effective_on": "2026-08-12",
        "comments_close_on": "2026-09-11",
        "agencies": [
          "Energy Department"
        ],
        "docket_ids": [
          "DOE-HQ-2026-0529"
        ],
        "regulation_id_numbers": [
          "1992-AA65"
        ],
        "cfr_references": [
          "10 CFR 861"
        ],
        "html_url": "https://www.federalregister.gov/documents/2026/08/12/2026-16425/rescission-of-does-procedures-for-traffic-control-on-the-nevada-test-site",
        "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-08-12/pdf/2026-16425.pdf",
        "full_text_url": "https://www.federalregister.gov/documents/full_text/text/2026/08/12/2026-16425.txt"
      }
    ],
    "record_count": 4,
    "page": 1,
    "page_size": 5,
    "total_matches": 1690,
    "pages_reachable": 50,
    "note": "The published text of DOE's rules, proposed rules, and notices, from the Federal Register itself. Each record carries its docket id, the CFR parts it touches, its regulatory identifier, and a link to the full text. The docket's comments and supporting material are not here \u2014 those live in regulations.gov, which DOE-MCP does not yet serve.",
    "excluded_documents": 1,
    "exclusion_reason": "The Federal Register files FERC's documents under the Department of Energy's agency tree, and FERC's daily combined filing notices are most of what that tree publishes: of the documents tagged Department of Energy since 2024, FERC is 20% of rules and 26% of proposed rules but 87% of notices, 4,268 of 4,915. DOE-MCP's scope stops at DOE (decision 0001), so those documents are dropped and counted rather than served. FERC's own record is in its eLibrary system.",
    "total_matches_is_unfiltered": "total_matches is the Federal Register's own count for this query and includes the documents dropped above. 1 of the 5 on this page were dropped, so the number of DOE documents matching is lower than total_matches and this tool cannot say by how much without reading every page."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "federal-register-doe",
      "steward": "Office of the Federal Register (National Archives)",
      "system": "Federal Register API (Department of Energy documents)",
      "dataset": "Federal Register API (Department of Energy documents)",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "2026-17979",
      "locator": "https://www.federalregister.gov/documents/2026/09/02/2026-17979/repeal-of-fossil-fuel-restrictions-for-new-federal-buildings-and-major-renovations-of-federal",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-02",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "2026-17872",
      "locator": "https://www.federalregister.gov/documents/2026/09/01/2026-17872/rescission-of-production-incentives-for-cellulosic-biofuels",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-01",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "2026-17381",
      "locator": "https://www.federalregister.gov/documents/2026/08/26/2026-17381/rescinding-regulations-for-loans-for-minority-business-enterprises-seeking-doe-contracts-and",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-26",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "2026-16425",
      "locator": "https://www.federalregister.gov/documents/2026/08/12/2026-16425/rescission-of-does-procedures-for-traffic-control-on-the-nevada-test-site",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-12",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "partial",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "federal-register-doe"
    ],
    "time_range": {
      "from": "2026-08-12",
      "to": "2026-09-02"
    }
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "docs.search_rulemakings",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Get rulemaking

Coverage and source notes

docs.get_rulemaking {"document_number": "2026-17979"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: federal-register-doe

Publisher metadata; dates do not establish current legal effect
DocumentActionPublishedEffectiveComments closeDockets
2026-17979Notification of stay.2026-09-02UnknownUnknownEERE-2026-FEMP-0067

Record sources
  • Repeal of Fossil Fuel Restrictions for New Federal Buildings and Major Renovations of Federal Buildings
    Federal Register API (Department of Energy documents) · record 2026-17979
    Publisher record
    Record date: 2026-09-02
Full response and evidence
{
  "data": {
    "document_number": "2026-17979",
    "title": "Repeal of Fossil Fuel Restrictions for New Federal Buildings and Major Renovations of Federal Buildings",
    "type": "Rule",
    "action": "Notification of stay.",
    "abstract": "The Department of Energy (DOE) is reviewing its recent guidance related to the implementation of newly adopted provisions regarding Clean Energy for New Federal Buildings and Major Renovations of Federal Buildings (CER). While DOE reviews the CER implementation guidance, DOE is staying the compliance date for the newly adopted provisions in the Code of Federal Regulations (CFR).",
    "publication_date": "2026-09-02",
    "effective_on": null,
    "comments_close_on": null,
    "agencies": [
      "Energy Department"
    ],
    "docket_ids": [
      "EERE-2026-FEMP-0067"
    ],
    "regulation_id_numbers": [
      "1904-AG17"
    ],
    "cfr_references": [
      "10 CFR 433",
      "10 CFR 435"
    ],
    "html_url": "https://www.federalregister.gov/documents/2026/09/02/2026-17979/repeal-of-fossil-fuel-restrictions-for-new-federal-buildings-and-major-renovations-of-federal",
    "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-09-02/pdf/2026-17979.pdf",
    "full_text_url": "https://www.federalregister.gov/documents/full_text/text/2026/09/02/2026-17979.txt",
    "note": "One published document, as the Federal Register printed it. `full_text_url` is the plain text of the whole document; `docket_ids` is how it joins to the rest of its rulemaking, which lives in regulations.gov."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "federal-register-doe",
      "steward": "Office of the Federal Register (National Archives)",
      "system": "Federal Register API (Department of Energy documents)",
      "dataset": "Repeal of Fossil Fuel Restrictions for New Federal Buildings and Major Renovations of Federal Buildings",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "2026-17979",
      "locator": "https://www.federalregister.gov/documents/2026/09/02/2026-17979/repeal-of-fossil-fuel-restrictions-for-new-federal-buildings-and-major-renovations-of-federal",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-02",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "federal-register-doe"
    ]
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "docs.get_rulemaking",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
federal-register-doe.jsonUnknown; old recordingf1b81fd332bdb47df868b0d419aef22e387c2d3fb8ffb2649375d459a1a56a3b

Historical outage-data finder

Skill: grid-status-brief

Found 1 release covering 2021. Documentation and customer-count metadata are shown separately; no outage rate is calculated.

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Release metadata only. No county outage files were downloaded and no outage counts or rates were calculated.
  • Customers without power are not people without power; coverage is incomplete.
  • The customer-count dataset has its own vintage. Pairing it with another year's outages can produce a misleading rate.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo outage-history --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Find outage history

Coverage and source notes

grid.find_outage_history {"year": 2021}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: ceser-eagle-i-outages

  • No published rate limit, same as the rest of the OSTI family.

Releases covering the requested year

How to interpret the data

Customer denominator — check its vintage

Catalog records for EAGLE-I's annual releases, not outage numbers. Each release is a set of county-level files of customers without power at 15-minute intervals behind its DOI. Customers out is not people out, coverage is roughly 92% of US customers with small utilities and cooperatives missing, and the county customer-count dataset is the denominator for a share-of-customers figure. That dataset is a snapshot dated in its own title, so a share for a different year mixes vintages.

Publisher access recipes

Record sources
  • EAGLE-I County Customer Dataset Fall 2025 (customer-count denominator)
    EAGLE-I historical outage datasets · record 3022751
    Publisher record
    Record date: 2026-05-05T20:00:00Z
  • EAGLE-I Power Outage Data 2025 (another year's release)
    EAGLE-I historical outage datasets · record 3019924
    Publisher record
    Record date: 2026-01-31T19:00:00Z
  • EAGLE-I Power Outage Data 2025 (another year's release)
    EAGLE-I historical outage datasets · record 3012826
    Publisher record
    Record date: 2026-02-18T19:00:00Z
  • EAGLE-I Power Outage Data 2024 (another year's release)
    EAGLE-I historical outage datasets · record 2500278
    Publisher record
    Record date: 2025-04-02T20:00:00Z
  • EAGLE-I Power Outage Data 2023 (another year's release)
    EAGLE-I historical outage datasets · record 2297398
    Publisher record
    Record date: 2024-02-11T19:00:00Z
  • EAGLE-I Power Outage Data Information (documentation)
    EAGLE-I historical outage datasets · record 1975203
    Publisher record
    Record date: 2023-05-25T20:00:00Z
  • EAGLE-I Power Outage Data 2014 - 2022 (release covering 2021)
    EAGLE-I historical outage datasets · record 1975202
    Publisher record
    Record date: 2023-05-25T20:00:00Z
Full response and evidence
{
  "data": {
    "releases": [
      {
        "title": "EAGLE-I Power Outage Data 2014 - 2022",
        "kind": "outage_data",
        "covers_years": {
          "from": 2014,
          "to": 2022
        },
        "doi": "10.13139/ORNLNCCS/1975202",
        "doi_url": "https://doi.org/10.13139/ORNLNCCS/1975202",
        "catalog_record": "https://www.osti.gov/dataexplorer/biblio/1975202",
        "osti_ids": [
          "1975202"
        ],
        "published": "2023-05-25"
      },
      {
        "title": "EAGLE-I Power Outage Data 2023",
        "kind": "outage_data",
        "covers_years": {
          "from": 2023,
          "to": 2023
        },
        "doi": "10.13139/OLCF/2297398",
        "doi_url": "https://doi.org/10.13139/OLCF/2297398",
        "catalog_record": "https://www.osti.gov/dataexplorer/biblio/2297398",
        "osti_ids": [
          "2297398"
        ],
        "published": "2024-02-11"
      },
      {
        "title": "EAGLE-I Power Outage Data 2024",
        "kind": "outage_data",
        "covers_years": {
          "from": 2024,
          "to": 2024
        },
        "doi": "10.13139/OLCF/2500278",
        "doi_url": "https://doi.org/10.13139/OLCF/2500278",
        "catalog_record": "https://www.osti.gov/dataexplorer/biblio/2500278",
        "osti_ids": [
          "2500278"
        ],
        "published": "2025-04-02"
      },
      {
        "title": "EAGLE-I Power Outage Data 2025",
        "kind": "outage_data",
        "covers_years": {
          "from": 2025,
          "to": 2025
        },
        "doi": "10.13139/ORNLNCCS/3012826",
        "doi_url": "https://doi.org/10.13139/ORNLNCCS/3012826",
        "catalog_record": "https://www.osti.gov/dataexplorer/biblio/3012826",
        "osti_ids": [
          "3019924",
          "3012826"
        ],
        "published": "2026-02-18"
      }
    ],
    "documentation": [
      {
        "title": "EAGLE-I Power Outage Data Information",
        "kind": "documentation",
        "covers_years": null,
        "doi": "10.13139/ORNLNCCS/1975203",
        "doi_url": "https://doi.org/10.13139/ORNLNCCS/1975203",
        "catalog_record": "https://www.osti.gov/dataexplorer/biblio/1975203",
        "osti_ids": [
          "1975203"
        ],
        "published": "2023-05-25"
      }
    ],
    "customer_counts": [
      {
        "title": "EAGLE-I County Customer Dataset Fall 2025",
        "kind": "customer_counts",
        "covers_years": null,
        "doi": "10.13139/ORNLNCCS/3022751",
        "doi_url": "https://doi.org/10.13139/ORNLNCCS/3022751",
        "catalog_record": "https://www.osti.gov/dataexplorer/biblio/3022751",
        "osti_ids": [
          "3022751"
        ],
        "published": "2026-05-05"
      }
    ],
    "years_covered": {
      "from": 2014,
      "to": 2025
    },
    "missing_years": [],
    "note": "Catalog records for EAGLE-I's annual releases, not outage numbers. Each release is a set of county-level files of customers without power at 15-minute intervals behind its DOI. Customers out is not people out, coverage is roughly 92% of US customers with small utilities and cooperatives missing, and the county customer-count dataset is the denominator for a share-of-customers figure. That dataset is a snapshot dated in its own title, so a share for a different year mixes vintages.",
    "requested_year": 2021,
    "releases_for_year": [
      {
        "title": "EAGLE-I Power Outage Data 2014 - 2022",
        "kind": "outage_data",
        "covers_years": {
          "from": 2014,
          "to": 2022
        },
        "doi": "10.13139/ORNLNCCS/1975202",
        "doi_url": "https://doi.org/10.13139/ORNLNCCS/1975202",
        "catalog_record": "https://www.osti.gov/dataexplorer/biblio/1975202",
        "osti_ids": [
          "1975202"
        ],
        "published": "2023-05-25"
      }
    ]
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "ceser-eagle-i-outages",
      "steward": "Office of Cybersecurity, Energy Security, and Emergency Response",
      "host": "Oak Ridge National Laboratory",
      "system": "EAGLE-I historical outage datasets",
      "dataset": "EAGLE-I historical outage datasets",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "3022751",
      "locator": "https://www.osti.gov/dataexplorer/biblio/3022751",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-05-05T20:00:00Z",
      "transformations": [
        "normalize",
        "dedupe_by_doi"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "3019924",
      "locator": "https://www.osti.gov/dataexplorer/biblio/3019924",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-01-31T19:00:00Z",
      "transformations": [
        "normalize",
        "dedupe_by_doi"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "3012826",
      "locator": "https://www.osti.gov/dataexplorer/biblio/3012826",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-02-18T19:00:00Z",
      "transformations": [
        "normalize",
        "dedupe_by_doi"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "2500278",
      "locator": "https://www.osti.gov/dataexplorer/biblio/2500278",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2025-04-02T20:00:00Z",
      "transformations": [
        "normalize",
        "dedupe_by_doi"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "2297398",
      "locator": "https://www.osti.gov/dataexplorer/biblio/2297398",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2024-02-11T19:00:00Z",
      "transformations": [
        "normalize",
        "dedupe_by_doi"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_06",
      "source_ref": "source_01",
      "record_id": "1975203",
      "locator": "https://www.osti.gov/dataexplorer/biblio/1975203",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2023-05-25T20:00:00Z",
      "transformations": [
        "normalize",
        "dedupe_by_doi"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_07",
      "source_ref": "source_01",
      "record_id": "1975202",
      "locator": "https://www.osti.gov/dataexplorer/biblio/1975202",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2023-05-25T20:00:00Z",
      "transformations": [
        "normalize",
        "dedupe_by_doi"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "ceser-eagle-i-outages"
    ],
    "time_range": {
      "from": "2014",
      "to": "2025"
    },
    "known_limitations": [
      "Customers out is not people out, and an interval count is not an outage event. Turning the series into events or durations is a modelling choice the releases leave to the reader.",
      "OSTI lists the 2025 release twice, under two record ids with one DOI. The tool reports the release once and names both records.",
      "Pointers to the releases, not outage numbers. Each release is a set of files behind its DOI; this source says which release covers a year and where it is, and reading the files is a second step.",
      "Roughly 92% of customers, not all. The gap is small utilities and cooperatives, and it is not randomly distributed: rural areas are underrepresented in exactly the analyses that most want them.",
      "The live platform is not this. Anyone wanting current outage status needs the gated system or a utility's own feed; this is history, published a year at a time."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit, same as the rest of the OSTI family.",
      "source_id": "ceser-eagle-i-outages"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.13139/ORNLNCCS/1975202",
      "label": "EAGLE-I Power Outage Data 2014 - 2022",
      "instructions": "The files are held at ORNL's repository behind this DOI; returned as data and never fetched here.",
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.13139/ORNLNCCS/3022751",
      "label": "EAGLE-I County Customer Dataset Fall 2025",
      "instructions": "The files are held at ORNL's repository behind this DOI; returned as data and never fetched here.",
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.13139/ORNLNCCS/1975203",
      "label": "EAGLE-I Power Outage Data Information",
      "instructions": "The files are held at ORNL's repository behind this DOI; returned as data and never fetched here.",
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "grid.find_outage_history",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
ceser-eagle-i-outages.json2026-10-08T23:09:56.476179+00:00d3928d3e55187b8b5a951a6bbfffeb78d9faa00f645759c1845a98194e7a7685

Does DOE publish this?

Skill: find-doe-data

NREL resolves to National Laboratory of the Rockies, renamed 2025-12-01. 2 of 4 DOE catalogs returned geothermal records; the empty ones are older harvests.

Read 2 of 1,062 from DOE Data Explorer; 2 of 17 from Open Energy Data Hub (ORNL); 0 of 0 from DOE Open Data Catalog (data.json); 0 of 0 from DOE Software Inventory (code.json). A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • NREL is now the National Laboratory of the Rockies; nrel.gov has no DNS, so an old link or acronym can return nothing without an error.
  • Two of the four catalogs are harvested files with an old newest entry; zero matches there is not evidence that DOE holds nothing.
  • Registry sources marked proposed were named, not queried.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo find-data --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Resolve org

Coverage and source notes

registry.resolve_org {"query": "NREL"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: Local registry only

  • Resolved 'NREL' to nlr by former name, not by a current one. A record or document using the old name predates the change; check its date before treating it as current.
Asked forResolved toRenamedFormer names
NRELNational Laboratory of the Rockies2025-12-01National Renewable Energy Laboratory, NREL
Record sources
  • nlr
    DOE-MCP source registry and organization table · record nlr
    No publisher locator supplied
    Record date: Unknown
Full response and evidence
{
  "data": {
    "resolved": {
      "id": "nlr",
      "name": "National Laboratory of the Rockies",
      "kind": "national_lab",
      "parent": "doe",
      "domains": [
        "nlr.gov",
        "developer.nlr.gov",
        "data.nlr.gov"
      ],
      "abbreviations": [
        "NLR"
      ],
      "former_names": [
        "National Renewable Energy Laboratory",
        "NREL"
      ],
      "former_domains": [
        "nrel.gov",
        "developer.nrel.gov",
        "data.nrel.gov",
        "maps.nrel.gov",
        "atb.nrel.gov",
        "datahub.h2awsm.org"
      ],
      "github_orgs": [
        "NatLabRockies",
        "NREL"
      ],
      "renamed_on": "2025-12-01",
      "note": "Renamed 2025-12-01. Every *.nrel.gov domain is dead with NO redirects, which makes this the ecosystem's sharpest alias case: a caller with an old URL gets nothing at all, not a redirect, so a tool that cannot resolve the old name gives them no way to find out why. The developer network survived intact at developer.nlr.gov on GSA's api.data.gov infrastructure. The H2 DataHub followed later: datahub.h2awsm.org now redirects to datahub-h2awsm.nlr.gov."
    },
    "basis": "former_name",
    "candidates": [],
    "source_count": 13,
    "historical_name": {
      "queried": "NREL",
      "resolved_to": "nlr",
      "renamed_on": "2025-12-01",
      "note": "'NREL' is a former name or domain. The current organization is National Laboratory of the Rockies, as of 2025-12-01. Tell the user the name they used is historical."
    }
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "doe-mcp-registry",
      "steward": "The DOE-MCP project",
      "system": "DOE-MCP source registry and organization table",
      "dataset": "DOE-MCP source registry and organization table",
      "dataset_version": "2026-11-09",
      "authority_level": "unverified",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "nlr",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit"
  },
  "warnings": [
    {
      "code": "alias_match",
      "message": "Resolved 'NREL' to nlr by former name, not by a current one. A record or document using the old name predates the change; check its date before treating it as current.",
      "source_id": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "registry.resolve_org",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Coverage

Coverage and source notes

registry.search_sources {"text": "geothermal"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: Local registry only

ReturnedTotal matches
22
  • nlr-geothermal-data-repository
    DOE-MCP source registry and organization table · record nlr-geothermal-data-repository
    No publisher locator supplied
    Record date: Unknown
  • oedi-data-lake
    DOE-MCP source registry and organization table · record oedi-data-lake
    No publisher locator supplied
    Record date: Unknown
Registry inventory; not a publisher query
SourceStateBlocked reason
Geothermal Data Repository (GDR)proposedNo API exists. 71% is reachable now through DOE Data Explorer; the remaining 29% needs a sitemap harvest and Gate E review for retaining harvested content.
Open Energy Data Initiative data lakeproposedThe catalog's machine interface is unidentified — the documented API path returns a help stub. Next step is a browser-grade look at what the catalog UI itself calls.
Full response and evidence
{
  "data": {
    "sources": [
      {
        "id": "nlr-geothermal-data-repository",
        "name": "Geothermal Data Repository (GDR)",
        "domain": "energy-tech",
        "steward": "nlr",
        "authority_level": "official_secondary",
        "declared_state": "proposed",
        "operational_state": "unknown",
        "automation_status": "public_download",
        "tier": "catalog_pointer",
        "planned_capabilities": [
          "dataset.search"
        ],
        "record_count": 1451,
        "blocked_reason": "No API exists. 71% is reachable now through DOE Data Explorer; the remaining 29% needs a sitemap harvest and Gate E review for retaining harvested content."
      },
      {
        "id": "oedi-data-lake",
        "name": "Open Energy Data Initiative data lake",
        "domain": "discovery",
        "steward": "nlr",
        "authority_level": "official_secondary",
        "declared_state": "proposed",
        "operational_state": "unknown",
        "automation_status": "public_download",
        "tier": "catalog_pointer",
        "planned_capabilities": [
          "discovery.search_catalogs"
        ],
        "record_count": 2825,
        "blocked_reason": "The catalog's machine interface is unidentified \u2014 the documented API path returns a help stub. Next step is a browser-grade look at what the catalog UI itself calls."
      }
    ],
    "record_count": 2,
    "total_matches": 2,
    "note": "Active sources can be queried now. Proposed ones are inventory: DOE-MCP knows they exist and each carries a blocked_reason saying what stands in the way. That is a different answer from 'we have never heard of it'."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "doe-mcp-registry",
      "steward": "The DOE-MCP project",
      "system": "DOE-MCP source registry and organization table",
      "dataset": "DOE-MCP source registry and organization table",
      "dataset_version": "2026-11-09",
      "authority_level": "unverified",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "nlr-geothermal-data-repository",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "oedi-data-lake",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit"
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "registry.search_sources",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

3. Search all catalogs

Coverage and source notes

discovery.search_all_catalogs {"per_catalog": 2, "query": "geothermal"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: osti-data-explorer, ornl-openenergyhub, doe-open-data-catalog, doe-code-json

  • No published rate limit, same as the rest of the OSTI family.
  • The portal states no site-wide licence, so per-dataset licence metadata is the only rights signal available and it is not populated on every dataset.
  • DOE Open Data Catalog (data.json) answered from a harvested catalog whose newest entry is dated 2022-09-26. Entries in it may name program offices that have since been renamed or dismantled, and its links may be dead.
  • DOE Software Inventory (code.json) answered from a harvested catalog whose newest entry is dated 2024-09-12. Entries in it may name program offices that have since been renamed or dismantled, and its links may be dead.
A dated vintage is a harvested file; live means the catalog was queried
CatalogVintageMatchesReturned
DOE Data Explorerlive10622
Open Energy Data Hub (ORNL)live172
DOE Open Data Catalog (data.json)2022-09-2600
DOE Software Inventory (code.json)2024-09-1200
CatalogTitleDate
osti-data-explorerStructural Orientations Adjacent to Some Colorado Geothermal Systems2012-01-31
osti-data-explorerUtah FORGE: Well 58-32 Stimulation Data2019-04-19
ornl-openenergyhubGlass Buttes Exploration and Drilling: 2010 Geothermal Technologies Program Peer Review Presentation2020-08-14
ornl-openenergyhubInvestigation of Stimulation-Response Relationships for Complex Fracture Systems in Enhanced Geothermal Reservoirs2017-05-23

Publisher access recipes

Record sources
  • 1148737
    DOE Data Explorer · record 1148737
    No publisher locator supplied
    Record date: Unknown
  • 1542650
    DOE Data Explorer · record 1542650
    No publisher locator supplied
    Record date: Unknown
  • glass-buttes-exploration-and-drilling-2010-geothermal-technologies-program-peer-
    Open Energy Data Hub (ORNL) · record glass-buttes-exploration-and-drilling-2010-geothermal-technologies-program-peer-
    No publisher locator supplied
    Record date: Unknown
  • investigation-of-stimulation-response-relationships-for-complex-fracture-systems
    Open Energy Data Hub (ORNL) · record investigation-of-stimulation-response-relationships-for-complex-fracture-systems
    No publisher locator supplied
    Record date: Unknown
Full response and evidence
{
  "data": {
    "results": [
      {
        "id": "1148737",
        "title": "Structural Orientations Adjacent to Some Colorado Geothermal Systems",
        "doi": "10.15121/1148737",
        "landing_page": "https://gdr.openei.org/submissions/317",
        "date": "2012-01-31",
        "orgs": [
          "DOE Geothermal Data Repository",
          "Flint Geothermal, LLC"
        ],
        "catalog": "osti-data-explorer",
        "catalog_vintage": "live"
      },
      {
        "id": "1542650",
        "title": "Utah FORGE: Well 58-32 Stimulation Data",
        "doi": "10.15121/1542650",
        "landing_page": "https://gdr.openei.org/submissions/1149",
        "date": "2019-04-19",
        "orgs": [
          "DOE Geothermal Data Repository",
          "Geothermal Resource Group"
        ],
        "catalog": "osti-data-explorer",
        "catalog_vintage": "live"
      },
      {
        "id": "glass-buttes-exploration-and-drilling-2010-geothermal-technologies-program-peer-",
        "title": "Glass Buttes Exploration and Drilling: 2010 Geothermal Technologies Program Peer Review Presentation",
        "landing_page": "https://openenergyhub.ornl.gov/explore/dataset/glass-buttes-exploration-and-drilling-2010-geothermal-technologies-program-peer-/",
        "date": "2020-08-14",
        "themes": [
          "Energy",
          "Mining"
        ],
        "catalog": "ornl-openenergyhub",
        "catalog_vintage": "live"
      },
      {
        "id": "investigation-of-stimulation-response-relationships-for-complex-fracture-systems",
        "title": "Investigation of Stimulation-Response Relationships for Complex Fracture Systems in Enhanced Geothermal Reservoirs",
        "landing_page": "https://openenergyhub.ornl.gov/explore/dataset/investigation-of-stimulation-response-relationships-for-complex-fracture-systems/",
        "date": "2017-05-23",
        "themes": [
          "Geothermal Energy"
        ],
        "catalog": "ornl-openenergyhub",
        "catalog_vintage": "live"
      }
    ],
    "record_count": 4,
    "per_catalog": [
      {
        "catalog": "osti-data-explorer",
        "system": "DOE Data Explorer",
        "vintage": "live",
        "total_matches": 1062,
        "returned": 2
      },
      {
        "catalog": "ornl-openenergyhub",
        "system": "Open Energy Data Hub (ORNL)",
        "vintage": "live",
        "total_matches": 17,
        "returned": 2
      },
      {
        "catalog": "doe-open-data-catalog",
        "system": "DOE Open Data Catalog (data.json)",
        "vintage": "2022-09-26",
        "total_matches": 0,
        "returned": 0
      },
      {
        "catalog": "doe-code-json",
        "system": "DOE Software Inventory (code.json)",
        "vintage": "2024-09-12",
        "total_matches": 0,
        "returned": 0
      }
    ],
    "note": "Four DOE catalogs overlap and disagree; none is a superset. Each result names its catalog and that catalog's vintage so you can weigh them. Catalog-supplied links are returned unverified \u2014 a dead link in a catalog is common and is not evidence the dataset is gone."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "osti-data-explorer",
      "steward": "Office of Scientific and Technical Information",
      "system": "DOE Data Explorer",
      "dataset": "DOE Data Explorer",
      "dataset_version": "current",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    },
    {
      "id": "source_02",
      "source_id": "ornl-openenergyhub",
      "steward": "Oak Ridge National Laboratory",
      "system": "Open Energy Data Hub (ORNL)",
      "dataset": "Open Energy Data Hub (ORNL)",
      "dataset_version": "current",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    },
    {
      "id": "source_03",
      "source_id": "doe-open-data-catalog",
      "steward": "Office of the Chief Information Officer",
      "system": "DOE Open Data Catalog (data.json)",
      "dataset": "DOE Open Data Catalog (data.json)",
      "dataset_version": "current",
      "authority_level": "official_derived",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    },
    {
      "id": "source_04",
      "source_id": "doe-code-json",
      "steward": "Office of the Chief Information Officer",
      "system": "DOE Software Inventory (code.json)",
      "dataset": "DOE Software Inventory (code.json)",
      "dataset_version": "code-05-01-2025",
      "authority_level": "official_derived",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "1148737",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "1542650",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_02",
      "record_id": "glass-buttes-exploration-and-drilling-2010-geothermal-technologies-program-peer-",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_02",
      "record_id": "investigation-of-stimulation-response-relationships-for-complex-fracture-systems",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "osti-data-explorer",
      "ornl-openenergyhub",
      "doe-open-data-catalog",
      "doe-code-json"
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit, same as the rest of the OSTI family.",
      "source_id": "osti-data-explorer"
    },
    {
      "code": "terms_note",
      "message": "The portal states no site-wide licence, so per-dataset licence metadata is the only rights signal available and it is not populated on every dataset.",
      "source_id": "ornl-openenergyhub"
    },
    {
      "code": "catalog_vintage",
      "message": "DOE Open Data Catalog (data.json) answered from a harvested catalog whose newest entry is dated 2022-09-26. Entries in it may name program offices that have since been renamed or dismantled, and its links may be dead.",
      "source_id": "doe-open-data-catalog"
    },
    {
      "code": "catalog_vintage",
      "message": "DOE Software Inventory (code.json) answered from a harvested catalog whose newest entry is dated 2024-09-12. Entries in it may name program offices that have since been renamed or dismantled, and its links may be dead.",
      "source_id": "doe-code-json"
    }
  ],
  "access_recipes": [
    {
      "kind": "landing_page",
      "uri": "https://gdr.openei.org/submissions/317",
      "label": "Structural Orientations Adjacent to Some Colorado Geothermal Systems",
      "instructions": "Catalog-supplied URL, never fetched by this server and not checked for liveness.",
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://gdr.openei.org/submissions/1149",
      "label": "Utah FORGE: Well 58-32 Stimulation Data",
      "instructions": "Catalog-supplied URL, never fetched by this server and not checked for liveness.",
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://openenergyhub.ornl.gov/explore/dataset/glass-buttes-exploration-and-drilling-2010-geothermal-technologies-program-peer-/",
      "label": "Glass Buttes Exploration and Drilling: 2010 Geothermal Technologies Program\u2026",
      "instructions": "Catalog-supplied URL, never fetched by this server and not checked for liveness.",
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://openenergyhub.ornl.gov/explore/dataset/investigation-of-stimulation-response-relationships-for-complex-fracture-systems/",
      "label": "Investigation of Stimulation-Response Relationships for Complex Fracture\u2026",
      "instructions": "Catalog-supplied URL, never fetched by this server and not checked for liveness.",
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "discovery.search_all_catalogs",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
doe-code-json.jsonUnknown; old recording09a02ccb524f4c2f7757929d119742484fa7e44a720395a4d95eba9caa418047
doe-open-data-catalog.jsonUnknown; old recordinge4153a473c6afd89401ea09a16617ba16736056f6b9bf524c4276d94c40728a6
ornl-openenergyhub.jsonUnknown; old recordingb475b04ed1b8c1a58a08b110c277e087c0b3f9dcf0dbbe8a9ec41bed289cd6aa
osti-data-explorer.jsonUnknown; old recording71a7e71e7056856c76fcebc8d0234e049c0109bd35e2b1777768e408072ad398

NERSC facility status

19 of 19 NERSC systems active on the recorded board. Next planned outage: Perlmutter Monthly Maintenance, starting 2026-10-21T06:00:00 (zone not stated).

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • One facility. ALCF and OLCF are registered and not read here; their absence says nothing about whether they are up.
  • Status is not queue position, allocation or permission to run a job.
  • The board's timestamps carry no time zone, and updated_at is the last change, not the last check. This is a recorded board, not current status.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo facility-status --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Systems

Coverage and source notes

compute.facility_status {}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: nersc-status

NERSC public status board, recorded
SystemTypeStatusLast changed (zone not stated)
Perlmuttercomputeactive2026-09-22 17:00
Global Commonfilesystemactive2026-08-03 17:35
Community File System (CFS)filesystemactive2026-08-03 17:35
Global Homesfilesystemactive2026-08-06 15:30:30
Data Transfer Nodesserviceactive2026-09-24 11:00
Science Gateway Servicesserviceactive2026-08-03 17:35
Science Databasesserviceactive2026-09-16 12:15
Spinserviceactive2026-09-16 17:40
Globusserviceactive2026-08-03 17:35
Jupyterserviceactive2026-08-16 08:55
NERSC Websiteserviceactive2026-06-09 15:25
Networkserviceactive2026-09-16 10:21
Authentication Servicesserviceactive2026-09-01 11:00
Thinlincserviceactive2026-09-21 09:25
Help Portalserviceactive2026-08-03 17:35
IRISserviceactive2026-10-08 14:05
HPSS Archive (User)filesystemactive2026-10-07 13:25
Container Runtimesserviceactive2026-09-16 20:10:41
HPSS Regent (Backup)filesystemactive2026-09-30 08:47
Planned outages as NERSC wrote them; times in an unstated zone
SystemPlanned outageStartsEnds
container_runtimesPerlmutter Monthly Maintenance2026-10-21 06:002026-10-21 22:00
perlmutterPerlmutter Monthly Maintenance2026-10-21 06:002026-10-21 22:00
archiveHPSS Archive - Planned Maintenance2026-11-01 19:002026-11-06 17:00
container_runtimesPerlmutter Monthly Maintenance2026-11-11 06:002026-11-11 22:00
perlmutterPerlmutter Monthly Maintenance2026-11-11 06:002026-11-11 22:00
container_runtimesPerlmutter Monthly Maintenance2026-12-16 06:002026-12-16 22:00
perlmutterPerlmutter Monthly Maintenance2026-12-16 06:002026-12-16 22:00

Registered and not readable by DOE-MCP. Their absence from this answer says nothing about whether they are up.

Record sources
  • perlmutter
    NERSC Superfacility API (system status) · record perlmutter
    No publisher locator supplied
    Record date: 2026-09-22T17:00:00
  • global_common
    NERSC Superfacility API (system status) · record global_common
    No publisher locator supplied
    Record date: 2026-08-03T17:35:00
  • community_filesystem
    NERSC Superfacility API (system status) · record community_filesystem
    No publisher locator supplied
    Record date: 2026-08-03T17:35:00
  • global_homes
    NERSC Superfacility API (system status) · record global_homes
    No publisher locator supplied
    Record date: 2026-08-06T15:30:30
  • dtns
    NERSC Superfacility API (system status) · record dtns
    No publisher locator supplied
    Record date: 2026-09-24T11:00:00
  • sgns
    NERSC Superfacility API (system status) · record sgns
    No publisher locator supplied
    Record date: 2026-08-03T17:35:00
  • sciencedatabases
    NERSC Superfacility API (system status) · record sciencedatabases
    No publisher locator supplied
    Record date: 2026-09-16T12:15:00
  • spin
    NERSC Superfacility API (system status) · record spin
    No publisher locator supplied
    Record date: 2026-09-16T17:40:00
  • globus
    NERSC Superfacility API (system status) · record globus
    No publisher locator supplied
    Record date: 2026-08-03T17:35:00
  • jupyter
    NERSC Superfacility API (system status) · record jupyter
    No publisher locator supplied
    Record date: 2026-08-16T08:55:00
  • website
    NERSC Superfacility API (system status) · record website
    No publisher locator supplied
    Record date: 2026-06-09T15:25:00
  • network
    NERSC Superfacility API (system status) · record network
    No publisher locator supplied
    Record date: 2026-09-16T10:21:00
  • authentication_servi
    NERSC Superfacility API (system status) · record authentication_servi
    No publisher locator supplied
    Record date: 2026-09-01T11:00:00
  • thinlinc
    NERSC Superfacility API (system status) · record thinlinc
    No publisher locator supplied
    Record date: 2026-09-21T09:25:00
  • helpportal
    NERSC Superfacility API (system status) · record helpportal
    No publisher locator supplied
    Record date: 2026-08-03T17:35:00
  • iris
    NERSC Superfacility API (system status) · record iris
    No publisher locator supplied
    Record date: 2026-10-08T14:05:00
  • archive
    NERSC Superfacility API (system status) · record archive
    No publisher locator supplied
    Record date: 2026-10-07T13:25:00
  • container_runtimes
    NERSC Superfacility API (system status) · record container_runtimes
    No publisher locator supplied
    Record date: 2026-09-16T20:10:41
  • regent
    NERSC Superfacility API (system status) · record regent
    No publisher locator supplied
    Record date: 2026-09-30T08:47:00
  • container_runtimes@2026-10-21T06:00:00
    NERSC Superfacility API (system status) · record container_runtimes@2026-10-21T06:00:00
    No publisher locator supplied
    Record date: 2026-10-21T06:00:00
  • perlmutter@2026-10-21T06:00:00
    NERSC Superfacility API (system status) · record perlmutter@2026-10-21T06:00:00
    No publisher locator supplied
    Record date: 2026-10-21T06:00:00
  • archive@2026-11-01T19:00:00
    NERSC Superfacility API (system status) · record archive@2026-11-01T19:00:00
    No publisher locator supplied
    Record date: 2026-11-01T19:00:00
  • container_runtimes@2026-11-11T06:00:00
    NERSC Superfacility API (system status) · record container_runtimes@2026-11-11T06:00:00
    No publisher locator supplied
    Record date: 2026-11-11T06:00:00
  • perlmutter@2026-11-11T06:00:00
    NERSC Superfacility API (system status) · record perlmutter@2026-11-11T06:00:00
    No publisher locator supplied
    Record date: 2026-11-11T06:00:00
  • container_runtimes@2026-12-16T06:00:00
    NERSC Superfacility API (system status) · record container_runtimes@2026-12-16T06:00:00
    No publisher locator supplied
    Record date: 2026-12-16T06:00:00
  • perlmutter@2026-12-16T06:00:00
    NERSC Superfacility API (system status) · record perlmutter@2026-12-16T06:00:00
    No publisher locator supplied
    Record date: 2026-12-16T06:00:00
Full response and evidence
{
  "data": {
    "facility": "NERSC",
    "systems": [
      {
        "name": "perlmutter",
        "full_name": "Perlmutter",
        "type": "compute",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-22T17:00:00"
      },
      {
        "name": "global_common",
        "full_name": "Global Common",
        "type": "filesystem",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-08-03T17:35:00"
      },
      {
        "name": "community_filesystem",
        "full_name": "Community File System (CFS)",
        "type": "filesystem",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-08-03T17:35:00"
      },
      {
        "name": "global_homes",
        "full_name": "Global Homes",
        "type": "filesystem",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-08-06T15:30:30"
      },
      {
        "name": "dtns",
        "full_name": "Data Transfer Nodes",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-24T11:00:00"
      },
      {
        "name": "sgns",
        "full_name": "Science Gateway Services",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-08-03T17:35:00"
      },
      {
        "name": "sciencedatabases",
        "full_name": "Science Databases",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-16T12:15:00"
      },
      {
        "name": "spin",
        "full_name": "Spin",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-16T17:40:00"
      },
      {
        "name": "globus",
        "full_name": "Globus",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-08-03T17:35:00"
      },
      {
        "name": "jupyter",
        "full_name": "Jupyter",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-08-16T08:55:00"
      },
      {
        "name": "website",
        "full_name": "NERSC Website",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-06-09T15:25:00"
      },
      {
        "name": "network",
        "full_name": "Network",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-16T10:21:00"
      },
      {
        "name": "authentication_servi",
        "full_name": "Authentication Services",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-01T11:00:00"
      },
      {
        "name": "thinlinc",
        "full_name": "Thinlinc",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-21T09:25:00"
      },
      {
        "name": "helpportal",
        "full_name": "Help Portal",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-08-03T17:35:00"
      },
      {
        "name": "iris",
        "full_name": "IRIS",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-10-08T14:05:00"
      },
      {
        "name": "archive",
        "full_name": "HPSS Archive (User)",
        "type": "filesystem",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-10-07T13:25:00"
      },
      {
        "name": "container_runtimes",
        "full_name": "Container Runtimes",
        "type": "service",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-16T20:10:41"
      },
      {
        "name": "regent",
        "full_name": "HPSS Regent (Backup)",
        "type": "filesystem",
        "status": "active",
        "description": "System is active",
        "notes": [],
        "updated_at": "2026-09-30T08:47:00"
      }
    ],
    "record_count": 19,
    "systems_on_board": 19,
    "not_active": [],
    "timestamps": "The board's timestamps carry no UTC offset and the response does not state a zone. They are printed as NERSC wrote them; NERSC is in Berkeley, California, but the zone is an inference this project does not make for the caller.",
    "note": "The facility's own public status board. updated_at is when a row last changed, not when it was checked, so an old date on an active system means a quiet system. Nothing here describes a user's jobs, queue or allocation.",
    "planned_outages": [
      {
        "system": "container_runtimes",
        "start_at": "2026-10-21T06:00:00",
        "end_at": "2026-10-21T22:00:00",
        "description": "Perlmutter Monthly Maintenance",
        "notes": "NERSC engineers will be performing a monthly scheduled maintenance.",
        "status": "Planned"
      },
      {
        "system": "perlmutter",
        "start_at": "2026-10-21T06:00:00",
        "end_at": "2026-10-21T22:00:00",
        "description": "Perlmutter Monthly Maintenance",
        "notes": "NERSC engineers will be performing a monthly scheduled maintenance.",
        "status": "Planned"
      },
      {
        "system": "archive",
        "start_at": "2026-11-01T19:00:00",
        "end_at": "2026-11-06T17:00:00",
        "description": "HPSS Archive - Planned Maintenance",
        "notes": "HPSS Archive upgrade from V9.3 to V11.3. The main HPSS User environment, Archive, will be shut down from 7 pm (Pacific Time) on November 1 until 5 pm on November 6, 2026, while a new version of the system is deployed. During this five-day period, it will not be possible to store or retrieve data from the system. Users are strongly encouraged to plan accordingly.",
        "status": "Planned"
      },
      {
        "system": "container_runtimes",
        "start_at": "2026-11-11T06:00:00",
        "end_at": "2026-11-11T22:00:00",
        "description": "Perlmutter Monthly Maintenance",
        "notes": "NERSC engineers will be performing a monthly scheduled maintenance.",
        "status": "Planned"
      },
      {
        "system": "perlmutter",
        "start_at": "2026-11-11T06:00:00",
        "end_at": "2026-11-11T22:00:00",
        "description": "Perlmutter Monthly Maintenance",
        "notes": "NERSC engineers will be performing a monthly scheduled maintenance.",
        "status": "Planned"
      },
      {
        "system": "container_runtimes",
        "start_at": "2026-12-16T06:00:00",
        "end_at": "2026-12-16T22:00:00",
        "description": "Perlmutter Monthly Maintenance",
        "notes": "NERSC engineers will be performing a monthly scheduled maintenance.",
        "status": "Planned"
      },
      {
        "system": "perlmutter",
        "start_at": "2026-12-16T06:00:00",
        "end_at": "2026-12-16T22:00:00",
        "description": "Perlmutter Monthly Maintenance",
        "notes": "NERSC engineers will be performing a monthly scheduled maintenance.",
        "status": "Planned"
      }
    ],
    "other_facilities": [
      {
        "source_id": "alcf-status",
        "name": "ALCF computing status",
        "why_not_read": "Blocked probe. The status page is an Angular application and its data paths return HTTP 403 with a Cloudflare challenge to a scripted client, which under decision 0007 is blocked_probe and NOT gated: a WAF refusing this client shape says nothing about whether the data is public. One real-browser check, watching the application's own network calls, would settle both the endpoint and the posture. Joins the blocked-probe backlog. Note, 2026-10-20. One plain GET of the status page answered 200 with the application shell, so the 403 did not recur; one probe from one machine is not evidence that the posture changed. The page's own data path was found and is not a candidate: it is undocumented and carries queued and running job records, which this project does not read for any facility. ALCF documents a separate machine route, its implementation of the IRI Facility API at api.alcf.anl.gov, whose status reads answered a plain GET with JSON. Under decision 0025 that is a different source with its own terms, and it waits on a terms review before it is registered; this manifest stays proposed until then."
      },
      {
        "source_id": "olcf-status",
        "name": "OLCF center status",
        "why_not_read": "No machine interface found. status.olcf.ornl.gov does not resolve in DNS; the center-status page is a 1.5 KB stub; and the lab site's WordPress API exposes only WordPress's own routes, where /wp/v2/statuses is post statuses rather than system status. The next step is asking OLCF whether one exists rather than guessing at more paths."
      }
    ],
    "other_facilities_note": "Registered and not readable by DOE-MCP. Their absence from this answer says nothing about whether they are up."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "nersc-status",
      "steward": "Lawrence Berkeley National Laboratory",
      "funder": "Office of Science",
      "system": "NERSC Superfacility API (system status)",
      "dataset": "NERSC Superfacility API (system status)",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "perlmutter",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-22T17:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "global_common",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-03T17:35:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "community_filesystem",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-03T17:35:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "global_homes",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-06T15:30:30",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "dtns",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-24T11:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_06",
      "source_ref": "source_01",
      "record_id": "sgns",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-03T17:35:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_07",
      "source_ref": "source_01",
      "record_id": "sciencedatabases",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-16T12:15:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_08",
      "source_ref": "source_01",
      "record_id": "spin",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-16T17:40:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_09",
      "source_ref": "source_01",
      "record_id": "globus",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-03T17:35:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_10",
      "source_ref": "source_01",
      "record_id": "jupyter",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-16T08:55:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_11",
      "source_ref": "source_01",
      "record_id": "website",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-06-09T15:25:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_12",
      "source_ref": "source_01",
      "record_id": "network",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-16T10:21:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_13",
      "source_ref": "source_01",
      "record_id": "authentication_servi",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-01T11:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_14",
      "source_ref": "source_01",
      "record_id": "thinlinc",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-21T09:25:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_15",
      "source_ref": "source_01",
      "record_id": "helpportal",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-03T17:35:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_16",
      "source_ref": "source_01",
      "record_id": "iris",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-10-08T14:05:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_17",
      "source_ref": "source_01",
      "record_id": "archive",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-10-07T13:25:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_18",
      "source_ref": "source_01",
      "record_id": "container_runtimes",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-16T20:10:41",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_19",
      "source_ref": "source_01",
      "record_id": "regent",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-30T08:47:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_20",
      "source_ref": "source_01",
      "record_id": "container_runtimes@2026-10-21T06:00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-10-21T06:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_21",
      "source_ref": "source_01",
      "record_id": "perlmutter@2026-10-21T06:00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-10-21T06:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_22",
      "source_ref": "source_01",
      "record_id": "archive@2026-11-01T19:00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-11-01T19:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_23",
      "source_ref": "source_01",
      "record_id": "container_runtimes@2026-11-11T06:00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-11-11T06:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_24",
      "source_ref": "source_01",
      "record_id": "perlmutter@2026-11-11T06:00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-11-11T06:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_25",
      "source_ref": "source_01",
      "record_id": "container_runtimes@2026-12-16T06:00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-12-16T06:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_26",
      "source_ref": "source_01",
      "record_id": "perlmutter@2026-12-16T06:00:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-12-16T06:00:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "nersc-status"
    ],
    "known_limitations": [
      "One facility. OLCF and ALCF were checked on 2026-09-08: ALCF's status application answers a scripted client with an HTTP 403 challenge and OLCF publishes no machine interface that could be found. Both are registered (alcf-status, olcf-status) as proposed. On 2026-10-20 ALCF's documented IRI Facility API answered a plain status read; it awaits a terms review (see alcf-status).",
      "Planned outages only. The publisher's record of past outages is a separate route this tool does not read.",
      "Status, not availability for any user. Nothing about a user's jobs, queue position or allocation is public, and this project asks for none of it.",
      "Timestamps carry no UTC offset, and updated_at is when a row last changed, not when it was checked: a filesystem that has been fine for two months reads two months old."
    ]
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "compute.facility_status",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
nersc-status.json2026-10-08T23:12:37.080875+00:001d6915f666940b312c349bfb9e9dcb32e123e89850582f3f7b2e282aeda911a7

One collection unavailable

Skill: doe-literature-review

3 distinct records returned. Followed record 3484888: Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells.

Read 3 of 8,313 from OSTI.GOV Search API. A recorded replay at registry revision 2026-11-09, not current data.

Simulated source outage. The publisher status was changed only in this isolated replay.

Limits of this example
  • A sampled literature search is not a systematic review.
  • A common topic does not prove that a paper and dataset are linked.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo partial --output ./demo-output

1. Search literature

Coverage and source notes

research.search_literature {"query": "perovskite solar", "rows": 3}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: osti-gov-records

Unavailable sources

  • osti-doe-pages: source_not_activated
  • No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.
Counts reported by each collection; totals can overlap
CollectionMatchesReturned
OSTI.GOV Search API83133

Publisher access recipes

  • Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells
    OSTI.GOV Search API · record 3484888
    Publisher record
    Record date: 2026-08-27T11:00:26Z
  • Semi-Transparent Perovskite Solar Cells in a Stacked Tandem Module: Cooperative Research and Development Final Report, CRADA Number CRD-19-00810
    OSTI.GOV Search API · record 3625672
    Publisher record
    Record date: 2026-09-02T10:56:05Z
  • Reducing non-radiative recombination in perovskite solar cells with a SiO2-graphene oxide buried interface layer
    OSTI.GOV Search API · record 3409109
    Publisher record
    Record date: 2026-09-18T15:49:56Z
Full response and evidence
{
  "data": {
    "records": [
      {
        "id": "3484888",
        "title": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells",
        "authors": [
          "Yan, Feng [Materials Science and Engineering Program, School for Engineering of Matter, Transport and Energy, Arizona State University, Tempe, AZ, 85287]"
        ],
        "publication_date": "2026-08-26",
        "product_type": "Technical Report",
        "doi": "10.2172/3484888",
        "report_number": "EE0009833",
        "research_orgs": [
          "Univ. of Alabama, Tuscaloosa, AL (United States)",
          "Arizona State Univ., Tempe, AZ (United States)",
          "National Renewable Energy Laboratory (NREL), Golden, CO (United States)"
        ]
      },
      {
        "id": "3625672",
        "title": "Semi-Transparent Perovskite Solar Cells in a Stacked Tandem Module: Cooperative Research and Development Final Report, CRADA Number CRD-19-00810",
        "authors": [
          "Luther, Joey [National Laboratory of the Rockies, Golden, CO (United States)]",
          "Larson, Bryon [National Laboratory of the Rockies, Golden, CO (United States)]",
          "Reiter, Kyle [National Laboratory of the Rockies, Golden, CO (United States)]"
        ],
        "publication_date": "2026-08-26",
        "product_type": "Technical Report",
        "doi": "10.66816/tp5080615",
        "report_number": "NLR/TP-5F00-99345",
        "research_orgs": [
          "National Laboratory of the Rockies (NLR), Golden, CO (United States)"
        ]
      },
      {
        "id": "3409109",
        "title": "Reducing non-radiative recombination in perovskite solar cells with a SiO<sub>2</sub>-graphene oxide buried interface layer",
        "authors": [
          "Cao, Zikun [Univ. of Texas, Arlington, TX (United States); Univ. of Miami, FL (United States)]",
          "You, Shuai [National Laboratory of the Rockies (NLR), Golden, CO (United States)]",
          "Zhang, Xiyao [Univ. of Texas, Arlington, TX (United States); Univ. of Akron, OH (United States)]",
          "Liu, Lei [Univ. of Akron, OH (United States)]",
          "Zhang, Haixing [Univ. of Miami, FL (United States)]"
        ],
        "publication_date": "2026-09-01",
        "product_type": "Journal Article",
        "authors_truncated": 4,
        "doi": "10.1016/j.nanoen.2026.112209",
        "journal": "Nano Energy",
        "report_number": "NLR/JA-5900-101333",
        "research_orgs": [
          "National Laboratory of the Rockies (NLR), Golden, CO (United States)"
        ]
      }
    ],
    "record_count": 3,
    "per_source": [
      {
        "source_id": "osti-gov-records",
        "system": "OSTI.GOV Search API",
        "total_matches": 8313,
        "returned": 3
      }
    ]
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "osti-gov-records",
      "steward": "Office of Scientific and Technical Information",
      "system": "OSTI.GOV Search API",
      "dataset": "OSTI.GOV Search API",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "3484888",
      "locator": "https://www.osti.gov/biblio/3484888",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-27T11:00:26Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "3625672",
      "locator": "https://www.osti.gov/biblio/3625672",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-02T10:56:05Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "3409109",
      "locator": "https://www.osti.gov/biblio/3409109",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-18T15:49:56Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "osti-gov-records"
    ],
    "sources_unavailable": [
      {
        "source_id": "osti-doe-pages",
        "reason": "source_not_activated"
      }
    ],
    "known_limitations": [
      "A fulltext link is present when `has_fulltext` is true and absent otherwise; the servlet URL pattern resolves for those records only. Constructing one for a record without full text produces a dead link, so the adapter emits only what the API supplies or the manifest templates for records the API marked as having full text.",
      "An index of DOE-funded results, not of all energy research. Absence here says nothing about whether work exists; it says DOE did not fund or receive it.",
      "ScienceCinema was retired as a standalone product on 2025-09-05 and its ~3,600 multimedia items folded into this collection. Whether they can be isolated by any filter here is unverified.",
      "Some records carry future `publication_date` values, which is correct rather than a data error: OSTI accepts scheduled-publication metadata. Sorting by date puts unpublished work first unless a range is set.",
      "`product_type` filters on OSTI's own vocabulary \u2014 \"Technical Report\", \"Journal Article\" \u2014 and the value \"Dataset\" returns zero here even though datasets exist, because dataset records live in DOE Data Explorer. Checked live 2026-09-02. A caller filtering for datasets on this API gets an empty result that means \"wrong API\", not \"none\"."
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.",
      "source_id": "osti-gov-records"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.2172/3484888",
      "label": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3484888",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.66816/tp5080615",
      "label": "Semi-Transparent Perovskite Solar Cells in a Stacked Tandem Module\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3625672",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "https://doi.org/10.1016/j.nanoen.2026.112209",
      "label": "Reducing non-radiative recombination in perovskite solar cells with a\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3409109",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "next_actions": [
    {
      "finding": "More matches exist than the 3 returned.",
      "suggested_capability": "literature.search",
      "reason": "Call again with a higher page number, or narrow the filters. Do not describe these as all the results."
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "research.search_literature",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Get record

Coverage and source notes

research.get_record {"collection": "literature", "record_id": "3484888"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: osti-gov-records

  • No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.

Publisher access recipes

  • Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells
    OSTI.GOV Search API · record 3484888
    Publisher record
    Record date: 2026-08-27T11:00:26Z
Full response and evidence
{
  "data": {
    "record": {
      "id": "3484888",
      "title": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells",
      "authors": [
        "Yan, Feng [Materials Science and Engineering Program, School for Engineering of Matter, Transport and Energy, Arizona State University, Tempe, AZ, 85287]"
      ],
      "publication_date": "2026-08-26",
      "product_type": "Technical Report",
      "doi": "10.2172/3484888",
      "report_number": "EE0009833",
      "research_orgs": [
        "Univ. of Alabama, Tuscaloosa, AL (United States)",
        "Arizona State Univ., Tempe, AZ (United States)",
        "National Renewable Energy Laboratory (NREL), Golden, CO (United States)"
      ],
      "description": "This Final Technical Report summarizes work completed under Award Number DEEE0009833, titled \"Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based Planar Perovskite Solar Cells.\" The project addressed the central technical problem that carbon-electrode perovskite solar cells (C-PSCs) can reduce electrode costs and improve environmental durability, but they have historically lagged noble-metalcontact devices due to poor carbon/perovskite contact, high carbon-electrode resistance, imperfect hole extraction, and insufficient operational stability. The Statement of Project Objectives (SOPO), therefore, required systematic engineering of thermally pressed carbon-based planar perovskite solar cells by improving the carbon/perovskite interface quality, improving carbon-electrode conductivity, and further increasing device stability. The work advanced understanding of carbon-based perovskite photovoltaics by connecting device performance to three coupled mechanisms: interfacial recombination at the perovskite/hole-transport-layer/carbon stack; lateral and vertical transport losses in carbon contacts; and instability driven by moisture, heat, illumination, ion migration, and slow/variable manufacturing steps.",
      "subjects": [
        "14 SOLAR ENERGY",
        "Perovskite Solar Cell, Carbon electrode, Efficiency, Stability"
      ],
      "sponsor_orgs": [
        "USDOE Office of Energy Efficiency and Renewable Energy (EERE), Renewable Power Office. Solar Energy Technologies Office",
        "USDOE Office of Critical Minerals and Energy Innovation (CMEI)"
      ]
    },
    "fulltext": {
      "available": true,
      "url": "https://www.osti.gov/servlets/purl/3484888",
      "doi_fallback": "https://doi.org/10.2172/3484888",
      "note": "OSTI serves the full text directly at this URL."
    }
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "osti-gov-records",
      "steward": "Office of Scientific and Technical Information",
      "system": "OSTI.GOV Search API",
      "dataset": "OSTI.GOV Search API",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": "10.2172/3484888",
        "recommended": null,
        "required": false
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "3484888",
      "locator": "https://www.osti.gov/biblio/3484888",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-27T11:00:26Z",
      "transformations": [
        "normalize"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "osti-gov-records"
    ]
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "No published rate limit means none of us knows what the real one is. If OSTI ever publishes one, or answers an email about it, this field becomes a number and the politeness budget follows it.",
      "source_id": "osti-gov-records"
    }
  ],
  "access_recipes": [
    {
      "kind": "doi",
      "uri": "https://doi.org/10.2172/3484888",
      "label": "Low-cost, Highly Efficient and Fast Thermally Pressed Scalable Carbon-based\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "fulltext_pdf",
      "uri": "https://www.osti.gov/servlets/purl/3484888",
      "label": "Full text (OSTI)",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://www.osti.gov/biblio/3484888",
      "label": "OSTI record page",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "research.get_record",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
osti-gov-records.json2026-09-22T12:33:14.364511+00:00c6fd5ded484f83064397a670a15639a4c3903b1add64a6ddcb849cf6da404d17

A capability not yet served

Skill: energy-project-site-screen

The registry names a proposed source for solar resource data. No solar-resource measurement was retrieved.

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Registry inventory only. Proposed sources were not queried.
  • Missing tool coverage does not mean the data does not exist.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo blocked --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Coverage

Coverage and source notes

registry.search_sources {"capability": "solar.get_resource"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: Local registry only

ReturnedTotal matches
11
  • nlr-developer-network
    DOE-MCP source registry and organization table · record nlr-developer-network
    No publisher locator supplied
    Record date: Unknown
Registry inventory; not a publisher query
SourceStateBlocked reason
NLR Developer NetworkproposedPhase 3. Needs the apidatagov_rest adapter and the credential UX proven out on EIA first (Phase 2), since this is the key whose shared budget is the more dangerous of the two.
Full response and evidence
{
  "data": {
    "sources": [
      {
        "id": "nlr-developer-network",
        "name": "NLR Developer Network",
        "domain": "energy-tech",
        "steward": "nlr",
        "authority_level": "primary",
        "declared_state": "proposed",
        "operational_state": "unknown",
        "automation_status": "public_api",
        "tier": "thin_proxy",
        "host": "gsa",
        "planned_capabilities": [
          "rates.find_tariffs",
          "solar.estimate_production",
          "solar.get_resource",
          "stations.find_alt_fuel"
        ],
        "blocked_reason": "Phase 3. Needs the apidatagov_rest adapter and the credential UX proven out on EIA first (Phase 2), since this is the key whose shared budget is the more dangerous of the two."
      }
    ],
    "record_count": 1,
    "total_matches": 1,
    "note": "Active sources can be queried now. Proposed ones are inventory: DOE-MCP knows they exist and each carries a blocked_reason saying what stands in the way. That is a different answer from 'we have never heard of it'."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "doe-mcp-registry",
      "steward": "The DOE-MCP project",
      "system": "DOE-MCP source registry and organization table",
      "dataset": "DOE-MCP source registry and organization table",
      "dataset_version": "2026-11-09",
      "authority_level": "unverified",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "nlr-developer-network",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit"
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "registry.search_sources",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256

BPA grid briefing

Skill: grid-status-brief

Latest recorded load: 5,728 MW at 09/03/2026 01:55 Pacific Time. This is a historical replay.

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • BPA balancing-authority load is not local connection capacity.
  • Publisher timestamps are Pacific Time; no UTC offset is inferred.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo grid --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Get bpa operations

Coverage and source notes

grid.get_bpa_operations {"intervals": 12}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: bpa-operations

  • Operational SCADA readings published minutes after the fact. They are situational awareness, not settled, revision-controlled or billing-quality figures, and should not be used as a system-of-record number.
BPA load · Pacific Time5894572809/03/2026 01:0009/03/2026 01:55
BPA load · Pacific Time
Publisher time/dateMW
09/03/2026 01:005894
09/03/2026 01:055832
09/03/2026 01:105812
09/03/2026 01:155823
09/03/2026 01:205877
09/03/2026 01:255874
09/03/2026 01:305866
09/03/2026 01:355877
09/03/2026 01:405839
09/03/2026 01:455826
09/03/2026 01:505801
09/03/2026 01:555728

The file ends with 12 timestamps without measurements. These trailing slots are excluded from the returned intervals.

Across the file through the latest measurement, 24 of 24 slots contain readings. Empty slots: 0.

Record sources
  • balancing_authority_interchange#09/03/2026 01:00
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:00
    No publisher locator supplied
    Record date: 09/03/2026 01:00
  • balancing_authority_interchange#09/03/2026 01:05
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:05
    No publisher locator supplied
    Record date: 09/03/2026 01:05
  • balancing_authority_interchange#09/03/2026 01:10
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:10
    No publisher locator supplied
    Record date: 09/03/2026 01:10
  • balancing_authority_interchange#09/03/2026 01:15
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:15
    No publisher locator supplied
    Record date: 09/03/2026 01:15
  • balancing_authority_interchange#09/03/2026 01:20
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:20
    No publisher locator supplied
    Record date: 09/03/2026 01:20
  • balancing_authority_interchange#09/03/2026 01:25
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:25
    No publisher locator supplied
    Record date: 09/03/2026 01:25
  • balancing_authority_interchange#09/03/2026 01:30
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:30
    No publisher locator supplied
    Record date: 09/03/2026 01:30
  • balancing_authority_interchange#09/03/2026 01:35
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:35
    No publisher locator supplied
    Record date: 09/03/2026 01:35
  • balancing_authority_interchange#09/03/2026 01:40
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:40
    No publisher locator supplied
    Record date: 09/03/2026 01:40
  • balancing_authority_interchange#09/03/2026 01:45
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:45
    No publisher locator supplied
    Record date: 09/03/2026 01:45
  • balancing_authority_interchange#09/03/2026 01:50
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:50
    No publisher locator supplied
    Record date: 09/03/2026 01:50
  • balancing_authority_interchange#09/03/2026 01:55
    BPA transmission operations feeds · record balancing_authority_interchange#09/03/2026 01:55
    No publisher locator supplied
    Record date: 09/03/2026 01:55
Full response and evidence
{
  "data": {
    "feed": "balancing_authority_interchange",
    "title": "BPA Balancing Authority Load & Total VER",
    "units": "MW",
    "columns": [
      "Load",
      "VER",
      "Hydro",
      "Fossil/Biomass",
      "Interchange",
      "Nuclear"
    ],
    "latest": {
      "timestamp": "09/03/2026 01:55",
      "values": {
        "Load": 5728,
        "VER": 623,
        "Hydro": 3726,
        "Fossil/Biomass": 804,
        "Interchange": 600,
        "Nuclear": 1134
      }
    },
    "intervals": [
      {
        "timestamp": "09/03/2026 01:00",
        "values": {
          "Load": 5894,
          "VER": 603,
          "Hydro": 3863,
          "Fossil/Biomass": 801,
          "Interchange": 548,
          "Nuclear": 1134
        }
      },
      {
        "timestamp": "09/03/2026 01:05",
        "values": {
          "Load": 5832,
          "VER": 600,
          "Hydro": 3988,
          "Fossil/Biomass": 801,
          "Interchange": 735,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 01:10",
        "values": {
          "Load": 5812,
          "VER": 593,
          "Hydro": 3954,
          "Fossil/Biomass": 801,
          "Interchange": 709,
          "Nuclear": 1132
        }
      },
      {
        "timestamp": "09/03/2026 01:15",
        "values": {
          "Load": 5823,
          "VER": 635,
          "Hydro": 3913,
          "Fossil/Biomass": 803,
          "Interchange": 700,
          "Nuclear": 1131
        }
      },
      {
        "timestamp": "09/03/2026 01:20",
        "values": {
          "Load": 5877,
          "VER": 663,
          "Hydro": 3898,
          "Fossil/Biomass": 803,
          "Interchange": 665,
          "Nuclear": 1138
        }
      },
      {
        "timestamp": "09/03/2026 01:25",
        "values": {
          "Load": 5874,
          "VER": 682,
          "Hydro": 3895,
          "Fossil/Biomass": 803,
          "Interchange": 683,
          "Nuclear": 1136
        }
      },
      {
        "timestamp": "09/03/2026 01:30",
        "values": {
          "Load": 5866,
          "VER": 671,
          "Hydro": 3906,
          "Fossil/Biomass": 804,
          "Interchange": 694,
          "Nuclear": 1139
        }
      },
      {
        "timestamp": "09/03/2026 01:35",
        "values": {
          "Load": 5877,
          "VER": 649,
          "Hydro": 3810,
          "Fossil/Biomass": 802,
          "Interchange": 557,
          "Nuclear": 1132
        }
      },
      {
        "timestamp": "09/03/2026 01:40",
        "values": {
          "Load": 5839,
          "VER": 654,
          "Hydro": 3793,
          "Fossil/Biomass": 802,
          "Interchange": 585,
          "Nuclear": 1134
        }
      },
      {
        "timestamp": "09/03/2026 01:45",
        "values": {
          "Load": 5826,
          "VER": 669,
          "Hydro": 3756,
          "Fossil/Biomass": 803,
          "Interchange": 579,
          "Nuclear": 1137
        }
      },
      {
        "timestamp": "09/03/2026 01:50",
        "values": {
          "Load": 5801,
          "VER": 660,
          "Hydro": 3795,
          "Fossil/Biomass": 804,
          "Interchange": 632,
          "Nuclear": 1133
        }
      },
      {
        "timestamp": "09/03/2026 01:55",
        "values": {
          "Load": 5728,
          "VER": 623,
          "Hydro": 3726,
          "Fossil/Biomass": 804,
          "Interchange": 600,
          "Nuclear": 1134
        }
      }
    ],
    "record_count": 12,
    "reported_through": "09/03/2026 01:55",
    "window": "Dates: 03Sep2026 - 10Sep2026 (last updated 9Sep2026 07:26:18) Pacific Time",
    "window_intervals": 24,
    "populated_intervals": 24,
    "gap_intervals": 0,
    "pending_intervals": 12,
    "publisher_last_updated": "9Sep2026 07:26:18",
    "timestamps": "The file uses Pacific Time. Rows may carry PDT or PST; keep the label when supplied. Last-Modified dates the file, not an individual reading.",
    "note": "Five-minute SCADA readings from BPA's balancing authority, in megawatts. VER is variable energy resources \u2014 wind and solar together. The balancing authority includes loads and resources that are not BPA's own and excludes BPA loads served by transfer, so this is not a figure for 'BPA the utility'. For hourly history, or for any other balancing authority, use energy.grid_status; BPA's EIA-930 respondent code is BPAT.",
    "pending_note": "The file ends with 12 timestamps without measurements. These trailing slots are excluded from the returned intervals."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "bpa-operations",
      "steward": "Bonneville Power Administration",
      "system": "BPA transmission operations feeds",
      "dataset": "BPA Balancing Authority Load & Total VER",
      "dataset_version": "current",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:00",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:00",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:05",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:05",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:10",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:10",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:15",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:15",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:20",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:20",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_06",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:25",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:25",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_07",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:30",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:30",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_08",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:35",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:35",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_09",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:40",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:40",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_10",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:45",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:45",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_11",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:50",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:50",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_12",
      "source_ref": "source_01",
      "record_id": "balancing_authority_interchange#09/03/2026 01:55",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "09/03/2026 01:55",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "bpa-operations"
    ],
    "time_range": {
      "from": "09/03/2026 01:00",
      "to": "09/03/2026 01:55"
    }
  },
  "warnings": [
    {
      "code": "screening_only",
      "message": "Operational SCADA readings published minutes after the fact. They are situational awareness, not settled, revision-controlled or billing-quality figures, and should not be used as a system-of-record number.",
      "source_id": "bpa-operations"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "grid.get_bpa_operations",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
bpa-operations.jsonUnknown; old recording4d69703d9b889d9a1c13fb09ec2476a79e4c0977f5f2a2b79a1fc4fd0139e394

CAISO demand briefing

Skill: grid-status-brief

3 hourly observations of CISO demand, in MWh. These are recorded observations, not a current grid report.

A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Measured hourly energy demand in MWh (D), not forecast (DF).
  • This regional series does not measure spare connection capacity.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo eia --output ./demo-output

Add --live to query publishers. EIA requires your own key. Live results and availability can differ.

1. Grid status

Coverage and source notes

energy.grid_status {"balancing_authority": "CISO", "hours": 3, "metric": "demand"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: eia-api-v2

  • Exact request-rate limits are not published in the v2 documentation this project has read. Treated as unknown, so the standard politeness budget applies.
  • EIA-930 publishes with a reporting lag and revises recent hours. The most recent observation here is not 'now'.
CISO measured demand; publisher periods
PeriodDemandUnits
2026-09-09T1330013megawatthours
2026-09-09T1230450megawatthours
2026-09-09T1130569megawatthours
Record sources
  • electricity/rto/region-data#0
    EIA API v2 · record electricity/rto/region-data#0
    No publisher locator supplied
    Record date: 2026-09-09T13
  • electricity/rto/region-data#1
    EIA API v2 · record electricity/rto/region-data#1
    No publisher locator supplied
    Record date: 2026-09-09T12
  • electricity/rto/region-data#2
    EIA API v2 · record electricity/rto/region-data#2
    No publisher locator supplied
    Record date: 2026-09-09T11
Full response and evidence
{
  "data": {
    "balancing_authority": "CISO",
    "metric": "Demand",
    "metric_code": "D",
    "observations": [
      {
        "period": "2026-09-09T13",
        "respondent": "CISO",
        "respondent-name": "California Independent System Operator",
        "type": "D",
        "type-name": "Demand",
        "value": "30013",
        "value-units": "megawatthours"
      },
      {
        "period": "2026-09-09T12",
        "respondent": "CISO",
        "respondent-name": "California Independent System Operator",
        "type": "D",
        "type-name": "Demand",
        "value": "30450",
        "value-units": "megawatthours"
      },
      {
        "period": "2026-09-09T11",
        "respondent": "CISO",
        "respondent-name": "California Independent System Operator",
        "type": "D",
        "type-name": "Demand",
        "value": "30569",
        "value-units": "megawatthours"
      }
    ],
    "record_count": 3,
    "units": "megawatthours",
    "note": "EIA-930 hourly demand for this balancing authority. Recent hours are PRELIMINARY and are revised: a number read today for last night may change. Treat it as operational reporting, not as a settled statistic. This route carries four metrics \u2014 demand, forecast, generation, interchange \u2014 under one `value` column, and only the one named above is here."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "eia-api-v2",
      "steward": "US Energy Information Administration",
      "system": "EIA API v2",
      "dataset": "EIA-930 hourly electric grid monitor",
      "dataset_version": "v2",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "electricity/rto/region-data#0",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-09T13",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "electricity/rto/region-data#1",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-09T12",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "electricity/rto/region-data#2",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-09-09T11",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "eia-api-v2"
    ],
    "time_range": {
      "from": "2026-09-09T11",
      "to": "2026-09-09T13"
    }
  },
  "warnings": [
    {
      "code": "terms_note",
      "message": "Exact request-rate limits are not published in the v2 documentation this project has read. Treated as unknown, so the standard politeness budget applies.",
      "source_id": "eia-api-v2"
    },
    {
      "code": "stale_source",
      "message": "EIA-930 publishes with a reporting lag and revises recent hours. The most recent observation here is not 'now'.",
      "source_id": "eia-api-v2"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "energy.grid_status",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
eia-api-v2.jsonUnknown; old recording339c0326900d553dd8146f9c5c379bdacde0bab625a34596f3dca670433ea48d

Rhode Island facility context

Skill: energy-project-site-screen

Sample: 5 wind records of 35 matches; 5 solar records of 71 matches. Site suitability remains unassessed.

Read 5 of 35 matches. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • First page only; map bounds describe returned points, not a complete site search.
  • Parcel ownership, queue position, available MW, tariffs and environmental clearance remain unknown.
  • NEPA-MCP is a separate installation and manual handoff. No external server was called.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo site --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

Facility coordinate map

Returned-point bounds: -71.7111, 41.5991 to -71.1539, 41.9861. Longitude/latitude plot; no parcel boundaries or base map. Green: wind. Amber: solar.

Wind: New England TechWind: Portsmouth Abbey SchoolWind: SandywoodsWind: Field's Point Wastewater Treatment FacilityWind: Field's Point Wastewater Treatment FacilitySolar: West Greenwich SolarSolar: Forbes Street SolarSolar: Johnston SolarSolar: BrooksideSolar: Little BayWest -71.7111East -71.1539North
Returned sample, not all Rhode Island facilities
TypeFacilityRecordLongitudeLatitude
WindNew England Tech3001502-71.451541.73279
WindPortsmouth Abbey School3015899-71.268741.59909
WindSandywoods3034241-71.153941.62049
WindField's Point Wastewater Treatment Facility3039300-71.389841.79279
WindField's Point Wastewater Treatment Facility3039301-71.387341.79449
SolarWest Greenwich Solar400417-71.711141.6518
SolarForbes Street Solar400618-71.340341.7738
SolarJohnston Solar401343-71.558541.8014
SolarBrookside401715-71.584841.9861
SolarLittle Bay401746-71.436241.799

1. Find wind turbines

Coverage and source notes

facility.find_wind_turbines {"rows": 5, "state": "RI"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: usgs-uswtdb

  • 1 of the 5 records returned carry a confidence code below the publisher's top score, which means the compilers could not fully confirm the location or the attributes from imagery and records. Those rows are estimates and are marked as such in the data; reporting them beside the confirmed ones without the distinction turns an estimate into a survey. The codes are decoded in confidence_codes.
ReturnedTotal matches
535
  • turbines#3001502
    US Wind Turbine Database (USWTDB) · record turbines#3001502
    No publisher locator supplied
    Record date: Unknown
  • turbines#3015899
    US Wind Turbine Database (USWTDB) · record turbines#3015899
    No publisher locator supplied
    Record date: Unknown
  • turbines#3034241
    US Wind Turbine Database (USWTDB) · record turbines#3034241
    No publisher locator supplied
    Record date: Unknown
  • turbines#3039300
    US Wind Turbine Database (USWTDB) · record turbines#3039300
    No publisher locator supplied
    Record date: Unknown
  • turbines#3039301
    US Wind Turbine Database (USWTDB) · record turbines#3039301
    No publisher locator supplied
    Record date: Unknown
Full response and evidence
{
  "data": {
    "records": [
      {
        "case_id": 3001502,
        "faa_ors": null,
        "faa_asn": null,
        "usgs_pr_id": 38309,
        "t_state": "RI",
        "t_county": "Kent County",
        "t_fips": "44003",
        "p_name": "New England Tech",
        "p_year": 2009,
        "p_tnum": 1,
        "p_cap": 0.1,
        "t_manu": "Northern Power Systems",
        "t_model": "NW100",
        "t_cap": 100,
        "t_hh": 37.0,
        "t_rd": 21.0,
        "t_rsa": 346.36,
        "t_ttlh": 47.5,
        "t_conf_atr": 2,
        "t_conf_loc": 3,
        "t_img_date": "9/13/2017",
        "t_img_src": "Maxar",
        "xlong": -71.4515,
        "ylat": 41.73279,
        "eia_id": null,
        "t_retrofit": 0,
        "t_retro_yr": null,
        "t_offshore": 0
      },
      {
        "case_id": 3015899,
        "faa_ors": "44-020002",
        "faa_asn": "2005-ANE-1002-OE",
        "usgs_pr_id": 38302,
        "t_state": "RI",
        "t_county": "Newport County",
        "t_fips": "44005",
        "p_name": "Portsmouth Abbey School",
        "p_year": 2006,
        "p_tnum": 1,
        "p_cap": 0.66,
        "t_manu": "Vestas",
        "t_model": "V47-0.66",
        "t_cap": 660,
        "t_hh": 50.0,
        "t_rd": 47.0,
        "t_rsa": 1734.94,
        "t_ttlh": 73.5,
        "t_conf_atr": 3,
        "t_conf_loc": 3,
        "t_img_date": null,
        "t_img_src": "Bing Maps Aerial",
        "xlong": -71.2687,
        "ylat": 41.59909,
        "eia_id": null,
        "t_retrofit": 0,
        "t_retro_yr": null,
        "t_offshore": 0
      },
      {
        "case_id": 3034241,
        "faa_ors": "44-020102",
        "faa_asn": "2010-WTE-12453-OE",
        "usgs_pr_id": 38304,
        "t_state": "RI",
        "t_county": "Newport County",
        "t_fips": "44005",
        "p_name": "Sandywoods",
        "p_year": 2012,
        "p_tnum": 1,
        "p_cap": 0.28,
        "t_manu": "Vergnet",
        "t_model": "GEV MP",
        "t_cap": 275,
        "t_hh": 55.0,
        "t_rd": 32.0,
        "t_rsa": 804.25,
        "t_ttlh": 71.0,
        "t_conf_atr": 3,
        "t_conf_loc": 3,
        "t_img_date": "11/18/2020",
        "t_img_src": "Maxar",
        "xlong": -71.1539,
        "ylat": 41.62049,
        "eia_id": null,
        "t_retrofit": 0,
        "t_retro_yr": null,
        "t_offshore": 0
      },
      {
        "case_id": 3039300,
        "faa_ors": "44-020088",
        "faa_asn": "2011-WTE-8243-OE",
        "usgs_pr_id": 38306,
        "t_state": "RI",
        "t_county": "Providence County",
        "t_fips": "44007",
        "p_name": "Field's Point Wastewater Treatment Facility",
        "p_year": 2012,
        "p_tnum": 3,
        "p_cap": 4.5,
        "t_manu": "Goldwind",
        "t_model": "GW82",
        "t_cap": 1500,
        "t_hh": 70.0,
        "t_rd": 82.0,
        "t_rsa": 5281.02,
        "t_ttlh": 110.9,
        "t_conf_atr": 3,
        "t_conf_loc": 3,
        "t_img_date": "2/16/2017",
        "t_img_src": "Maxar",
        "xlong": -71.3898,
        "ylat": 41.79279,
        "eia_id": 59692,
        "t_retrofit": 0,
        "t_retro_yr": null,
        "t_offshore": 0
      },
      {
        "case_id": 3039301,
        "faa_ors": "44-020089",
        "faa_asn": "2011-WTE-8244-OE",
        "usgs_pr_id": 38307,
        "t_state": "RI",
        "t_county": "Providence County",
        "t_fips": "44007",
        "p_name": "Field's Point Wastewater Treatment Facility",
        "p_year": 2012,
        "p_tnum": 3,
        "p_cap": 4.5,
        "t_manu": "Goldwind",
        "t_model": "GW82",
        "t_cap": 1500,
        "t_hh": 70.0,
        "t_rd": 82.0,
        "t_rsa": 5281.02,
        "t_ttlh": 110.9,
        "t_conf_atr": 3,
        "t_conf_loc": 3,
        "t_img_date": "2/16/2017",
        "t_img_src": "Maxar",
        "xlong": -71.3873,
        "ylat": 41.79449,
        "eia_id": 59692,
        "t_retrofit": 0,
        "t_retro_yr": null,
        "t_offshore": 0
      }
    ],
    "record_count": 5,
    "total_matches": 35,
    "offset": 0,
    "columns": [
      "case_id",
      "eia_id",
      "faa_asn",
      "faa_ors",
      "p_cap",
      "p_name",
      "p_tnum",
      "p_year",
      "t_cap",
      "t_conf_atr",
      "t_conf_loc",
      "t_county",
      "t_fips",
      "t_hh",
      "t_img_date",
      "t_img_src",
      "t_manu",
      "t_model",
      "t_offshore",
      "t_rd",
      "t_retro_yr",
      "t_retrofit",
      "t_rsa",
      "t_state",
      "t_ttlh",
      "usgs_pr_id",
      "xlong",
      "ylat"
    ],
    "query": [
      "t_state=eq.RI"
    ],
    "units": "t_cap is one turbine's rated capacity in kilowatts and p_cap is the whole project's capacity in megawatts, which are different units on adjacent columns. Hub height (t_hh), rotor diameter (t_rd) and total height to blade tip (t_ttlh) are metres; rotor swept area (t_rsa) is square metres; xlong and ylat are decimal degrees.",
    "confidence_codes": "t_conf_loc and t_conf_atr both run 1 to 3, and 3 is the confident case. Location: 1 means no turbine was visible in the image, 2 a pad or parts on the ground, 3 an installed turbine. Attributes: 1 means nothing beyond total height and year, 2 incomplete or conflicting sources, 3 complete and consistent across sources. t_img_date is the date of the image the location was checked against, and t_img_src names the imagery.",
    "dataset_version": "USWTDB V9.0 (26 June 2026)",
    "note": "An inventory of individual wind turbines: where they are and what they are, one row each, not how much they generated. For output, capacity factors, or anything hourly, use energy.get_data against EIA \u2014 the eia_id column on these rows is EIA's own plant id and is how the two line up. The API states no release version of its own, so dataset_version is this registry's record of the current release, checked 2026-09-08.",
    "more": "35 records match. Page with offset to read past the 5 returned here rather than describing these as all of them."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "usgs-uswtdb",
      "steward": "US Geological Survey",
      "funder": "Office of Critical Materials and Energy Innovation",
      "host": "US Geological Survey",
      "system": "US Wind Turbine Database (USWTDB)",
      "dataset": "US Wind Turbine Database (USWTDB)",
      "dataset_version": "USWTDB V9.0 (26 June 2026)",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": "10.5066/F7TX3DN0",
        "recommended": "Hoen, B.D., Diffendorfer, J.E., Rand, J.T., Kramer, L.A., Garrity, C.P., and Hunt, H.E., 2018, United States Wind Turbine Database V9.0 (June 26, 2026): U.S. Geological Survey, American Clean Power Association, and Lawrence Berkeley National Laboratory data release, https://doi.org/10.5066/F7TX3DN0.",
        "required": false
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "turbines#3001502",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "turbines#3015899",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "turbines#3034241",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "turbines#3039300",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "turbines#3039301",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "usgs-uswtdb"
    ]
  },
  "warnings": [
    {
      "code": "screening_only",
      "message": "1 of the 5 records returned carry a confidence code below the publisher's top score, which means the compilers could not fully confirm the location or the attributes from imagery and records. Those rows are estimates and are marked as such in the data; reporting them beside the confirmed ones without the distinction turns an estimate into a survey. The codes are decoded in confidence_codes.",
      "source_id": "usgs-uswtdb"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "facility.find_wind_turbines",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Find solar facilities

Coverage and source notes

facility.find_solar_facilities {"rows": 5, "state": "RI"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimcomplete
resulthit

Searched: usgs-uspvdb

ReturnedTotal matches
571
  • projects#400417
    US Large-Scale Solar Photovoltaic Database (USPVDB) · record projects#400417
    No publisher locator supplied
    Record date: Unknown
  • projects#400618
    US Large-Scale Solar Photovoltaic Database (USPVDB) · record projects#400618
    No publisher locator supplied
    Record date: Unknown
  • projects#401343
    US Large-Scale Solar Photovoltaic Database (USPVDB) · record projects#401343
    No publisher locator supplied
    Record date: Unknown
  • projects#401715
    US Large-Scale Solar Photovoltaic Database (USPVDB) · record projects#401715
    No publisher locator supplied
    Record date: Unknown
  • projects#401746
    US Large-Scale Solar Photovoltaic Database (USPVDB) · record projects#401746
    No publisher locator supplied
    Record date: Unknown
Full response and evidence
{
  "data": {
    "records": [
      {
        "case_id": 400417,
        "multi_poly": "single",
        "eia_id": 58214,
        "p_state": "RI",
        "p_county": "Kent",
        "ylat": 41.6518,
        "xlong": -71.7111,
        "p_area": 32794,
        "p_img_date": 20220306,
        "p_dig_conf": 4,
        "p_name": "West Greenwich Solar",
        "p_year": 2013,
        "p_pwr_reg": "ISNE",
        "p_tech_pri": "PV",
        "p_tech_sec": "c-si",
        "p_axis": "fixed-tilt",
        "p_azimuth": 180,
        "p_tilt": 25,
        "p_battery": null,
        "p_cap_ac": 1.9,
        "p_cap_dc": 2.0,
        "p_type": "greenfield",
        "p_agrivolt": "non-agrivoltaic",
        "p_zscore": -0.19,
        "p_comm": null,
        "p_sys_type": "ground"
      },
      {
        "case_id": 400618,
        "multi_poly": "multi",
        "eia_id": 58583,
        "p_state": "RI",
        "p_county": "Providence",
        "ylat": 41.7738,
        "xlong": -71.3403,
        "p_area": 113419,
        "p_img_date": 20210825,
        "p_dig_conf": 4,
        "p_name": "Forbes Street Solar",
        "p_year": 2013,
        "p_pwr_reg": "ISNE",
        "p_tech_pri": "PV",
        "p_tech_sec": "c-si",
        "p_axis": "fixed-tilt",
        "p_azimuth": 180,
        "p_tilt": 20,
        "p_battery": null,
        "p_cap_ac": 3.0,
        "p_cap_dc": 3.7,
        "p_type": "landfill",
        "p_agrivolt": "non-agrivoltaic",
        "p_zscore": -0.59,
        "p_comm": null,
        "p_sys_type": "ground"
      },
      {
        "case_id": 401343,
        "multi_poly": "single",
        "eia_id": 59858,
        "p_state": "RI",
        "p_county": "Providence",
        "ylat": 41.8014,
        "xlong": -71.5585,
        "p_area": 19906,
        "p_img_date": 20210830,
        "p_dig_conf": 4,
        "p_name": "Johnston Solar",
        "p_year": 2015,
        "p_pwr_reg": "ISNE",
        "p_tech_pri": "PV",
        "p_tech_sec": "c-si",
        "p_axis": "fixed-tilt",
        "p_azimuth": 180,
        "p_tilt": 25,
        "p_battery": null,
        "p_cap_ac": 1.0,
        "p_cap_dc": 1.5,
        "p_type": "greenfield",
        "p_agrivolt": "non-agrivoltaic",
        "p_zscore": 0.01,
        "p_comm": null,
        "p_sys_type": "ground"
      },
      {
        "case_id": 401715,
        "multi_poly": "single",
        "eia_id": 60451,
        "p_state": "RI",
        "p_county": "Providence",
        "ylat": 41.9861,
        "xlong": -71.5848,
        "p_area": 20315,
        "p_img_date": 20241008,
        "p_dig_conf": 4,
        "p_name": "Brookside",
        "p_year": 2015,
        "p_pwr_reg": "ISNE",
        "p_tech_pri": "PV",
        "p_tech_sec": "c-si",
        "p_axis": "fixed-tilt",
        "p_azimuth": 180,
        "p_tilt": 30,
        "p_battery": null,
        "p_cap_ac": 1.0,
        "p_cap_dc": 1.2,
        "p_type": "greenfield",
        "p_agrivolt": "non-agrivoltaic",
        "p_zscore": -0.22,
        "p_comm": null,
        "p_sys_type": "ground"
      },
      {
        "case_id": 401746,
        "multi_poly": "multi",
        "eia_id": 60495,
        "p_state": "RI",
        "p_county": "Providence",
        "ylat": 41.799,
        "xlong": -71.4362,
        "p_area": 16554,
        "p_img_date": 20241202,
        "p_dig_conf": 4,
        "p_name": "Little Bay",
        "p_year": 2014,
        "p_pwr_reg": "ISNE",
        "p_tech_pri": "PV",
        "p_tech_sec": "c-si",
        "p_axis": "fixed-tilt",
        "p_azimuth": 180,
        "p_tilt": 14,
        "p_battery": null,
        "p_cap_ac": 1.3,
        "p_cap_dc": 1.5,
        "p_type": "greenfield",
        "p_agrivolt": "non-agrivoltaic",
        "p_zscore": 0.22,
        "p_comm": null,
        "p_sys_type": "ground"
      }
    ],
    "record_count": 5,
    "total_matches": 71,
    "offset": 0,
    "columns": [
      "case_id",
      "eia_id",
      "multi_poly",
      "p_agrivolt",
      "p_area",
      "p_axis",
      "p_azimuth",
      "p_battery",
      "p_cap_ac",
      "p_cap_dc",
      "p_comm",
      "p_county",
      "p_dig_conf",
      "p_img_date",
      "p_name",
      "p_pwr_reg",
      "p_state",
      "p_sys_type",
      "p_tech_pri",
      "p_tech_sec",
      "p_tilt",
      "p_type",
      "p_year",
      "p_zscore",
      "xlong",
      "ylat"
    ],
    "query": [
      "p_state=eq.RI"
    ],
    "units": "p_cap_ac and p_cap_dc are megawatts, alternating and direct current, and the two differ for every facility. p_area is square metres, p_tilt and p_azimuth are degrees, and xlong and ylat are decimal degrees for the facility's centre rather than its outline.",
    "confidence_codes": "p_dig_conf runs 1 to 4, and 4 is the confident case: 1 means one polygon standing in for several facilities that could not be told apart, 2 several polygons drawn against unclear EIA records, 3 a polygon covering only part of the facility because the imagery was poor, 4 a facility polygon drawn with high confidence. In cases 1 to 3 the attributes may not describe the whole facility. p_img_date is the date of the image the boundary was digitised from, which is the honest vintage of the polygon.",
    "dataset_version": "USPVDB v4.0 (April 2026)",
    "note": "An inventory of utility-scale solar facilities of one megawatt and up: where they are and what they are, one row each, not how much they generated. For output, capacity factors, or anything hourly, use energy.get_data against EIA \u2014 the eia_id column on these rows is EIA's own plant id and is how the two line up. The API states no release version of its own, so dataset_version is this registry's record of the current release, checked 2026-09-08.",
    "more": "71 records match. Page with offset to read past the 5 returned here rather than describing these as all of them."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "usgs-uspvdb",
      "steward": "US Geological Survey",
      "funder": "Office of Critical Materials and Energy Innovation",
      "host": "US Geological Survey",
      "system": "US Large-Scale Solar Photovoltaic Database (USPVDB)",
      "dataset": "US Large-Scale Solar Photovoltaic Database (USPVDB)",
      "dataset_version": "USPVDB v4.0 (April 2026)",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": "10.5066/P9IA3TUS",
        "recommended": "Fujita, K.S., Ancona, Z.H., Kramer, L.A., Straka, M., Gautreau, T.E., Garrity, C.P., Robson, D., Diffendorfer, J.E., and Hoen, B., 2023, United States Large-Scale Solar Photovoltaic Database (v4.0, April 2026): U.S. Geological Survey and Lawrence Berkeley National Laboratory data release, https://doi.org/10.5066/P9IA3TUS.",
        "required": false
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "projects#400417",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "projects#400618",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "projects#401343",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "projects#401715",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "projects#401746",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "usgs-uspvdb"
    ]
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "facility.find_solar_facilities",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

3. Coverage

Coverage and source notes

registry.search_sources {"capability": "grid.interconnection_queue"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: Local registry only

ReturnedTotal matches
11
  • lbnl-emp-datasets
    DOE-MCP source registry and organization table · record lbnl-emp-datasets
    No publisher locator supplied
    Record date: Unknown
Registry inventory; not a publisher query
SourceStateBlocked reason
LBNL Electricity Markets and Policy datasetsproposedPhase 3. Spreadsheet parsing per annual edition; no access obstacle.
Full response and evidence
{
  "data": {
    "sources": [
      {
        "id": "lbnl-emp-datasets",
        "name": "LBNL Electricity Markets and Policy datasets",
        "domain": "energy",
        "steward": "lbnl",
        "authority_level": "primary",
        "declared_state": "proposed",
        "operational_state": "unknown",
        "automation_status": "public_download",
        "tier": "catalog_pointer",
        "planned_capabilities": [
          "grid.interconnection_queue"
        ],
        "blocked_reason": "Phase 3. Spreadsheet parsing per annual edition; no access obstacle."
      }
    ],
    "record_count": 1,
    "total_matches": 1,
    "note": "Active sources can be queried now. Proposed ones are inventory: DOE-MCP knows they exist and each carries a blocked_reason saying what stands in the way. That is a different answer from 'we have never heard of it'."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "doe-mcp-registry",
      "steward": "The DOE-MCP project",
      "system": "DOE-MCP source registry and organization table",
      "dataset": "DOE-MCP source registry and organization table",
      "dataset_version": "2026-11-09",
      "authority_level": "unverified",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "lbnl-emp-datasets",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit"
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "registry.search_sources",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

4. Other tools

Coverage and source notes

registry.list_neighbors {"capability": ""}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: Local registry only

  • building-simulation-mcps
    DOE-MCP source registry and organization table · record building-simulation-mcps
    No publisher locator supplied
    Record date: Unknown
  • genesis-agent-skills
    DOE-MCP source registry and organization table · record genesis-agent-skills
    No publisher locator supplied
    Record date: Unknown
  • genesis-lane-servers
    DOE-MCP source registry and organization table · record genesis-lane-servers
    No publisher locator supplied
    Record date: Unknown
  • materials-project-mcp
    DOE-MCP source registry and organization table · record materials-project-mcp
    No publisher locator supplied
    Record date: Unknown
  • nasa-earthdata-mcp
    DOE-MCP source registry and organization table · record nasa-earthdata-mcp
    No publisher locator supplied
    Record date: Unknown
  • nepa-mcp
    DOE-MCP source registry and organization table · record nepa-mcp
    No publisher locator supplied
    Record date: Unknown
Full response and evidence
{
  "data": {
    "neighbors": [
      {
        "id": "building-simulation-mcps",
        "name": "EnergyPlus-MCP and OpenStudio-MCP",
        "kind": "server",
        "maintainer": "LBNL Energy Technologies Area; National Laboratory of the Rockies",
        "status": "listed",
        "compliance": "opaque",
        "why_not_absorbed": "A different product class. These wrap SIMULATORS \u2014 you give them a model and they run it \u2014 where DOE-MCP serves published data. Wrapping a simulator means owning its installation, its version compatibility, and its runtime, none of which the provenance envelope has anything useful to say about. The 185 or more combined tools would also breach the sizing ceiling ninefold.",
        "tool_count": 185,
        "install": {
          "method": "source",
          "command": "git clone https://github.com/LBNL-ETA/EnergyPlus-MCP"
        },
        "repository": "https://github.com/LBNL-ETA/EnergyPlus-MCP"
      },
      {
        "id": "genesis-agent-skills",
        "name": "Genesis Agent Skills (DOE ModCon)",
        "kind": "skill_pack",
        "maintainer": "ModCon BASE team, co-led by PNNL and Berkeley Lab",
        "status": "listed",
        "compliance": "opaque",
        "why_not_absorbed": "It is instructions rather than data or tools, so there is nothing for DOE-MCP to wrap. Its subtrees carry different licenses and some carry none, so nothing is copied here. DOE-MCP's own skills use the same Agent Skills file format. The October review checked them with the upstream validator. Since then, local demos have applied selected Genesis methods to DOE records without running the upstream scripts.",
        "install": {
          "method": "source",
          "command": "git clone https://github.com/AI-ModCon/genesis-skills"
        },
        "repository": "https://github.com/AI-ModCon/genesis-skills"
      },
      {
        "id": "genesis-lane-servers",
        "name": "DOE Genesis Mission MCP deployments (gated)",
        "kind": "server",
        "maintainer": "Various DOE national laboratories",
        "status": "watch",
        "compliance": "opaque",
        "why_not_absorbed": "Access-gated by design and pointed at internal instruments, facilities, and compute. Wrapping a gated server would produce a tool that fails for every public user, which is worse than not having it. The named watch items are BNL's PanDA MCP, Argonne's Globus-service MCPs and LBNL's CBorg.",
        "install": {
          "method": "source",
          "command": "unavailable \u2014 access is gated (OneID / RFA / SSO)"
        }
      },
      {
        "id": "materials-project-mcp",
        "name": "Materials Project MCP (inside mp-api)",
        "kind": "server",
        "maintainer": "Materials Project, Lawrence Berkeley National Laboratory",
        "status": "watch",
        "compliance": "full",
        "why_not_absorbed": "It IS absorbed, which is why this entry exists to say so. Materials Project ships its first-party MCP server inside the `mp-api` Python library (search and fetch shipped as of 0.46.0; fetch_all, fetch_many, phase-diagram lookup and an mpmcp CLI in development). Because the upstream ships a LIBRARY rather than only a server, decision 0011 routes it to depend-and-wrap: declare the dependency, write thin tools over it, and avoid asking a user to install and configure a second MCP server for one domain. The library's surface is reshaped into DOE-MCP's tool contract rather than re-exported, because 0014's sizing bands bind a wrapper like anything else.",
        "capabilities": [
          "materials.search"
        ],
        "install": {
          "method": "pip",
          "command": "pip install \"doe-mcp[materials]\""
        },
        "repository": "https://github.com/materialsproject/api"
      },
      {
        "id": "nasa-earthdata-mcp",
        "name": "NASA Earthdata (CMR) MCP",
        "kind": "server",
        "maintainer": "NASA Earthdata",
        "status": "listed",
        "compliance": "opaque",
        "why_not_absorbed": "Another agency's data and another agency's server, already hosted and already working. Rebuilding it would duplicate NASA's own infrastructure to no one's benefit. The overlap with DOE-MCP is narrow and specific \u2014 the ORNL DAAC \u2014 and there the publisher triple already carries the answer on every provenance entry: ORNL operates it, NASA funds it.",
        "capabilities": [
          "earth.search_datasets"
        ],
        "install": {
          "method": "source",
          "command": "remote server \u2014 configure the endpoint cmr.earthdata.nasa.gov/mcp/v1"
        }
      },
      {
        "id": "nepa-mcp",
        "name": "NEPA-MCP",
        "kind": "server",
        "maintainer": "Pacific Northwest National Laboratory",
        "status": "listed",
        "compliance": "opaque",
        "why_not_absorbed": "Server-only and far too large. 56 tools across 23 servers is more than twice the hard ceiling a single DOE-MCP profile may carry, and its release cadence \u2014 every three to six days \u2014 would make any wrapper permanently behind. DOE-MCP registers the underlying NEPA document database as a `proposed` manifest that says exactly this, so the registry answers \"not a gap, a decision\".",
        "capabilities": [
          "docs.search_nepa"
        ],
        "tool_count": 56,
        "install": {
          "method": "pipx",
          "command": "pipx install nepa-mcp"
        },
        "repository": "https://github.com/pnnl/nepa-mcp"
      }
    ],
    "record_count": 6,
    "note": "MCP has no mechanism for one server to advertise or install another (checked against the protocol 2026-09-01), so these carry executable install commands rather than links. Results from a server listed as 'opaque' are unverified external evidence and should be labelled as such \u2014 being official does not make a server's output carry provenance. A 'skill_pack' is agent instructions, not a server: there is nothing to call, and its skills can run commands, so read one before using it."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "doe-mcp-registry",
      "steward": "The DOE-MCP project",
      "system": "DOE-MCP source registry and organization table",
      "dataset": "DOE-MCP source registry and organization table",
      "dataset_version": "2026-11-09",
      "authority_level": "unverified",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "building-simulation-mcps",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "genesis-agent-skills",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "genesis-lane-servers",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "materials-project-mcp",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "nasa-earthdata-mcp",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_06",
      "source_ref": "source_01",
      "record_id": "nepa-mcp",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit"
  },
  "warnings": [],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "registry.list_neighbors",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
usgs-uspvdb.jsonUnknown; old recording4d93ec19e3b23d1de9ad1a1d618cca40070ae455764062a91d8a19a4c975c24c
usgs-uswtdb.jsonUnknown; old recording717c92092351ab13cd9ad61bd10f8988c06748fe63201b872ef22d12fd23b70a

Environmental study brief

Skill: environmental-study-brief

Permafrost dataset results and five days of modelled Oak Ridge weather are shown separately. No study-site match is established.

Read 5 of 329 matches. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • The dataset search and Oak Ridge weather example are independent; no geographic or temporal relationship is asserted.
  • Daymet values are modelled grid-cell estimates, not station observations.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo earth --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Search datasets

Coverage and source notes

earth.search_datasets {"rows": 5, "text": "permafrost"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: ess-dive

ReturnedTotal matches
5329

Publisher access recipes

  • ess-dive-3ae4bf47c8a5c01-20260821T191107282
    ESS-DIVE (Environmental System Science Data Infrastructure) · record ess-dive-3ae4bf47c8a5c01-20260821T191107282
    Publisher record
    Record date: 2026-08-21T19:11:09.012Z
  • ess-dive-59891b16a14f206-20260821T190846262
    ESS-DIVE (Environmental System Science Data Infrastructure) · record ess-dive-59891b16a14f206-20260821T190846262
    Publisher record
    Record date: 2026-08-21T19:08:47.405Z
  • ess-dive-9b961ab3bdda867-20260817T151917925
    ESS-DIVE (Environmental System Science Data Infrastructure) · record ess-dive-9b961ab3bdda867-20260817T151917925
    Publisher record
    Record date: 2026-08-17T15:19:19.031Z
  • ess-dive-387aca9b8ac0fa9-20260717T202253310452
    ESS-DIVE (Environmental System Science Data Infrastructure) · record ess-dive-387aca9b8ac0fa9-20260717T202253310452
    Publisher record
    Record date: 2026-07-17T20:22:54.969Z
  • ess-dive-b92428d4a59674c-20260717T202221097472
    ESS-DIVE (Environmental System Science Data Infrastructure) · record ess-dive-b92428d4a59674c-20260717T202221097472
    Publisher record
    Record date: 2026-07-17T20:22:24.225Z
Full response and evidence
{
  "data": {
    "datasets": [
      {
        "package_id": "ess-dive-3ae4bf47c8a5c01-20260821T191107282",
        "doi": "doi:10.5440/1575068",
        "name": "Leaf Carbon and Nitrogen Content, Seward Peninsula, Alaska, 2014",
        "description": "Carbon and nitrogen content of leaves sampled from locations on the Council, Kougarok and Teller roads, Seward Peninsula, Alaska. Species not fully identified in all cases, but include samples from the genera: Alnus, Arctagrostis, Arctophila, Arctostaphylos, Betula, Carex, Eriophorum, Petasites, Picea, Populus, Rubus, Salix, Saxifraga and Vaccinium. Locations along the Council, Kougarok and Teller roads, Seward Peninsula, Alaska. Samples were collected from various locations as part of reconnaissance field work prior to establishment of formal NGEE Arctic study sites between August 22, 2014 and August 24, 2014. There is a single datafile in .csv format. The Next-Generation Ecosystem Experiments: Arctic (NGEE Arctic), was a research effort to reduce uncertainty in Earth System Models by developing a predictive understanding of carbon-rich Arctic ecosystems and feedbacks to climate. NGEE Arctic was supported by the Department of Energy's Office of Biological and Environmental Research. The NGEE Arctic project had two field research sites: 1) located within the Arctic polygonal tundra coastal region on the Barrow Environmental Observatory (BEO) and the North Slope near Utqiagvik (Barrow), Alaska and 2) multiple areas on the discontinuous permafrost region of the Seward Peninsula north of Nome, Alaska. Through observations, experiments, and synthesis with existing datasets, NGEE Arctic provided an enhanced knowledge base for multi-scale modeling and contributed to improved process representation at global pan-Arctic scales within the Department of Energy's Earth system Model (the Energy Exascale Earth System Model, or E3SM), and specifically within the E3SM Land Model component (ELM).",
        "project": null,
        "creators": [],
        "funders": [],
        "keywords": [],
        "places": [],
        "temporal_coverage": {},
        "date_published": "2020",
        "date_uploaded": "2026-08-21T19:11:09.012Z",
        "date_modified": "2026-08-21T19:11:09.243Z",
        "view_url": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1575068"
      },
      {
        "package_id": "ess-dive-59891b16a14f206-20260821T190846262",
        "doi": "doi:10.3334/CDIAC/SPRUCE.042",
        "name": "SPRUCE Geochemical Changes in Porewater from Northern Peatlands at Multiple Depths in Field Samples and over Time in Peat Incubations",
        "description": "This data set reports the results of the analysis of dissolved organic matter (DOM) in porewater samples collected from multiple depths in northern peatlands and during laboratory peat incubations to characterize the gain or loss of specific chemical moieties (e.g. CH2, H2, CH2O, etc.) that may be attributed to microbial degradation. During incubations, CO2 and CH4 concentrations and stable isotopes were determined by isotope ratio mass spectrometry. Porewater samples were collected from the S1 Bog (April 2015), a Sphagnum-dominated site at northern Minnesota peatland in the Marcell Experimental Forest, using permanently-installed piezometers, which provided profiles from the watertable surface to 200 cm depth. This is the site of the SPRUCE experiment. Porewater and peat samples were collected in July 2015 from an additional Sphagnum-dominated site within Stordalen Mire, Sweden, a palsa mire underlain by thawing permafrost, using perforated stainless steel tubes that were inserted into the peat to the desired depths (13 cm and 32 cm). Porewater samples were analyzed by Fourier transform ion cyclotron resonance mass spectrometry (FTICRMS) followed by Kendrick mass transform analysis. The Kendrick mass (i.e., Kendrick 1963) transform analysis identifies the gain or loss of specific chemical moieties (e.g. CH2, H2, CH2O, etc.) via mass differences, and was used to infer potential microbial degradation pathways by which compounds were consumed in these samples. Increasing depth would suggest more degradation of DOM with the greater length of time for peat accumulation and similarly, with increasing length of peat incubation. During incubations, CO2 and CH4 concentrations and stable isotopes were determined by isotope ratio mass spectrometry. There are four files provided in comma separated value (*.csv) format.",
        "project": null,
        "creators": [],
        "funders": [],
        "keywords": [],
        "places": [],
        "temporal_coverage": {},
        "date_published": "2017",
        "date_uploaded": "2026-08-21T19:08:47.405Z",
        "date_modified": "2026-08-21T19:08:47.514Z",
        "view_url": "https://data.ess-dive.lbl.gov/view/doi:10.3334/CDIAC/SPRUCE.042"
      },
      {
        "package_id": "ess-dive-9b961ab3bdda867-20260817T151917925",
        "doi": "doi:10.15485/3023308",
        "name": "Permafrost Thaw, Uneven Subsidence and Projected Drying of Ice-wedge Polygon Tundra: Modeling Archive",
        "description": "This dataset is a model archive of the paper Permafrost Thaw, Uneven Subsidence and Projected Drying of Ice-wedge Polygon Tundra (in prep) to support a modeling study investigating how projected increases in Arctic temperature and precipitation will jointly influence hydrologic conditions in ice-rich tundra landscapes. With this dataset, this study is to address the research question: Will Arctic tundra landscapes become wetter or drier with increasing precipitation and temperature in the future when thaw-induced ground subsidence and associated microtopographic evolution are represented? The simulations focus on ice-wedge polygon tundra, a widespread form of ice-rich permafrost terrain that is highly sensitive to thaw-driven landscape change. This dataset contains model input and output data for four study watersheds in Alaska: Anaktuvuk, Utqiagvik (formerly Barrow), Brooks Foothills, and Prudhoe Bay. Simulations were performed using the Advanced Terrestrial Simulator (ATS, v1.5), a physics-rich integrated surface\u2013subsurface hydrologic model. For each watershed, ten modeling cases were performed representing two landscape evolution conditions (with subsidence and without subsidence) combined with five climate forcing scenarios derived from Shared Socioeconomic Pathways (SSP5, SSP5 with precipitation trend, SSP2, SSP2 with precipitation trend, and SSP2 with double precipitation trend). Particularly, for each watershed under the forcing SSP2 with precipitation trend, there are two additional simulations considering spatially heterogeneous subsidence distributions: one assumes randomly distributed scaling and the other includes elevation dependent distribution scaling. These simulations span 1980\u20132099 and include spin-up runs (1980\u20132009) followed by transient projections (2010\u20132099). To facilitate reproducibility of simulations, all datasets are organized by watershed. For each study watershed, the dataset contains: (1) Pre-partitioned mesh files for 32-core modeling (.par.32.XX), located in EACH_WATERSHED/mesh/basin; and also a non-partitioned mesh file (.exo) located in EACH_WATERSHED/mesh; (2) Climate forcings corresponding to the five SSP scenarios (.h5), located in EACH_WATERSHED/data; (3) Final states (.h5) from column spin-up modeling used to initialize historical watershed-scale spin-up runs from 1980 to 2009, located in EACH_WATERSHED/PreSpinupHistorical; (4) Final states (.h5) of historical watershed-scale spin-up runs from 1980 to 2009 used to initialize projection runs, located in EACH_WATERSHED/Spinup_daymetERA5; (5) ATS modeling input files (.xml), located in EACH_WATERSHED/EACH_SIMULATION_SCENARIO/inputfiles; (6) ATS modeling output files (.dat), located in in EACH_WATERSHED/EACH_SIMULATION_SCENARIO/combined_obs; (7) For the Brooks Foothills watershed, additional spatial model outputs are provided (.h5) for selected years (2033 and 2093) used to generate spatial figures in this study, located in Brooksfoothills/EACH_SIMULATION_SCENARIO/results-WITH/WITHOUT_SUBSIDENCE-year2033/2093. All data files with suffix .h5 can be accessible through Python h5py, and all data files with suffix of .dat can be imported by Python pandas. Mesh file with .exo can be visualized through Paraview or read by Python netCDF. The Next-Generation Ecosystem Experiments in the Arctic (NGEE Arctic) project is a research effort to reduce uncertainty in the Department of Energy\u2019s Energy Exascale Earth System Model (E3SM) by developing a predictive understanding of Arctic tundra ecosystems underlain by permafrost and to quantify feedbacks from the Arctic tundra to the Earth system. NGEE Arctic is supported by the Department of Energy's Office of Biological and Environmental Research. Over Phases 1\u20133, observations made by the NGEE Arctic team across a gradient of permafrost landscapes in Arctic Alaska improved the representation of tundra processes in the land surface component of E3SM (the E3SM Land Model, ELM). Model improvements emphasized unique aspects of permafrost environments and explored reductions in model complexity while retaining predictive power. The Arctic-informed ELM developed by NGEE Arctic has been used to make novel predictions on processes ranging from permafrost thaw to soil biogeochemical cycling to Earth system feedbacks associated with the unique characteristics of tundra plants. In Phase 4, the NGEE Arctic team is evaluating our new predictive understanding under novel conditions across the Arctic domain. In collaboration with partners at long-term pan-Arctic research sites we are examining whether an Arctic-informed ELM can faithfully simulate interactions among surface and subsurface processes at site, regional, and pan-Arctic scales. In turn, we are using variety of tools to dynamically extend and evaluate ELM inference, with an emphasis on data synthesis and pan-Arctic model evaluation, reintegration of code with an evolving E3SM, scaling across heterogeneous Arctic landscapes, and the appropriate representation of the impacts of increasingly frequent Arctic disturbances.",
        "project": null,
        "creators": [],
        "funders": [],
        "keywords": [],
        "places": [],
        "temporal_coverage": {},
        "date_published": "2026",
        "date_uploaded": "2026-08-17T15:19:19.031Z",
        "date_modified": "2026-08-17T15:19:19.186Z",
        "view_url": "https://data.ess-dive.lbl.gov/view/doi:10.15485/3023308"
      },
      {
        "package_id": "ess-dive-387aca9b8ac0fa9-20260717T202253310452",
        "doi": "doi:10.5440/1832016",
        "name": "National Center for Airborne Laser Mapping (NCALM) LiDAR, Imagery, and DEM data from five NGEE Arctic Sites, Seward Peninsula, Alaska, August 2021",
        "description": "From August 8 through August 16 of 2021, airborne remote sensing data was collected by the National Center for Airborne Laser Mapping (NCALM) in collaboration with NGEE Arctic scientists. Data was collected around five NGEE Arctic study sites on the Seward Peninsula of Alaska: Teller mm 27, Teller mm 47, Kougarok mm 64, Kougarok mm 86, and Council mm 71. A Robinson R44 II helicopter with a RIEGL VQ-580 II airborne laser scanner was used to collect the LiDAR point cloud data for each study site. A Phase One iXM-RS100F camera was integrated with the Riegl sensor to collect RGB imagery. This data package contains LiDAR point clouds (.las), RGB imagery (tif), 1 m or 50 cm Digital Elevation Models (.tif) generated from the LiDAR data, and shapefiles of the .las tiling system for each site (.shp). Two supplemental documents are also included in the package: 1) a report describing data collection details, GNSS corrections, and processing steps and 2) a document describing the LiDAR Classification used (.pdf). This survey was conducted towards the end of the summer on the Seward Peninsula, and can be paired with data collected in April of 2022 during the snow-on campaign \"National Center for Airborne Laser Mapping (NCALM) LiDAR and DEM data from two NGEE Arctic Sites, Seward Peninsula, Alaska, Winter 2022\" (Singhania et.al, 2023) (NGA314).  The Next-Generation Ecosystem Experiments: Arctic (NGEE Arctic), was a research effort to reduce uncertainty in Earth System Models by developing a predictive understanding of carbon-rich Arctic ecosystems and feedbacks to climate. NGEE Arctic was supported by the Department of Energy's Office of Biological and Environmental Research. The NGEE Arctic project had two field research sites: 1) located within the Arctic polygonal tundra coastal region on the Barrow Environmental Observatory (BEO) and the North Slope near Utqiagvik (Barrow), Alaska and 2) multiple areas on the discontinuous permafrost region of the Seward Peninsula north of Nome, Alaska. Through observations, experiments, and synthesis with existing datasets, NGEE Arctic provided an enhanced knowledge base for multi-scale modeling and contributed to improved process representation at global pan-Arctic scales within the Department of Energy's Earth system Model (the Energy Exascale Earth System Model, or E3SM), and specifically within the E3SM Land Model component (ELM).",
        "project": null,
        "creators": [],
        "funders": [],
        "keywords": [],
        "places": [],
        "temporal_coverage": {},
        "date_published": "2023",
        "date_uploaded": "2026-07-17T20:22:54.969Z",
        "date_modified": "2026-07-17T20:22:55.053Z",
        "view_url": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1832016"
      },
      {
        "package_id": "ess-dive-b92428d4a59674c-20260717T202221097472",
        "doi": "doi:10.5440/1778212",
        "name": "Landscape-scale Characterization of Arctic Tundra Vegetation Composition, Structure, and Function with a Multi-sensor Unoccupied Aerial System: Supporting Data.",
        "description": "Airborne remote sensing data collected using the Brookhaven National Laboratory's (BNL) heavy-lift unoccupied aerial system (UAS) octocopter platform, the Osprey, operated by the Terrestrial Ecosystem Science and Technology (TEST) group (https://www.bnl.gov/testgroup). This package includes data from three flights flown over the NGEE-Arctic Council, Kougarok and Teller sites in July, 2018. The Osprey is a multi-sensor UAS platform that simultaneously measures very high spatial resolution optical red/green/blue (RGB) and thermal infrared (TIR) surface 'skin' temperature imagery, as well as surface reflectance at 1 nm intervals in the visible to near-infrared spectral range 350 - 1000 nm measured at regular intervals along each flight path. Derived image products include ortho-mosaiced RGB and TIR images, an RGB-based digital surface model (DSM) using the structure from motion (SfM) technique, digital terrain model (DTM), and a canopy height model (CHM). In addition, a VNIR surface reflectance file is provided for the trigger locations collected during each flight campaign. Ancillary aircraft data, flight mission parameters, and general flight conditions provided by the onboard flight and data collection computers are also included. Unprocessed and processed data products are included in this package (processing levels 0-3). Data and metadata are provided as text (*.txt, *.json, *.kml, *hdr, *.enp), tabular (*.dat, *.csv, *.waypoint, ENVI format (no extension)), point cloud (*.laz) and image (*.jpg, *.tif, *png) formats. This metadata document contains flight campaign, instrument and file metadata, along with a description of data processing levels, data products and file naming scheme.The Next-Generation Ecosystem Experiments: Arctic (NGEE Arctic), a research effort to reduce uncertainty in Earth System Models by developing a predictive understanding of carbon-rich Arctic ecosystems and feedbacks to climate. NGEE Arctic was supported by the Department of Energy?s Office of Biological and Environmental Research.The NGEE Arctic project had two field research sites: 1) located within the Arctic polygonal tundra coastal region on the Barrow Environmental Observatory (BEO) and the North Slope near Utqiagvik (Barrow), Alaska and 2) multiple areas on the discontinuous permafrost region of the Seward Peninsula north of Nome, Alaska.Through observations, experiments, and synthesis with existing datasets, NGEE Arctic provided an enhanced knowledge base for multi-scale modeling and contributed to improved process representation at global pan-Arctic scales within the Department of Energy's Earth system Model (the Energy Exascale Earth System Model, or E3SM), and specifically within the E3SM Land Model component (ELM).",
        "project": null,
        "creators": [],
        "funders": [],
        "keywords": [],
        "places": [],
        "temporal_coverage": {},
        "date_published": "2021",
        "date_uploaded": "2026-07-17T20:22:24.225Z",
        "date_modified": "2026-07-17T20:22:24.350Z",
        "view_url": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1778212"
      }
    ],
    "record_count": 5,
    "total_matches": 329,
    "offset": 0,
    "searched": {
      "isPublic": true,
      "text": "permafrost",
      "sort": "dateUploaded:desc"
    },
    "note": "Package-level metadata from DOE's environmental system science repository. Each record points at files held in the repository rather than carrying them; earth.get_dataset returns one record in full. The search runs over metadata, so a variable measured but never named in a record's keywords or description is not findable here."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "ess-dive",
      "steward": "Lawrence Berkeley National Laboratory",
      "funder": "Biological and Environmental Research",
      "system": "ESS-DIVE (Environmental System Science Data Infrastructure)",
      "dataset": "ESS-DIVE (Environmental System Science Data Infrastructure)",
      "dataset_version": "current",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "ess-dive-3ae4bf47c8a5c01-20260821T191107282",
      "locator": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1575068",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-21T19:11:09.012Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "ess-dive-59891b16a14f206-20260821T190846262",
      "locator": "https://data.ess-dive.lbl.gov/view/doi:10.3334/CDIAC/SPRUCE.042",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-21T19:08:47.405Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "ess-dive-9b961ab3bdda867-20260817T151917925",
      "locator": "https://data.ess-dive.lbl.gov/view/doi:10.15485/3023308",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-08-17T15:19:19.031Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "ess-dive-387aca9b8ac0fa9-20260717T202253310452",
      "locator": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1832016",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-07-17T20:22:54.969Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "ess-dive-b92428d4a59674c-20260717T202221097472",
      "locator": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1778212",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2026-07-17T20:22:24.225Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "ess-dive"
    ],
    "known_limitations": [
      "A repository, so coverage is what investigators deposited. Absence reflects deposit practice, not the absence of research.",
      "Package-level metadata is well structured; the files inside a package are heterogeneous scientific formats reached by pointer.",
      "The search is over metadata, not over the data files. A variable measured but not named in the record's keywords or description is not findable here.",
      "Paging counts rows from one, not from zero. The service refuses rowStart=0 outright, which makes it the one paging mistake on this source that cannot pass silently."
    ]
  },
  "warnings": [],
  "access_recipes": [
    {
      "kind": "landing_page",
      "uri": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1575068",
      "label": "Leaf Carbon and Nitrogen Content, Seward Peninsula, Alaska, 2014",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://data.ess-dive.lbl.gov/view/doi:10.3334/CDIAC/SPRUCE.042",
      "label": "SPRUCE Geochemical Changes in Porewater from Northern Peatlands at Multiple\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://data.ess-dive.lbl.gov/view/doi:10.15485/3023308",
      "label": "Permafrost Thaw, Uneven Subsidence and Projected Drying of Ice-wedge Polygon\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1832016",
      "label": "National Center for Airborne Laser Mapping (NCALM) LiDAR, Imagery, and DEM\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://data.ess-dive.lbl.gov/view/doi:10.5440/1778212",
      "label": "Landscape-scale Characterization of Arctic Tundra Vegetation Composition\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "earth.search_datasets",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Get daymet point

Coverage and source notes

earth.get_daymet_point {"end": "2023-06-05", "latitude": 35.9313, "longitude": -84.3104, "start": "2023-06-01", "variables": "prcp,tmax,tmin"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: ornl-daac

  • Values are modelled estimates for the 1 km cell containing the point, interpolated from ground stations. They are not a station observation and the service reports no cell centre, so a value here is the model's account of that kilometre rather than a measurement at the coordinates given.
Oak Ridge · modelled daily maximum temperature32.2828.622023-06-012023-06-05
Oak Ridge · modelled daily maximum temperature
Publisher time/date°C
2023-06-0128.62
2023-06-0231.43
2023-06-0332.28
2023-06-0431.05
2023-06-0529.2
Record sources
  • tile:11208@35.9313,-84.3104
    ORNL DAAC (Daymet, MODIS/VIIRS subsets) · record tile:11208@35.9313,-84.3104
    No publisher locator supplied
    Record date: 2023-06-01
Full response and evidence
{
  "data": {
    "latitude": 35.9313,
    "longitude": -84.3104,
    "elevation_meters": 261.0,
    "tile": "11208",
    "projected_coordinates": "1352953.24 -569846.6",
    "software_version": "All years; all variables; Daymet Software Version 4.0",
    "publisher_citation": "Thornton; M.M.; R. Shrestha; Y. Wei; P.E. Thornton; S-C. Kao; and B.E. Wilson. 2022. Daymet: Daily Surface Weather Data on a 1-km Grid for North America; Version 4 R1. ORNL DAAC; Oak Ridge; Tennessee; USA. https://doi.org/10.3334/ORNLDAAC/2129",
    "columns": [
      {
        "name": "prcp",
        "units": "mm/day",
        "description": "Daily total precipitation, millimetres per day"
      },
      {
        "name": "tmax",
        "units": "deg c",
        "description": "Daily maximum 2-metre air temperature, degrees Celsius"
      },
      {
        "name": "tmin",
        "units": "deg c",
        "description": "Daily minimum 2-metre air temperature, degrees Celsius"
      }
    ],
    "days": [
      {
        "date": "2023-06-01",
        "yday": 152,
        "values": {
          "prcp": 0.0,
          "tmax": 28.62,
          "tmin": 16.9
        }
      },
      {
        "date": "2023-06-02",
        "yday": 153,
        "values": {
          "prcp": 0.0,
          "tmax": 31.43,
          "tmin": 16.08
        }
      },
      {
        "date": "2023-06-03",
        "yday": 154,
        "values": {
          "prcp": 0.0,
          "tmax": 32.28,
          "tmin": 14.76
        }
      },
      {
        "date": "2023-06-04",
        "yday": 155,
        "values": {
          "prcp": 0.0,
          "tmax": 31.05,
          "tmin": 16.8
        }
      },
      {
        "date": "2023-06-05",
        "yday": 156,
        "values": {
          "prcp": 2.12,
          "tmax": 29.2,
          "tmin": 16.24
        }
      }
    ],
    "record_count": 5,
    "requested_range": {
      "from": "2023-06-01",
      "to": "2023-06-05"
    },
    "returned_range": {
      "from": "2023-06-01",
      "to": "2023-06-05"
    },
    "calendar": "Daymet's year is always 365 days. 29 February is present and 31 December is dropped in leap years, so an annual total from a leap year is a 365-day total and the missing date is named on any answer whose range covers it.",
    "note": "Daily modelled surface weather for the 1 km cell holding this point. Precipitation is a daily total; tmax and tmin are daily extremes, so a daily mean has to be computed and is not published. For observations at a station rather than a modelled grid cell, this is the wrong source."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "ornl-daac",
      "steward": "Oak Ridge National Laboratory",
      "funder": "National Aeronautics and Space Administration",
      "system": "ORNL DAAC (Daymet, MODIS/VIIRS subsets)",
      "dataset": "Daymet single-pixel extraction",
      "dataset_version": "Daymet V4 R1",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "tile:11208@35.9313,-84.3104",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2023-06-01",
      "transformations": [
        "day-of-year converted to calendar date"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "ornl-daac"
    ],
    "time_range": {
      "from": "2023-06-01",
      "to": "2023-06-05"
    }
  },
  "warnings": [
    {
      "code": "derived_layer",
      "message": "Values are modelled estimates for the 1 km cell containing the point, interpolated from ground stations. They are not a station observation and the service reports no cell centre, so a value here is the model's account of that kilometre rather than a measurement at the coordinates given.",
      "source_id": "ornl-daac"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "earth.get_daymet_point",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
ess-dive.jsonUnknown; old recording28399526c4bbec1055c0740219c1bee5468f0ebf5b5662182f77fb88f28d827a
ornl-daac.jsonUnknown; old recording9fea63aa5e38eaa7fdf8d095bec8d6a70b291f4cc6a9751facf53548d565574a

Find Canadian climate simulations

Skill: environmental-study-brief

The first returned CanESM5 dataset lists variant r12i1p2f1 and file version 20190429.

Read 5 of 366 matches. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • ORNL indexes model output from multiple institutions. The rows describe files; they contain no temperature readings.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo global-climate-archive --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Search cmip

Coverage and source notes

climate.search_cmip {"experiment": "historical", "model": "CanESM5", "rows": 5, "variable": "tas"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: esgf-search

ReturnedTotal matches
5366
CMIP6 metadata from the ORNL index
ModelExperimentVariantVersionFile unitsData node
CanESM5historicalr12i1p2f120190429Kesgf-node.ornl.gov
CanESM5historicalr12i1p2f120190429Kcrd-esgf-drc.ec.gc.ca
CanESM5historicalr13i1p2f120190429Keagle.alcf.anl.gov
CanESM5historicalr14i1p1f120190429Keagle.alcf.anl.gov
CanESM5historicalr19i1p1f120190429Kesgf-node.ornl.gov

Publisher access recipes

Record sources
  • CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.Amon.tas.gn.v20190429
    ESGF search (CMIP6) · record CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.Amon.tas.gn.v20190429
    Publisher record
    Record date: 1850-01-16T12:00:00Z
  • CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.day.tas.gn.v20190429
    ESGF search (CMIP6) · record CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.day.tas.gn.v20190429
    Publisher record
    Record date: 1850-01-01T12:00:00Z
  • CMIP6.CMIP.CCCma.CanESM5.historical.r13i1p2f1.day.tas.gn.v20190429
    ESGF search (CMIP6) · record CMIP6.CMIP.CCCma.CanESM5.historical.r13i1p2f1.day.tas.gn.v20190429
    Publisher record
    Record date: 1850-01-01T12:00:00Z
  • CMIP6.CMIP.CCCma.CanESM5.historical.r14i1p1f1.Amon.tas.gn.v20190429
    ESGF search (CMIP6) · record CMIP6.CMIP.CCCma.CanESM5.historical.r14i1p1f1.Amon.tas.gn.v20190429
    Publisher record
    Record date: 1850-01-16T12:00:00Z
  • CMIP6.CMIP.CCCma.CanESM5.historical.r19i1p1f1.day.tas.gn.v20190429
    ESGF search (CMIP6) · record CMIP6.CMIP.CCCma.CanESM5.historical.r19i1p1f1.day.tas.gn.v20190429
    Publisher record
    Record date: 1850-01-01T12:00:00Z
Full response and evidence
{
  "data": {
    "datasets": [
      {
        "dataset_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.Amon.tas.gn.v20190429",
        "project": "CMIP6",
        "model": "CanESM5",
        "institution": "CCCma",
        "experiment": "historical",
        "experiment_title": "all-forcing simulation of the recent past",
        "variables": [
          "tas"
        ],
        "variable_long_names": [
          "Near-Surface Air Temperature"
        ],
        "variable_units": [
          "K"
        ],
        "frequency": "mon",
        "realm": "atmos",
        "nominal_resolution": "500 km",
        "grid_label": "gn",
        "variant_label": "r12i1p2f1",
        "version": "20190429",
        "covers": {
          "from": "1850-01-16T12:00:00Z",
          "to": "2014-12-16T12:00:00Z"
        },
        "files": 1,
        "size_bytes": 52456974,
        "data_node": "esgf-node.ornl.gov",
        "access_methods": [
          "HTTPServer",
          "GridFTP",
          "OPENDAP",
          "Globus",
          "LAS"
        ],
        "latest": true,
        "retracted": false,
        "replica": true
      },
      {
        "dataset_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.day.tas.gn.v20190429",
        "project": "CMIP6",
        "model": "CanESM5",
        "institution": "CCCma",
        "experiment": "historical",
        "experiment_title": "all-forcing simulation of the recent past",
        "variables": [
          "tas"
        ],
        "variable_long_names": [
          "Near-Surface Air Temperature"
        ],
        "variable_units": [
          "K"
        ],
        "frequency": "day",
        "realm": "atmos",
        "nominal_resolution": "500 km",
        "grid_label": "gn",
        "variant_label": "r12i1p2f1",
        "version": "20190429",
        "covers": {
          "from": "1850-01-01T12:00:00Z",
          "to": "2014-12-31T12:00:00Z"
        },
        "files": 1,
        "size_bytes": 1600967425,
        "data_node": "crd-esgf-drc.ec.gc.ca",
        "access_methods": [
          "HTTPServer",
          "GridFTP",
          "OPENDAP",
          "LAS"
        ],
        "latest": true,
        "retracted": false,
        "replica": false
      },
      {
        "dataset_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r13i1p2f1.day.tas.gn.v20190429",
        "project": "CMIP6",
        "model": "CanESM5",
        "institution": "CCCma",
        "experiment": "historical",
        "experiment_title": "all-forcing simulation of the recent past",
        "variables": [
          "tas"
        ],
        "variable_long_names": [
          "Near-Surface Air Temperature"
        ],
        "variable_units": [
          "K"
        ],
        "frequency": "day",
        "realm": "atmos",
        "nominal_resolution": "500 km",
        "grid_label": "gn",
        "variant_label": "r13i1p2f1",
        "version": "20190429",
        "covers": {
          "from": "1850-01-01T12:00:00Z",
          "to": "2014-11-21T12:00:00Z"
        },
        "files": 1,
        "size_bytes": 1601062361,
        "data_node": "eagle.alcf.anl.gov",
        "access_methods": [
          "HTTPServer",
          "Globus"
        ],
        "latest": true,
        "retracted": false,
        "replica": true
      },
      {
        "dataset_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r14i1p1f1.Amon.tas.gn.v20190429",
        "project": "CMIP6",
        "model": "CanESM5",
        "institution": "CCCma",
        "experiment": "historical",
        "experiment_title": "all-forcing simulation of the recent past",
        "variables": [
          "tas"
        ],
        "variable_long_names": [
          "Near-Surface Air Temperature"
        ],
        "variable_units": [
          "K"
        ],
        "frequency": "mon",
        "realm": "atmos",
        "nominal_resolution": "500 km",
        "grid_label": "gn",
        "variant_label": "r14i1p1f1",
        "version": "20190429",
        "covers": {
          "from": "1850-01-16T12:00:00Z",
          "to": "2014-11-06T12:00:00Z"
        },
        "files": 1,
        "size_bytes": 52453272,
        "data_node": "eagle.alcf.anl.gov",
        "access_methods": [
          "HTTPServer",
          "Globus"
        ],
        "latest": true,
        "retracted": false,
        "replica": true
      },
      {
        "dataset_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r19i1p1f1.day.tas.gn.v20190429",
        "project": "CMIP6",
        "model": "CanESM5",
        "institution": "CCCma",
        "experiment": "historical",
        "experiment_title": "all-forcing simulation of the recent past",
        "variables": [
          "tas"
        ],
        "variable_long_names": [
          "Near-Surface Air Temperature"
        ],
        "variable_units": [
          "K"
        ],
        "frequency": "day",
        "realm": "atmos",
        "nominal_resolution": "500 km",
        "grid_label": "gn",
        "variant_label": "r19i1p1f1",
        "version": "20190429",
        "covers": {
          "from": "1850-01-01T12:00:00Z",
          "to": "2014-12-31T12:00:00Z"
        },
        "files": 1,
        "size_bytes": 1600914528,
        "data_node": "esgf-node.ornl.gov",
        "access_methods": [
          "HTTPServer",
          "GridFTP",
          "OPENDAP",
          "Globus",
          "LAS"
        ],
        "latest": true,
        "retracted": false,
        "replica": true
      }
    ],
    "record_count": 5,
    "total_matches": 366,
    "offset": 0,
    "applied_filters": [
      "type:Dataset",
      "experiment_id:\"historical\"",
      "project:\"CMIP6\"",
      "source_id:\"CanESM5\"",
      "variable_id:\"tas\"",
      "latest:True"
    ],
    "latest_only": true,
    "note": "Metadata for climate-model output, not the output itself: each record names the data node holding its files and the methods that node serves them by. Restricted to the latest version of each dataset unless include_superseded is set \u2014 the index holds retracted and superseded output and sorts it first otherwise. Walk climate.discover_facets for valid model, experiment, and variable names; a near-miss returns nothing rather than a suggestion."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "esgf-search",
      "steward": "Oak Ridge National Laboratory",
      "funder": "Office of Science",
      "system": "ESGF search (CMIP6)",
      "dataset": "ESGF search (CMIP6)",
      "dataset_version": "CMIP6",
      "authority_level": "official_secondary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.Amon.tas.gn.v20190429",
      "locator": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.Amon.tas.gn.v20190429.json",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "1850-01-16T12:00:00Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.day.tas.gn.v20190429",
      "locator": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.day.tas.gn.v20190429.json",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "1850-01-01T12:00:00Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r13i1p2f1.day.tas.gn.v20190429",
      "locator": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r13i1p2f1.day.tas.gn.v20190429.json",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "1850-01-01T12:00:00Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r14i1p1f1.Amon.tas.gn.v20190429",
      "locator": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r14i1p1f1.Amon.tas.gn.v20190429.json",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "1850-01-16T12:00:00Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "CMIP6.CMIP.CCCma.CanESM5.historical.r19i1p1f1.day.tas.gn.v20190429",
      "locator": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r19i1p1f1.day.tas.gn.v20190429.json",
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "1850-01-01T12:00:00Z",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "esgf-search"
    ],
    "known_limitations": [
      "A catalog of metadata, not the model output. The files live on federated data nodes and are reached by the access methods each record names; several nodes require a federation account.",
      "Retracted and superseded datasets are in the index and sort first without the publisher's `latest` flag. A retraction is a modelling centre withdrawing output, often for a science error, so the flag is on by default here and both flags ride on every row.",
      "Paging stops at offset 9,999 against 14.7 million records. This archive is searched by narrowing facets, not by walking pages.",
      "Vintage identity is the whole game: CMIP5, CMIP6 and CMIP7 are different archives, and a comparison across them without saying so is the mixed-vintage error the envelope exists to catch.",
      "The index names one fact two ways. A dataset's last covered timestamp is datetime_stop on some records and datetime_end on others, in the same index on the same day. Both are read; a client reading one would report the end of the covered period as unknown for a large share of the archive."
    ]
  },
  "warnings": [],
  "access_recipes": [
    {
      "kind": "landing_page",
      "uri": "https://furtherinfo.es-doc.org/CMIP6.CCCma.CanESM5.historical.none.r12i1p2f1",
      "label": "CanESM5 historical documentation",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.Amon.tas.gn.v20190429.json",
      "label": "Citation record for\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r12i1p2f1.day.tas.gn.v20190429.json",
      "label": "Citation record for\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://furtherinfo.es-doc.org/CMIP6.CCCma.CanESM5.historical.none.r13i1p2f1",
      "label": "CanESM5 historical documentation",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r13i1p2f1.day.tas.gn.v20190429.json",
      "label": "Citation record for\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://furtherinfo.es-doc.org/CMIP6.CCCma.CanESM5.historical.none.r14i1p1f1",
      "label": "CanESM5 historical documentation",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r14i1p1f1.Amon.tas.gn.v20190429.json",
      "label": "Citation record for\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "landing_page",
      "uri": "https://furtherinfo.es-doc.org/CMIP6.CCCma.CanESM5.historical.none.r19i1p1f1",
      "label": "CanESM5 historical documentation",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    },
    {
      "kind": "doi",
      "uri": "http://cera-www.dkrz.de/WDCC/meta/CMIP6/CMIP6.CMIP.CCCma.CanESM5.historical.r19i1p1f1.day.tas.gn.v20190429.json",
      "label": "Citation record for\u2026",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "climate.search_cmip",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
esgf-search.jsonUnknown; old recordingb48a40f84f831197b5621eeb120b6e8dac79c724b53ac5c3d6cebdfc6b2b8ce4

Materials evidence sheet

Skill: materials-structure-and-code

5 computed structures returned, with one full structure lookup and a separate H/C/O basis-set example.

Read 5 of 264 matches. A recorded replay at registry revision 2026-11-09, not current data.

Limits of this example
  • Computed structures are not experimental validation.
  • The H/C/O basis set is a separate chemistry example, not a recommendation for gallium nitride.

Download JSON evidenceDownload CSV evidence index

Run this example locally

After installing DOE-MCP, replay without a key, model or network request:

doe-mcp demo materials --output ./demo-output

Add --live to query publishers. No model is called. Live results and availability can differ.

1. Search structures

Coverage and source notes

materials.search_structures {"elements": "Ga,N", "rows": 5}

Coverage dimensionValue
registrycovered
executioncomplete
paginationtruncated
source_claimpartial
resulthit

Searched: lbnl-mp-optimade

  • These are computed structures, not measured ones: each is a calculation's output under a stated functional. Reporting one as an experimentally determined crystal structure is a category error.
ReturnedTotal matches
5264
  • mp-1244984
    Materials Project OPTIMADE endpoint · record mp-1244984
    No publisher locator supplied
    Record date: 2019-07-02T00:29:18.792000
  • mp-1223660
    Materials Project OPTIMADE endpoint · record mp-1223660
    No publisher locator supplied
    Record date: 2022-06-10T06:23:20.905000
  • mp-1199250
    Materials Project OPTIMADE endpoint · record mp-1199250
    No publisher locator supplied
    Record date: 2021-03-09T23:05:01.374000
  • mp-1245997
    Materials Project OPTIMADE endpoint · record mp-1245997
    No publisher locator supplied
    Record date: 2021-02-04T20:40:18.753000
  • mp-1198425
    Materials Project OPTIMADE endpoint · record mp-1198425
    No publisher locator supplied
    Record date: 2021-03-10T07:53:43.904000
Full response and evidence
{
  "data": {
    "structures": [
      {
        "id": "mp-1244984",
        "formula": "GaN",
        "formula_descriptive": "GaN",
        "formula_hill": "Ga50N50",
        "elements": [
          "Ga",
          "N"
        ],
        "element_ratios": [
          0.5,
          0.5
        ],
        "element_count": 2,
        "sites": 100,
        "space_group_number": null,
        "space_group_symbol": null,
        "periodic_dimensions": 3,
        "last_modified": "2019-07-02T00:29:18.792000",
        "provider_fields": {
          "_mp_chemical_system": "Ga-N",
          "_mp_stability": {
            "gga_gga+u_r2scan": {
              "thermo_id": "mp-1244984_GGA_GGA+U_R2SCAN",
              "energy_above_hull": 0.7416738018000011,
              "formation_energy_per_atom": 0.07162439492499971,
              "last_updated_thermo": "2023-04-27T01:24:08.875000"
            },
            "gga_gga+u": {
              "thermo_id": "mp-1244984_GGA_GGA+U",
              "energy_above_hull": 0.7416738018000002,
              "formation_energy_per_atom": 0.0848569330500004,
              "last_updated_thermo": "2023-04-27T01:24:20.078000"
            }
          }
        }
      },
      {
        "id": "mp-1223660",
        "formula": "GaInN2",
        "formula_descriptive": "GaInN2",
        "formula_hill": "GaInN2",
        "elements": [
          "Ga",
          "In",
          "N"
        ],
        "element_ratios": [
          0.25,
          0.25,
          0.5
        ],
        "element_count": 3,
        "sites": 4,
        "space_group_number": null,
        "space_group_symbol": null,
        "periodic_dimensions": 3,
        "last_modified": "2022-06-10T06:23:20.905000",
        "provider_fields": {
          "_mp_chemical_system": "Ga-In-N",
          "_mp_stability": {
            "gga_gga+u_r2scan": {
              "thermo_id": "mp-1223660_GGA_GGA+U_R2SCAN",
              "energy_above_hull": 0.07719281500000008,
              "formation_energy_per_atom": -0.3166822218750003,
              "last_updated_thermo": "2023-04-27T01:30:31.450000"
            },
            "gga_gga+u": {
              "thermo_id": "mp-1223660_GGA_GGA+U",
              "energy_above_hull": 0.07719281500000008,
              "formation_energy_per_atom": -0.2906402068750005,
              "last_updated_thermo": "2023-04-27T01:30:39.045000"
            }
          }
        }
      },
      {
        "id": "mp-1199250",
        "formula": "F6GaN3",
        "formula_descriptive": "F24Ga4N12",
        "formula_hill": "F24Ga4N12",
        "elements": [
          "F",
          "Ga",
          "N"
        ],
        "element_ratios": [
          0.1,
          0.3,
          0.6
        ],
        "element_count": 3,
        "sites": 40,
        "space_group_number": null,
        "space_group_symbol": null,
        "periodic_dimensions": 3,
        "last_modified": "2021-03-09T23:05:01.374000",
        "provider_fields": {
          "_mp_chemical_system": "F-Ga-N",
          "_mp_stability": {
            "gga_gga+u_r2scan": {
              "thermo_id": "mp-1199250_GGA_GGA+U_R2SCAN",
              "energy_above_hull": 1.3350707470000014,
              "formation_energy_per_atom": 0.19073120524999893,
              "last_updated_thermo": "2023-04-27T01:29:59.276000"
            },
            "gga_gga+u": {
              "thermo_id": "mp-1199250_GGA_GGA+U",
              "energy_above_hull": 1.3350707470000014,
              "formation_energy_per_atom": 0.16329291549999994,
              "last_updated_thermo": "2023-04-27T01:30:03.644000"
            }
          }
        }
      },
      {
        "id": "mp-1245997",
        "formula": "Cd3Ga3N5",
        "formula_descriptive": "Cd6Ga6N10",
        "formula_hill": "Cd6Ga6N10",
        "elements": [
          "Cd",
          "Ga",
          "N"
        ],
        "element_ratios": [
          0.2727272727272727,
          0.2727272727272727,
          0.45454545454545453
        ],
        "element_count": 3,
        "sites": 22,
        "space_group_number": null,
        "space_group_symbol": null,
        "periodic_dimensions": 3,
        "last_modified": "2021-02-04T20:40:18.753000",
        "provider_fields": {
          "_mp_chemical_system": "Cd-Ga-N",
          "_mp_stability": {
            "gga_gga+u_r2scan": {
              "thermo_id": "mp-1245997_GGA_GGA+U_R2SCAN",
              "energy_above_hull": 0.36648617227272595,
              "formation_energy_per_atom": 0.0010046776136350259,
              "last_updated_thermo": "2023-04-27T01:14:17.472000"
            },
            "gga_gga+u": {
              "thermo_id": "mp-1245997_GGA_GGA+U",
              "energy_above_hull": 0.36648617227272773,
              "formation_energy_per_atom": 0.008222425681818312,
              "last_updated_thermo": "2023-04-27T01:14:22.121000"
            }
          }
        }
      },
      {
        "id": "mp-1198425",
        "formula": "BGaH5NO9P2",
        "formula_descriptive": "B4Ga4H20N4O36P8",
        "formula_hill": "B4Ga4H20N4O36P8",
        "elements": [
          "B",
          "Ga",
          "H",
          "N",
          "O",
          "P"
        ],
        "element_ratios": [
          0.05263157894736842,
          0.05263157894736842,
          0.10526315789473684,
          0.2631578947368421,
          0.05263157894736842,
          0.47368421052631576
        ],
        "element_count": 6,
        "sites": 76,
        "space_group_number": null,
        "space_group_symbol": null,
        "periodic_dimensions": 3,
        "last_modified": "2021-03-10T07:53:43.904000",
        "provider_fields": {
          "_mp_chemical_system": "B-Ga-H-N-O-P",
          "_mp_stability": {
            "gga_gga+u_r2scan": {
              "thermo_id": "mp-1198425_GGA_GGA+U_R2SCAN",
              "energy_above_hull": 0.005111285844309421,
              "formation_energy_per_atom": -2.0148944074843356,
              "last_updated_thermo": "2023-04-27T04:27:33.583000"
            },
            "gga_gga+u": {
              "thermo_id": "mp-1198425_GGA_GGA+U",
              "energy_above_hull": 0.002660023563606728,
              "formation_energy_per_atom": -2.018499772083334,
              "last_updated_thermo": "2023-04-27T04:27:34.891000"
            }
          }
        }
      }
    ],
    "record_count": 5,
    "total_matches": 264,
    "entries_in_database": 154387,
    "offset": 0,
    "filter_sent": "elements HAS ALL \"Ga\",\"N\"",
    "provider": "Materials Project - OPTIMADE",
    "coverage_note": "This keyless route serves structures and formulas. The Materials Project's electronic structure, phase diagrams, elastic tensors and the rest are behind its own keyed API and the mp-api library, which is a separate source in this registry. A caller reading \"Materials Project\" will assume the whole database; this route is one part of it.\n",
    "federation_note": "This is one provider in the OPTIMADE federation, and the DOE member of it. A material absent here may exist at another provider; that is a different answer from its not existing.",
    "note": "Crystal structures matching the filter. `filter` takes the OPTIMADE grammar directly through filter_expression, and the named arguments build one for the common cases; call materials.describe_structure_fields for the properties this provider allows and for its own extension fields."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "lbnl-mp-optimade",
      "steward": "Lawrence Berkeley National Laboratory",
      "funder": "Office of Science",
      "system": "Materials Project OPTIMADE endpoint",
      "dataset": "Materials Project OPTIMADE endpoint",
      "dataset_version": "1.2.0",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "mp-1244984",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2019-07-02T00:29:18.792000",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_02",
      "source_ref": "source_01",
      "record_id": "mp-1223660",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2022-06-10T06:23:20.905000",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_03",
      "source_ref": "source_01",
      "record_id": "mp-1199250",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2021-03-09T23:05:01.374000",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_04",
      "source_ref": "source_01",
      "record_id": "mp-1245997",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2021-02-04T20:40:18.753000",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    },
    {
      "id": "evidence_05",
      "source_ref": "source_01",
      "record_id": "mp-1198425",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2021-03-10T07:53:43.904000",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "truncated",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "lbnl-mp-optimade"
    ],
    "known_limitations": [
      "Computed, not measured. A Materials Project structure is a calculation's output under a stated functional, and treating it as an experimental crystal structure is a category error.",
      "This route is narrower than the publisher's own API. Structures and formulas are here; energetics beyond the stability block, electronic structure, and phase diagrams are behind the keyed route.",
      "OPTIMADE is a federation standard with 29 providers, of which this is the DOE member. A structure absent here may well exist at another provider, and that is a different answer from its not existing.",
      "The provider extension fields are not portable. `_mp_stability` means what the Materials Project says it means and has no counterpart at another provider."
    ]
  },
  "warnings": [
    {
      "code": "derived_layer",
      "message": "These are computed structures, not measured ones: each is a calculation's output under a stated functional. Reporting one as an experimentally determined crystal structure is a category error.",
      "source_id": "lbnl-mp-optimade"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "materials.search_structures",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

2. Get structure

Coverage and source notes

materials.get_structure {"structure_id": "mp-1244984"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimpartial
resulthit

Searched: lbnl-mp-optimade

  • A computed structure under a stated functional, not a measured one.
  • mp-1244984
    Materials Project OPTIMADE endpoint · record mp-1244984
    No publisher locator supplied
    Record date: 2019-07-02T00:29:18.792000
Full response and evidence
{
  "data": {
    "id": "mp-1244984",
    "formula": "GaN",
    "formula_descriptive": "GaN",
    "formula_hill": "Ga50N50",
    "elements": [
      "Ga",
      "N"
    ],
    "element_ratios": [
      0.5,
      0.5
    ],
    "element_count": 2,
    "sites": 100,
    "space_group_number": null,
    "space_group_symbol": null,
    "periodic_dimensions": 3,
    "last_modified": "2019-07-02T00:29:18.792000",
    "provider_fields": {
      "_mp_chemical_system": "Ga-N",
      "_mp_stability": {
        "gga_gga+u_r2scan": {
          "thermo_id": "mp-1244984_GGA_GGA+U_R2SCAN",
          "energy_above_hull": 0.7416738018000011,
          "formation_energy_per_atom": 0.07162439492499971,
          "last_updated_thermo": "2023-04-27T01:24:08.875000"
        },
        "gga_gga+u": {
          "thermo_id": "mp-1244984_GGA_GGA+U",
          "energy_above_hull": 0.7416738018000002,
          "formation_energy_per_atom": 0.0848569330500004,
          "last_updated_thermo": "2023-04-27T01:24:20.078000"
        }
      }
    },
    "lattice_vectors": [
      [
        13.01620829,
        0.74325844,
        0.67698607
      ],
      [
        0.78279776,
        13.27587227,
        1.26189026
      ],
      [
        0.66583054,
        1.25062875,
        13.2247994
      ]
    ],
    "structure_features": [],
    "immutable_id": "645d2b75bcd30f748b474a14",
    "coverage_note": "This keyless route serves structures and formulas. The Materials Project's electronic structure, phase diagrams, elastic tensors and the rest are behind its own keyed API and the mp-api library, which is a separate source in this registry. A caller reading \"Materials Project\" will assume the whole database; this route is one part of it.\n",
    "note": "One structure in full. Fields under provider_fields are this database's own additions to the OPTIMADE standard and have no counterpart at another provider."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "lbnl-mp-optimade",
      "steward": "Lawrence Berkeley National Laboratory",
      "funder": "Office of Science",
      "system": "Materials Project OPTIMADE endpoint",
      "dataset": "Materials Project OPTIMADE endpoint",
      "dataset_version": "OPTIMADE 1.2.0",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "mp-1244984",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": "2019-07-02T00:29:18.792000",
      "transformations": [],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "partial",
    "result": "hit",
    "sources_searched": [
      "lbnl-mp-optimade"
    ]
  },
  "warnings": [
    {
      "code": "derived_layer",
      "message": "A computed structure under a stated functional, not a measured one.",
      "source_id": "lbnl-mp-optimade"
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "materials.get_structure",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}

3. Get basis set

Coverage and source notes

chemistry.get_basis_set {"elements": "H,C,O", "name": "6-31g", "output_format": "nwchem"}

Coverage dimensionValue
registrycovered
executioncomplete
paginationcomplete
source_claimcomplete
resulthit

Searched: basis-set-exchange

  • This publisher requires citation as a condition of use. Cite: Pritchard, B.P., Altarawy, D., Didier, B., Gibson, T.D., and Windus, T.L. 2019. New Basis Set Exchange: An Open, Up-to-Date Resource for the Molecular Sciences Community. Journal of Chemical Information and Modeling 59(11):4814-4820. https://doi.org/10.1021/acs.jcim.9b00725 — and, in addition, the references the service returns for the particular set used.

Publisher access recipes

  • 6-31g
    Basis Set Exchange · record 6-31g
    No publisher locator supplied
    Record date: Unknown
Full response and evidence
{
  "data": {
    "key": "6-31g",
    "name": "6-31G",
    "family": "pople",
    "role": "orbital",
    "description": "6-31G valence double-zeta",
    "version": "1",
    "output_format": "nwchem",
    "format_name": "NWChem",
    "elements_requested": [
      "H",
      "C",
      "O"
    ],
    "elements_available": [
      "H",
      "He",
      "Li",
      "Be",
      "B",
      "C",
      "N",
      "O",
      "F",
      "Ne",
      "Na",
      "Mg",
      "Al",
      "Si",
      "P",
      "S",
      "Cl",
      "Ar",
      "K",
      "Ca",
      "Sc",
      "Ti",
      "V",
      "Cr",
      "Mn",
      "Fe",
      "Co",
      "Ni",
      "Cu",
      "Zn",
      "Ga",
      "Ge",
      "As",
      "Se",
      "Br",
      "Kr"
    ],
    "data": "#----------------------------------------------------------------------\n# Basis Set Exchange\n# Version 0.12\n# https://www.basissetexchange.org\n#----------------------------------------------------------------------\n#   Basis set: 6-31G\n# Description: 6-31G valence double-zeta\n#        Role: orbital\n#     Version: 1  (Data from Gaussian 09/GAMESS)\n#----------------------------------------------------------------------\n\n\nBASIS \"ao basis\" SPHERICAL PRINT\n#BASIS SET: (4s) -> [2s]\nH    S\n      0.1873113696E+02       0.3349460434E-01\n      0.2825394365E+01       0.2347269535E+00\n      0.6401216923E+00       0.8137573261E+00\nH    S\n      0.1612777588E+00       1.0000000\n#BASIS SET: (10s,4p) -> [3s,2p]\nC    S\n      0.3047524880E+04       0.1834737132E-02\n      0.4573695180E+03       0.1403732281E-01\n      0.1039486850E+03       0.6884262226E-01\n      0.2921015530E+02       0.2321844432E+00\n      0.9286662960E+01       0.4679413484E+00\n      0.3163926960E+01       0.3623119853E+00\nC    SP\n      0.7868272350E+01      -0.1193324198E+00       0.6899906659E-01\n      0.1881288540E+01      -0.1608541517E+00       0.3164239610E+00\n      0.5442492580E+00       0.1143456438E+01       0.7443082909E+00\nC    SP\n      0.1687144782E+00       0.1000000000E+01       0.1000000000E+01\n#BASIS SET: (10s,4p) -> [3s,2p]\nO    S\n      0.5484671660E+04       0.1831074430E-02\n      0.8252349460E+03       0.1395017220E-01\n      0.1880469580E+03       0.6844507810E-01\n      0.5296450000E+02       0.2327143360E+00\n      0.1689757040E+02       0.4701928980E+00\n      0.5799635340E+01       0.3585208530E+00\nO    SP\n      0.1553961625E+02      -0.1107775495E+00       0.7087426823E-01\n      0.3599933586E+01      -0.1480262627E+00       0.3397528391E+00\n      0.1013761750E+01       0.1130767015E+01       0.7271585773E+00\nO    SP\n      0.2700058226E+00       0.1000000000E+01       0.1000000000E+01\nEND\n",
    "references": "%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%\n% If you downloaded data from the basis set\n% exchange or used the basis set exchange python library, please cite:\n%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%\n@article{pritchard2019a,\n    author = {Pritchard, Benjamin P. and Altarawy, Doaa and Didier, Brett and Gibsom, Tara D. and Windus, Theresa L.},\n    title = {A New Basis Set Exchange: An Open, Up-to-date Resource for the Molecular Sciences Community},\n    journal = {J. Chem. Inf. Model.},\n    volume = {59},\n    pages = {4814-4820},\n    year = {2019},\n    doi = {10.1021/acs.jcim.9b00725}\n}\n\n@article{feller1996a,\n    author = {Feller, David},\n    title = {The role of databases in support of computational chemistry calculations},\n    journal = {J. Comput. Chem.},\n    volume = {17},\n    pages = {1571-1586},\n    year = {1996},\n    doi = {10.1002/(SICI)1096-987X(199610)17:13<1571::AID-JCC9>3.0.CO;2-P}\n}\n\n@article{schuchardt2007a,\n    author = {Schuchardt, Karen L. and Didier, Brett T. and Elsethagen, Todd and Sun, Lisong and Gurumoorthi, Vidhya and Chase, Jared and Li, Jun and Windus, Theresa L.},\n    title = {Basis Set Exchange: A Community Database for Computational Sciences},\n    journal = {J. Chem. Inf. Model.},\n    volume = {47},\n    pages = {1045-1052},\n    year = {2007},\n    doi = {10.1021/ci600510j}\n}\n\n%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%\n% References for the basis set\n%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%\n% H\n%     31G Split-valence basis set for H,He\n%         ditchfield1971a\n%\n% C,O\n%     6-31G Split-valence basis set\n%         hehre1972a\n%\n\n\n@article{ditchfield1971a,\n    author = {Ditchfield, R. and Hehre, W. J. and Pople, J. A.},\n    title = {Self-Consistent Molecular-Orbital Methods. IX. An Extended Gaussian-Type Basis for Molecular-Orbital Studies of Organic Molecules},\n    journal = {J. Chem. Phys.},\n    volume = {54},\n    pages = {724-728},\n    year = {1971},\n    doi = {10.1063/1.1674902}\n}\n\n@article{hehre1972a,\n    author = {Hehre, W. J. and Ditchfield, R. and Pople, J. A.},\n    title = {Self-Consistent Molecular Orbital Methods. XII. Further Extensions of Gaussian-Type Basis Sets for Use in Molecular Orbital Studies of Organic Molecules},\n    journal = {J. Chem. Phys.},\n    volume = {56},\n    pages = {2257-2261},\n    year = {1972},\n    doi = {10.1063/1.1677527}\n}\n\n",
    "note": "The basis set as this program's own input text, ready to paste into a calculation. `references` holds the citations for the set itself, which are separate from the citation for the service and are what the publisher asks be cited alongside it."
  },
  "provenance": [
    {
      "id": "source_01",
      "source_id": "basis-set-exchange",
      "steward": "Molecular Sciences Software Institute",
      "system": "Basis Set Exchange",
      "dataset": "6-31G (NWChem)",
      "dataset_version": "1",
      "authority_level": "primary",
      "access_path": "live",
      "source_updated_at": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "cache_age_seconds": 0,
      "citation": {
        "doi": null,
        "recommended": "Pritchard, B.P., Altarawy, D., Didier, B., Gibson, T.D., and Windus, T.L. 2019. New Basis Set Exchange: An Open, Up-to-Date Resource for the Molecular Sciences Community. Journal of Chemical Information and Modeling 59(11):4814-4820. https://doi.org/10.1021/acs.jcim.9b00725 \u2014 and, in addition, the references the service returns for the particular set used.",
        "required": true
      }
    }
  ],
  "evidence": [
    {
      "id": "evidence_01",
      "source_ref": "source_01",
      "record_id": "6-31g",
      "locator": null,
      "retrieved_at": "2026-11-09T00:00:00Z",
      "effective_at": null,
      "transformations": [
        "rendered into nwchem format"
      ],
      "payload_hash": null,
      "raw_recovery": "available"
    }
  ],
  "coverage": {
    "registry": "covered",
    "execution": "complete",
    "pagination": "complete",
    "source_claim": "complete",
    "result": "hit",
    "sources_searched": [
      "basis-set-exchange"
    ]
  },
  "warnings": [
    {
      "code": "citation_required",
      "message": "This publisher requires citation as a condition of use. Cite: Pritchard, B.P., Altarawy, D., Didier, B., Gibson, T.D., and Windus, T.L. 2019. New Basis Set Exchange: An Open, Up-to-Date Resource for the Molecular Sciences Community. Journal of Chemical Information and Modeling 59(11):4814-4820. https://doi.org/10.1021/acs.jcim.9b00725 \u2014 and, in addition, the references the service returns for the particular set used.",
      "source_id": "basis-set-exchange"
    }
  ],
  "access_recipes": [
    {
      "kind": "landing_page",
      "uri": "https://www.basissetexchange.org/basis/6-31g/",
      "label": "6-31G at the Basis Set Exchange",
      "instructions": null,
      "requires_account": false,
      "approximate_size": null
    }
  ],
  "_execution": {
    "server": "doe-mcp",
    "server_version": "0.1.0.dev0",
    "tool": "chemistry.get_basis_set",
    "tool_contract_version": "1",
    "envelope_version": "1",
    "adapters": {
      "osti_family": "1",
      "opendatasoft": "1",
      "json_document": "1",
      "curated": "1",
      "eia_v2": "1",
      "fueleconomy": "1",
      "text_feed": "1",
      "postgrest": "1",
      "federal_register": "1",
      "vips": "1",
      "daymet": "1",
      "essdive": "1",
      "esgf": "1",
      "sage": "1",
      "optimade": "1",
      "basis_sets": "1",
      "facility_status": "1",
      "gcam_csv": "1",
      "nmdc": "1",
      "none": "1",
      "self_registry": "1"
    },
    "registry_revision": "2026-11-09",
    "request_id": "recorded-workflow"
  }
}
Recording manifest and capture times

Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded. Registry revision: 2026-11-09.

FixtureCapture time (UTC)SHA-256
basis-set-exchange.jsonUnknown; old recording0dfd2e7d23d4802bc7325a7334ccd4e306ad519c222ca0436964c901e17e8043
lbnl-mp-optimade.jsonUnknown; old recording8a5d15ebe6a47c4103d3611661903b8f41de8b5d101ba203df541e2a7b35e280