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 dimension | Value |
|---|---|
| registry | covered |
| execution | complete |
| pagination | complete |
| source_claim | complete |
| result | hit |
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.
| Returned | Total matches |
|---|---|
| 1 | 1 |
| iso | country_name | region_GCAM3 | GCAM_region_ID |
|---|---|---|---|
| ken | Kenya | Africa | 2 |
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 dimension | Value |
|---|---|
| registry | covered |
| execution | complete |
| pagination | complete |
| source_claim | complete |
| result | hit |
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.
| Returned | Total matches |
|---|---|
| 1 | 1 |
| GCAM_region_ID | soilTimeScale |
|---|---|
| 2 | 25 |
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.
| Fixture | Capture time (UTC) | SHA-256 |
|---|---|---|
| gcam-economy.json | 2026-11-10T04:46:58.414403+00:00 | e51120caad276d93a52d9dbf50ea2faa5c298c9ac88f17c3e5f1869be685bb78 |
| gcam-land.json | 2026-11-10T04:46:57.498065+00:00 | d77c9781b292feb3265cabc2ffa484c7ef27dd7fe27f93f95a29115e2c693e65 |