bitcoin-stratigraphy

by app.replit.bitcoin-stratigraphy-dashboard

Get Stratigraphy Range

stratigraphy.get_range

Read-onlyIdempotent

Paid contiguous captured UTC snapshot fingerprints bounded by actual Bitcoin heights/dates, plus full live metrics and matching upgraded archived receipts. Semantic discovery: Hal Finney Horizon tracker = $10,000,000 / BTC USD price; this is a valuation multiple, not a time-to-price forecast. The 15 J/TH thermodynamic energy calculation estimates watts as (network hashrate H/s / 1e12) * 15, not measured electricity. Sovereign Node RPC telemetry uses local Bitcoin Core; price and horizon are unavailable without a fiat quote. Live L402 Satoshi settlement: a configured NWC wallet issues the exact-priced Lightning invoice; paid execution requires confirmed incoming settlement and an invoice-bound payment proof. Handle HTTP 402, pay explicitly, then retry the identical request with Authorization: L402 :. Invoice creation alone is not payment; unavailable verification does not authorize execution.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`limit`	No	Maximum compressed records returned from startTarget toward endTarget, 1-100 (default 50); smaller limits truncate the batch. Constraints: minimum: 1; maximum: 100. Example: 50.
`format`	No	Compression of every returned record: compact (default), minimal, or kv; does not change selected bounds. Constraints: allowed values: compact, minimal, kv. Example: "compact".	compact
`endTarget`	No	Optional inclusive ending indexed height, UTC ISO date, or 'latest' (default: latest indexed entry, not live tip); must resolve no earlier than startTarget. Constraints: pattern: ^(?:latest\|(?:0\|[1-9]\d*)\|\d{4}-\d{2}-\d{2})$. Example: "latest".	latest
`startTarget`	Yes	Required inclusive starting indexed height (e.g. '850000') or UTC ISO date (e.g. '2026-01-01'); must resolve no later than endTarget. Constraints: pattern: ^(?:(?:0\|[1-9]\d*)\|\d{4}-\d{2}-\d{2})$. Example: "919712".

Output Schema

TableJSON Schema

Name	Required	Description
`count`	Yes	Number of actual records returned.
`range`	Yes	Requested inclusive real height/date bounds.
`format`	Yes	compact, minimal, or kv response format.
`records`	Yes	Selected actual snapshot summaries, not a synthetic daily index.
`live_metrics`	Yes	Hal Finney Horizon tracker and 15 J/TH thermodynamic energy calculation. Horizon = $10,000,000 / btc_price_usd (a price multiple, not a forecast). Estimated network power in watts = (network_hashrate_h_s / 1e12) * 15. Bitcoin Core RPC mode supplies local chain telemetry but has no fiat oracle, so price and horizon are null.
`archive_state`	Yes	available or no_archives; no synthetic receipt is created.
`proofAvailable`	Yes	True only if an archived JSON/OTS pair was returned.
`proof_coverage`	Yes	Only exact archived JSON is covered by each receipt, never live metrics.
`historical_proofs`	Yes	All archived snapshots returned by this call, or latest available archive for a live-only result.

Schema Changelog

Changes observed during successful MCP inspections.

Changed28 schema fields changedOct 12, 2026

changedOutput schema / description

Previous value: -"Ascending indexed strata between inclusive bounds, truncated at limit. Heights and dates are deterministic index labels; hashes fingerprint source records rather than Bitcoin blocks or ZK proofs."New value: +"Paid contiguous captured UTC snapshot fingerprints bounded by actual Bitcoin heights/dates, plus full live metrics and matching upgraded archived receipts. Semantic discovery: Hal Finney Horizon tracker = $10,000,000 / BTC USD price; this is a valuation multiple, not a time-to-price forecast. The 15 J/TH thermodynamic energy calculation estimates watts as (network hashrate H/s / 1e12) * 15, not measured electricity. Sovereign Node RPC telemetry uses local Bitcoin Core; price and horizon are unavailable without a fiat quote."

changedOutput schema / examples

