API base URL: https://bitcoinstratigraphy.com. REST API: https://bitcoinstratigraphy.com/api. MCP: https://bitcoinstratigraphy.com/mcp.
Standard paid core calls: 250 sats/call via Bitcoin Lightning L402. Use tools/list for the host-enabled catalog and current schemas.
$500 Enterprise API Block: $500 USD by credit card via Stripe-hosted Checkout, or 100,000 sats via Lightning. 100 prepaid heuristic scanner calls, 30 days from issuance. POST /api/scanner only; these credits do not authorize unrelated MCP tools.
Credits are issued only after verified payment and configured treasury funding. Card checkout requires the payer's approval; never submit card details through MCP.
- stratigraphy.get
- Retrieve one indexed Bitcoin telemetry snapshot. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- stratigraphy.get_digest
- Retrieve a compact telemetry digest. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- stratigraphy.get_diff
- Compare indexed telemetry snapshots. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- stratigraphy.get_range
- Retrieve a bounded range of indexed snapshots. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- stratigraphy.list
- Discover available indexed heights and dates. Free discovery; no invoice.
- proof.attenuate
- Restrict an existing authorization capability. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- proof.verify
- Verify supported cryptographic proof inputs. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- proof.get_by_hash
- Look up retained proof payloads, receipts or lifecycle status. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- proof.list
- Discover indexed proof lifecycle records. Free discovery; no invoice.
- proof.submit
- Submit evidence to the supported proof lifecycle. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- proof.ground
- Obtain signed Bitcoin-tip context for a payload. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- payment.get_info
- Inspect MCP payment terms or verify authenticated settlement. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- mesh.get_status
- Inspect configured mesh peer status. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- mesh.broadcast
- Broadcast a signed stored telemetry snapshot to pinned peers. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- proof.notarize
- Request a detached OpenTimestamps receipt for a SHA256 digest. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- workflow.audit_trajectory
- Record an authenticated, Bitcoin-anchored batch of agent decisions; not a reasoning or correctness proof. Standard: 250 sats/call via Lightning L402; consult current quotes for grants, discounts and batches.
- payment.get_escrow
- Look up escrow state with the required caller authorization. Authenticated escrow lookup; not a flat 250-sat MCP call.
- clearing.create_contract
- Create a worker contract and its Lightning funding invoice; host-enabled and funded at the requested contract amount, not a flat MCP call fee. Host-enabled; separate Lightning contract funding at the requested amount.
- clearing.settle_contract
- Record authenticated funded-contract proof settlement when the host enables it; automated payouts and refunds remain disabled. Host-enabled; requires authenticated worker and verified contract funding.
HTTP 402 WWW-Authenticate: L402 macaroon="<macaroon>", invoice="<BOLT11>". Pay the exact invoice once, then retry the original request. Pending merchant confirmation is not authorization to pay again. Never expose payment credentials or spend without an authorized budget.