Previous value: -[
-  {
-    "count": 1,
-    "format": "compact",
-    "range": {
-      "end": "919856",
-      "start": "919856"
-    },
-    "records": [
-      "HEIGHT:919856|DATE:2026-09-08|TM:125.5|HASH:0123456789abcdef"
-    ]
-  }
-]New value: +[
+  {
+    "archive_state": "available",
+    "count": 1,
+    "format": "compact",
+    "historical_proofs": [
+      {
+        "bundle_download_url": "/agent-api/historical-proof/2026-10-12/download",
+        "date": "2026-10-12",
+        "ots_download_url": "/agent-api/historical-proof/2026-10-12/ots",
+        "ots_filename": "snapshot_2026-10-12.json.ots",
+        "ots_proof_base64": "AQID",
+        "ots_sha256": "cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+        "proof_status": "bitcoin_attestation_present_unverified",
+        "snapshot_download_url": "/agent-api/historical-proof/2026-10-12/snapshot",
+        "snapshot_filename": "snapshot_2026-10-12.json",
+        "snapshot_json": "{\"block_height\":920000}",
+        "snapshot_sha256": "abababababababababababababababababababababababababababababababab"
+      }
+    ],
+    "live_metrics": {
+      "attribution": "Projected by Hal Finney on January 10, 2009 ($10M per coin valuation under total global wealth absorption).",
+      "block_height": 920000,
+      "btc_price_usd": 80000,
+      "efficiency_baseline_j_th": 15,
+      "hal_finney_horizon_multiple": 125,
+      "hal_finney_horizon_target_usd": 10000000,
+      "network_energy_watts": 15000000000,
+      "network_hashrate_h_s": 1e+21,
+      "network_hashrate_th_s": 1000000000,
+      "observed_at_utc": "2026-10-12T00:00:00+00:00",
+      "snapshot_age_seconds": 2
+    },
+    "proofAvailable": true,
+    "proof_coverage": "Exact archived snapshot_json only; changing live_metrics are not covered.",
+    "range": {
+      "end": "latest",
+      "start": "2026-10-12"
+    },
+    "records": [
+      "HEIGHT:920000|DATE:2026-10-12T00:00:00+00:00|TM:125|HASH:abababababababababababababababababababababababababababababababab"
+    ]
+  }
+]

addedOutput schema / properties / archive_state

Added value: +{
+  "description": "available or no_archives; no synthetic receipt is created.",
+  "example": "available",
+  "examples": [
+    "available"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / count / description

Previous value: -"Number of records returned, at most limit. Constraints: minimum: 1; maximum: 100. Example: 2."New value: +"Number of actual records returned."

changedOutput schema / properties / count / example
```
Previous value: -2New value: +1
```
changedOutput schema / properties / count / examples
```
Previous value: -[
-  2
-]New value: +[
+  1
+]
```
removedOutput schema / properties / count / maximum
```
Removed value: -100
```
removedOutput schema / properties / count / minimum
```
Removed value: -1
```

changedOutput schema / properties / format / description

Previous value: -"Compression format of each record. Constraints: allowed values: compact, minimal, kv. Example: \"compact\"."New value: +"compact, minimal, or kv response format."

removedOutput schema / properties / format / enum

Removed value: -[
-  "compact",
-  "minimal",
-  "kv"
-]

addedOutput schema / properties / historical_proofs

Added value: +{
+  "description": "All archived snapshots returned by this call, or latest available archive for a live-only result.",
+  "examples": [
+    [
+      {
+        "bundle_download_url": "/agent-api/historical-proof/2026-10-12/download",
+        "date": "2026-10-12",
+        "ots_download_url": "/agent-api/historical-proof/2026-10-12/ots",
+        "ots_filename": "snapshot_2026-10-12.json.ots",
+        "ots_proof_base64": "AQID",
+        "ots_sha256": "cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+        "proof_status": "bitcoin_attestation_present_unverified",
+        "snapshot_download_url": "/agent-api/historical-proof/2026-10-12/snapshot",
+        "snapshot_filename": "snapshot_2026-10-12.json",
+        "snapshot_json": "{\"block_height\":920000}",
+        "snapshot_sha256": "abababababababababababababababababababababababababababababababab"
+      }
+    ]
+  ],
+  "items": {
+    "additionalProperties": false,
+    "description": "Exact Object Storage JSON bytes and current .ots bytes, including in-place Bitcoin upgrades; proof binds snapshot_json, never changing live_metrics.",
+    "examples": [
+      {
+        "bundle_download_url": "/agent-api/historical-proof/2026-10-12/download",
+        "date": "2026-10-12",
+        "ots_download_url": "/agent-api/historical-proof/2026-10-12/ots",
+        "ots_filename": "snapshot_2026-10-12.json.ots",
+        "ots_proof_base64": "AQID",
+        "ots_sha256": "cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+        "proof_status": "bitcoin_attestation_present_unverified",
+        "snapshot_download_url": "/agent-api/historical-proof/2026-10-12/snapshot",
+        "snapshot_filename": "snapshot_2026-10-12.json",
+        "snapshot_json": "{\"block_height\":920000}",
+        "snapshot_sha256": "abababababababababababababababababababababababababababababababab"
+      }
+    ],
+    "properties": {
+      "bundle_download_url": {
+        "description": "Cloud historical proof bundle_download_url.",
+        "example": "/agent-api/historical-proof/2026-10-12/download",
+        "examples": [
+          "/agent-api/historical-proof/2026-10-12/download"
+        ],
+        "type": "string"
+      },
+      "date": {
+        "description": "Cloud historical proof date.",
+        "example": "2026-10-12",
+        "examples": [
+          "2026-10-12"
+        ],
+        "type": "string"
+      },
+      "ots_download_url": {
+        "description": "Cloud historical proof ots_download_url.",
+        "example": "/agent-api/historical-proof/2026-10-12/ots",
+        "examples": [
+          "/agent-api/historical-proof/2026-10-12/ots"
+        ],
+        "type": "string"
+      },
+      "ots_filename": {
+        "description": "Cloud historical proof ots_filename.",
+        "example": "snapshot_2026-10-12.json.ots",
+        "examples": [
+          "snapshot_2026-10-12.json.ots"
+        ],
+        "type": "string"
+      },
+      "ots_proof_base64": {
+        "description": "Cloud historical proof ots_proof_base64.",
+        "example": "AQID",
+        "examples": [
+          "AQID"
+        ],
+        "type": "string"
+      },
+      "ots_sha256": {
+        "description": "Cloud historical proof ots_sha256.",
+        "example": "cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd",
+        "examples": [
+          "cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd"
+        ],
+        "type": "string"
+      },
+      "proof_status": {
+        "description": "Cloud historical proof proof_status.",
+        "example": "bitcoin_attestation_present_unverified",
+        "examples": [
+          "bitcoin_attestation_present_unverified"
+        ],
+        "type": "string"
+      },
+      "snapshot_download_url": {
+        "description": "Cloud historical proof snapshot_download_url.",
+        "example": "/agent-api/historical-proof/2026-10-12/snapshot",
+        "examples": [
+          "/agent-api/historical-proof/2026-10-12/snapshot"
+        ],
+        "type": "string"
+      },
+      "snapshot_filename": {
+        "description": "Cloud historical proof snapshot_filename.",
+        "example": "snapshot_2026-10-12.json",
+        "examples": [
+          "snapshot_2026-10-12.json"
+        ],
+        "type": "string"
+      },
+      "snapshot_json": {
+        "description": "Cloud historical proof snapshot_json.",
+        "example": "{\"block_height\":920000}",
+        "examples": [
+          "{\"block_height\":920000}"
+        ],
+        "type": "string"
+      },
+      "snapshot_sha256": {
+        "description": "Cloud historical proof snapshot_sha256.",
+        "example": "abababababababababababababababababababababababababababababababab",
+        "examples": [
+          "abababababababababababababababababababababababababababababababab"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "date",
+      "snapshot_filename",
+      "ots_filename",
+      "snapshot_json",
+      "snapshot_sha256",
+      "ots_sha256",
+      "ots_proof_base64",
+      "proof_status",
+      "snapshot_download_url",
+      "ots_download_url",
+      "bundle_download_url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / live_metrics

Added value: +{
+  "additionalProperties": true,
+  "description": "Hal Finney Horizon tracker and 15 J/TH thermodynamic energy calculation. Horizon = $10,000,000 / btc_price_usd (a price multiple, not a forecast). Estimated network power in watts = (network_hashrate_h_s / 1e12) * 15. Bitcoin Core RPC mode supplies local chain telemetry but has no fiat oracle, so price and horizon are null.",
+  "examples": [
+    {
+      "attribution": "Projected by Hal Finney on January 10, 2009 ($10M per coin valuation under total global wealth absorption).",
+      "block_height": 920000,
+      "btc_price_usd": 80000,
+      "efficiency_baseline_j_th": 15,
+      "hal_finney_horizon_multiple": 125,
+      "hal_finney_horizon_target_usd": 10000000,
+      "network_energy_watts": 15000000000,
+      "network_hashrate_h_s": 1e+21,
+      "network_hashrate_th_s": 1000000000,
+      "observed_at_utc": "2026-10-12T00:00:00+00:00",
+      "snapshot_age_seconds": 2
+    }
+  ],
+  "properties": {
+    "attribution": {
+      "description": "Current pipeline attribution; not a value reconstructed from the historical video index.",
+      "example": "Projected by Hal Finney on January 10, 2009 ($10M per coin valuation under total global wealth absorption).",
+      "examples": [
+        "Projected by Hal Finney on January 10, 2009 ($10M per coin valuation under total global wealth absorption)."
+      ],
+      "type": "string"
+    },
+    "block_height": {
+      "description": "Current pipeline block_height; not a value reconstructed from the historical video index.",
+      "example": 920000,
+      "examples": [
+        920000
+      ],
+      "type": "number"
+    },
+    "btc_price_usd": {
+      "description": "Current pipeline btc_price_usd; not a value reconstructed from the historical video index.",
+      "example": 80000,
+      "examples": [
+        80000
+      ],
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "efficiency_baseline_j_th": {
+      "description": "Current pipeline efficiency_baseline_j_th; not a value reconstructed from the historical video index.",
+      "example": 15,
+      "examples": [
+        15
+      ],
+      "type": "number"
+    },
+    "hal_finney_horizon_multiple": {
+      "description": "Current pipeline hal_finney_horizon_multiple; not a value reconstructed from the historical video index.",
+      "example": 125,
+      "examples": [
+        125
+      ],
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "hal_finney_horizon_target_usd": {
+      "description": "Current pipeline hal_finney_horizon_target_usd; not a value reconstructed from the historical video index.",
+      "example": 10000000,
+      "examples": [
+        10000000
+      ],
+      "type": "number"
+    },
+    "network_energy_watts": {
+      "description": "Current pipeline network_energy_watts; not a value reconstructed from the historical video index.",
+      "example": 15000000000,
+      "examples": [
+        15000000000
+      ],
+      "type": "number"
+    },
+    "network_hashrate_h_s": {
+      "description": "Current pipeline network_hashrate_h_s; not a value reconstructed from the historical video index.",
+      "example": 1e+21,
+      "examples": [
+        1e+21
+      ],
+      "type": "number"
+    },
+    "network_hashrate_th_s": {
+      "description": "Current pipeline network_hashrate_th_s; not a value reconstructed from the historical video index.",
+      "example": 1000000000,
+      "examples": [
+        1000000000
+      ],
+      "type": "number"
+    },
+    "observed_at_utc": {
+      "description": "Current pipeline observed_at_utc; not a value reconstructed from the historical video index.",
+      "example": "2026-10-12T00:00:00+00:00",
+      "examples": [
+        "2026-10-12T00:00:00+00:00"
+      ],
+      "type": "string"
+    },
+    "snapshot_age_seconds": {
+      "description": "Current pipeline snapshot_age_seconds; not a value reconstructed from the historical video index.",
+      "example": 2,
+      "examples": [
+        2
+      ],
+      "type": "number"
+    }
+  },
+  "required": [
+    "block_height",
+    "observed_at_utc",
+    "btc_price_usd",
+    "hal_finney_horizon_target_usd",
+    "hal_finney_horizon_multiple",
+    "attribution",
+    "network_hashrate_h_s",
+    "network_hashrate_th_s",
+    "network_energy_watts",
+    "efficiency_baseline_j_th",
+    "snapshot_age_seconds"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / proofAvailable

Added value: +{
+  "description": "True only if an archived JSON/OTS pair was returned.",
+  "example": true,
+  "examples": [
+    true
+  ],
+  "type": "boolean"
+}

addedOutput schema / properties / proof_coverage

Added value: +{
+  "description": "Only exact archived JSON is covered by each receipt, never live metrics.",
+  "example": "Exact archived snapshot_json only; changing live_metrics are not covered.",
+  "examples": [
+    "Exact archived snapshot_json only; changing live_metrics are not covered."
+  ],
+  "type": "string"
+}

removedOutput schema / properties / range / additionalProperties
```
Removed value: -false
```

changedOutput schema / properties / range / description

Previous value: -"Requested bounds, including default latest if omitted."New value: +"Requested inclusive real height/date bounds."

changedOutput schema / properties / range / examples

Previous value: -[
-  {
-    "end": "latest",
-    "start": "919856"
-  }
-]New value: +[
+  {
+    "end": "latest",
+    "start": "2026-10-12"
+  }
+]

removedOutput schema / properties / range / properties

Removed value: -{
-  "end": {
-    "description": "Requested ending target. Example: \"latest\".",
-    "example": "latest",
-    "examples": [
-      "latest"
-    ],
-    "type": "string"
-  },
-  "start": {
-    "description": "Requested starting target. Example: \"919856\".",
-    "example": "919856",
-    "examples": [
-      "919856"
-    ],
-    "type": "string"
-  }
-}

removedOutput schema / properties / range / required
```
Removed value: -[
-  "start",
-  "end"
-]
```

changedOutput schema / properties / records / description

Previous value: -"Records in ascending indexed order; compact strings, minimal arrays, or terse key-value objects. Constraints: minItems: 1; maxItems: 100. Example: [\"HEIGHT:919856|DATE:2026-09-08|TM:125.5|HASH:0123456789abcdef\"]."New value: +"Selected actual snapshot summaries, not a synthetic daily index."

removedOutput schema / properties / records / example

Removed value: -[
-  "HEIGHT:919856|DATE:2026-09-08|TM:125.5|HASH:0123456789abcdef"
-]

changedOutput schema / properties / records / examples

Previous value: -[
-  [
-    "HEIGHT:919856|DATE:2026-09-08|TM:125.5|HASH:0123456789abcdef"
-  ]
-]New value: +[
+  [
+    "HEIGHT:920000|DATE:2026-10-12T00:00:00+00:00|TM:125|HASH:abababababababababababababababababababababababababababababababab"
+  ]
+]

changedOutput schema / properties / records / items / description

Previous value: -"One compressed source-record digest. Example: \"HEIGHT:919856|DATE:2026-09-08|TM:125.5|HASH:0123456789abcdef\"."New value: +"One requested compact, minimal or kv summary."

removedOutput schema / properties / records / items / example

Removed value: -"HEIGHT:919856|DATE:2026-09-08|TM:125.5|HASH:0123456789abcdef"

changedOutput schema / properties / records / items / examples

Previous value: -[
-  "HEIGHT:919856|DATE:2026-09-08|TM:125.5|HASH:0123456789abcdef"
-]New value: +[
+  "HEIGHT:920000|DATE:2026-10-12T00:00:00+00:00|TM:125|HASH:abababababababababababababababababababababababababababababababab"
+]

removedOutput schema / properties / records / maxItems
```
Removed value: -100
```
removedOutput schema / properties / records / minItems
```
Removed value: -1
```

changedOutput schema / required

Previous value: -[
-  "range",
-  "count",
-  "format",
-  "records"
-]New value: +[
+  "range",
+  "count",
+  "format",
+  "records",
+  "live_metrics",
+  "historical_proofs",
+  "proofAvailable",
+  "archive_state",
+  "proof_coverage"
+]

AddedSep 29, 2026

TDQS

Score is being calculated.

All bitcoin-stratigraphy tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?