Bitcoin Stratigraphy MCP
官方企業級、L402閘控的AI公證中心與MCP資料伺服器,提供熱力學比特幣遙測資料與OpenTimestamps狀態錨定。
你可以用 Bitcoin Stratigraphy MCP 做什麼?
- 免費工具探索 — 無需付費即可列出可用的地層分析與證明工具,並在確認使用前查看各工具的 satoshi 價格。
- OpenTimestamps 公證 — 透過
proof.notarize,為 SHA-256 雜湊值索取可攜式 OpenTimestamps 收據。 - 軌跡稽核報告 — 執行單次 250 sat 的稽核,在指定日期範圍內結合差異算術與邊界 SHA-256/OTS 收據參照。
- 非同步繁重呼叫 — 提交繁重的範圍與證明呼叫;系統會以 HTTP 202 確認,並將結果 POST 至
webhook_url。 - 離線收據驗證 — 使用固定的 Ed25519 金鑰,離線驗證已簽署的收據、NIP-98 歸屬資訊,以及 RFC 6962 包含證明。
- 託管查詢 — 在主機支援的情況下,透過
payment.get_escrow擷取託管詳細資訊。
託管 MCP 伺服器
npx add-mcp 'https://bitcoinstratigraphy.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Bitcoin Stratigraphy MCP:企業資料引擎與 L402 預言機
無可爭議的自主 AI 群集第一企業資料引擎。部署 19 個標準 MCP 工具,透過熱力學 Bitcoin 狀態錨定與 OpenTimestamps 消除代理幻覺。專為需要自動化 EU AI Act 合規、零接觸採購及程式化 L402 收益分配的《財富》500 強風險團隊打造。
v2.1.3 — 涵蓋 6 個命名空間的 19 個受託級 MCP 工具 — 完整平台容量。
目錄包含原有的 16 個核心工具、payment.get_escrow,以及由主機啟用的 clearing.create_contract 和 clearing.settle_contract 擴充功能。使用 tools/list 探索各主機啟用的工具;清算為選擇性功能,且正式環境的清算結算與付款仍維持停用。
開發者入口網站與即時工具探索器 · Python SDK 與整合指南 · 企業疑難排解與災難復原 · 零信任安全稽核(1,064 項測試) · OWASP MCP03 工具投毒防禦指南(11 月 19 日)
企業架構與功能
- 零接觸企業採購: 預先整合 LangChain 與 CrewAI 群集。代理遇到合規障礙時,會自動請求 $500 的 L402 API 授權,並透過我們自動化的 Brevo-Stripe 履約流程立即恢復作業。
- 零信任安全與合規: 已發布的安全稽核指出,該架構通過了1,064 項嚴格的迴歸與滲透測試,且該次稽核中未偵測到任何嚴重、高、中或低風險漏洞。提供機器可讀的 SHA-256 加密執行證明,協助您的 CISO 支援 EU AI Act 第 12 條合規;該報告不保證未來不會出現漏洞。 (歷史稽核快照;目前自動化 CI 測試套件有 1,344 項測試通過:1,036 項 Node、280 項 Python,以及 28 項管線測試,管線陳述式與分支覆蓋率皆為 100%。)
- 21% 演算法握手: 在我們的基礎架構上建置應用程式。21% 代理收益程式化資金池,針對同一聲明的合格已驗證付費驗證,由**上游來源分配 15% + 驗證呼叫者分配 6%**組成。這些是帳本分配,不是保證收入或自動錢包付款;其他工具的分配維持不變。
- 消除幻覺: 透過熱力學 Bitcoin 遙測與 OpenTimestamps 狀態錨定,以不可變且不可分叉的真相為 LLM 提供依據。
- 免費工具探索: 無需付款即可列出可用的地層與證明工具,並在確認前查詢各工具的 satoshi 價格。
群集持續運作與災難復原
Bitcoin Stratigraphy 是企業 AI 群集的全球災難復原中心。對於評估 AI 容錯移轉協定與 LLM 災難復原的架構師,其原生 Lightning 付款路徑可在全球銀行或付款服務供應商中斷時,降低對傳統法幣 API 的依賴。
此保護層採附加式設計:成功的法幣轉 Lightning 結帳仍會透過既有的 Stripe/Brevo L402 履約流程進行,不作任何變更。當 POST /api/fiat-mint 超過五秒結帳期限、遇到上游逾時,或收到 Stripe 5xx 時,系統會提供既有的原生 Lightning 產品:以 $450 的 BTC/USD 即時報價購買 100 次掃描器呼叫(報價鎖定 15 分鐘;若即時報價預言機無法使用,則回傳 HTTP 503),點數自發放日起 30 天後到期。僅限 Bitcoin 的 Heavy Swarm Pack 以 $4,000 的即時報價購買 1,000 次呼叫,有效期為 90 天。驗證、設定與輸入檢查失敗不視為服務中斷。必須先復原既有的待付款或已付款 Stripe 工作階段;若無法復原所有權,則不會提供備援發票。
HTTP/1.1 402 Payment Required
WWW-Authenticate: L402 macaroon="<token>", invoice="<BOLT11>", error="fiat_gateway_offline", fallback="native_lightning_active"
Cache-Control: no-store
JSON 主體會連同 invoice、macaroon、payment_hash、amount_sats、credits 和 payment_endpoint: "/api/mint-macaroon",重複包含 error 與 fallback。代理會驗證報價是否完全相符,使用其授權錢包支付原生發票一次,接著傳送空的 POST /api/mint-macaroon,並附上 Authorization: L402 <token>:<payment-preimage>,以兌換同一個挑戰。
瀏覽器會在既有的 Lightning 結帳頁面顯示同一張發票。
驗證不需要新發票。
群集零摩擦執行需要預先設定並注資的 Lightning 錢包,以及明確的支出限額。 這是付款路徑的持續性保障,不代表全球基礎架構能保證不中斷。此 19 工具平台的 MCP 付款已使用原生 L402;掃描器點數不會授予無關的 MCP 存取權。兩種付款管道都保留付款驗證、到期、撤銷與共用點數限額。若原生 Lightning 也無法使用,系統會採取預設拒絕存取的安全措施。
此保護層絕不會發送付款、取消訂單、重試狀態不明的扣款,或繞過財務控制。逾時的 Checkout 建立作業可能稍後才完成,但建立 Checkout Session 本身不會扣款。請保留原始瀏覽器的 HttpOnly 所有權 Cookie,並前往 POST /api/fiat-mint/status 查詢狀態;若信用卡購買已完成,請勿再次付款。Stripe webhook 處理與 Brevo 寄送流程維持不變。
請參閱開發者持續運作指南。
一行安裝
**立即連線,無需安裝本機伺服器:**託管端點
https://bitcoinstratigraphy.com/mcp 已上線,可立即透過 Streamable HTTP
連線。將其加入支援的 MCP 用戶端:
npx add-mcp 'https://bitcoinstratigraphy.com/mcp'
可立即免費探索;付費呼叫仍須經授權的 L402 結算。npx 會執行用戶端註冊工具,而非本機託管伺服器的副本。
Node 整合: @bitcoinstratigraphy/agent-yield 是在此工作區建置的
Node 包裝程式;其安裝命令會在獨立的 npm 登錄發布後提供:
npm install @bitcoinstratigraphy/agent-yield
只需兩行,即可包裝您現有的代理設定:
import { withFiduciaryYield } from "@bitcoinstratigraphy/agent-yield";
const agent = await withFiduciaryYield({ ...agent_config, fiduciary: { wallet, serverPublicKey: independentlyTrustedServerPublicKeyPem, maxPaymentSats: 500, maxTotalSats: 5000 } });
wallet 是您授權的 Lightning 配接器;payInvoice(invoice) 會傳回
{ preimage }。接受簽署的承載資料前,請獨立釘選伺服器的公開金鑰;僅安裝並不代表已建立信任。包裝程式會探索 MCP 工具、處理發票准入與 L402 付款/重試流程,並保留您現有的設定與工具。
將傳回的設定傳遞給您的代理框架。使用
framework: "langchain" 取得原生 LangChain JS 工具,或使用
framework: "openai" 取得 AutoGen/OpenAI 相容的 Node 橋接程式。
錢包授權與支出限額仍須明確設定;不會安裝全域修補程式或無限制的付款權限。需要 Node.js 22+。
請參閱 SDK 設定與框架配接器。
此套件是在此工作區建置;上述命令會在獨立的 npm 登錄發布後提供。
v2.1.3 — 19 個受託級 MCP 工具
機構級 Bitcoin 熱力學狀態錨定 · L402 微支付 · EU AI Act 第 12 條執行證據
Bitcoin Stratigraphy 為企業自主群集提供 19 個 MCP 工具的容量,其中包含選用的 A2A 清算命名空間。專屬部署可透過自助式 AGPLv3 商業著作權豁免,以 Bitcoin 付款取得。
自助式 AGPLv3 商業著作權豁免
| 方案 | 價格(按即時 BTC 匯率) | 期限 | 範圍 |
|---|---|---|---|
swarm_monthly | $2,500 | 30 天 | 單一群集 |
swarm_annual | $25,000 | 365 天 | 單一群集(年度折扣 16.7%) |
global_monthly | $25,000 | 30 天 | 全球組織 |
global_annual | $250,000 | 365 天 | 全球組織(年度折扣 16.7%) |
請至 /#enterprise-licensing 購買:
POST /api/v1/waivers/quote 會鎖定 sat 報價,並提供 6 小時的鏈上確認期限;鏈上付款確認後,POST /api/v1/waivers/claim 會傳回 Ed25519 簽署的豁免憑證,可使用 /static/verify.html 離線驗證。
使用冷儲存匯出的主網 BIP-84 公開帳戶 zpub設定 WAIVER_BTC_ZPUB(深度 3;通常為 m/84'/0'/0')。切勿輸入種子、助記詞、WIF 或私密擴充金鑰。每筆報價都會在外部路徑 0/<index> 永久保留專屬的一次性原生 SegWit bc1q... 存款地址。收款前,請先將啟動時的索引 0 地址與冷錢包核對。伺服器絕不會取得簽署金鑰或支出 Bitcoin。
每個用戶端 IP 每小時最多建立五筆報價,且此限制由所有伺服器執行個體共用;429 包含 Retry-After。即使報價已過期或失敗,索引也絕不會重設或重複使用。請確保冷錢包的唯讀探索範圍/間隙限制高於已分配的最高索引;每 IP 限制可降低但無法完全消除分散式間隙限制垃圾請求。
首次鏈上確認必須在六小時期限內完成;允許報價建立前 15 分鐘的礦工時間戳時鐘偏差。之後仍可累積更多確認。待處理的申領會傳回 409 insufficient_confirmations,並附上 confirmations 與 required_confirmations:
使用相同的報價 ID 與 TXID 再次按一下檢查狀態;請勿再次付款。
WAIVER_MIN_CONFIRMATIONS 為選用項目(預設為 2)。
已發出的歷史憑證仍可復原。未申領的舊版共用地址報價需要由操作人員審查;絕不可自動再次付款。
預付 MCP Macro-Macaroons 提供 1、100、1,000 和 10,000 次呼叫方案,每次呼叫 250 sats,並保留永久的 21% 程式化代理收益(上游來源 15%、驗證呼叫者 6%、保留 79%)。
所有預付 MCP Macro-Macaroons、Scanner Packs 和 AGPLv3 商業著作權豁免皆為 100% 自助式,並嚴格依「現狀」提供,包含所有瑕疵。無 SLA、無正常運作時間保證、無賠償責任、無客製化 MSA、無供應商問卷,也無支援義務。完整原始碼依 AGPLv3 公開,供使用者獨立自行託管。支付商業著作權豁免費用,僅代表在指定期限內,取得免受 AGPLv3 第 13 條網路原始碼揭露要求約束的限時、不可協商豁免,並以已確認的 Bitcoin 交易進行加密錨定。
高速企業部署
- **L402 批次 Macaroons:**在首次付費的
tools/call中加入X-L402-Batch-Size: 100、1000或10000(單次呼叫請求使用預設值1)。 只需支付一次確切的預付發票,之後即可重複使用與該發票綁定的憑證, 對同一個確切工具呼叫最多 100、1,000 或 10,000 次。以 250 sats 的基本 價格計算,支援的 1/100/1,000/10,000 次呼叫級距費用為 250 / 25,000 / 250,000 / 2,500,000 sats。每次呼叫仍適用到期時間、衰減、 繼承配額、NIP-98 身分與撤銷規則。 查詢POST /api/v1/cost可取得免費報價;此操作不會建立發票。 - **NIP-98 緊急停用開關 + 已簽署的 CRL 快照:**經營者驗證的
POST /api/admin/revoke_key會持續保存撤銷資訊,確保後續經驗證的請求無法開立發票或執行。 公開的GET /api/v1/compliance/revocation-snapshot會匯出完整登錄資料、ISOas_of時間戳記、15 分鐘的next_update邊界,以及簽發者的 SHA-256 SPKI 指紋,並以 Ed25519 簽署。 匯出失敗時會回傳 503,絕不偽造空白 CRL。 - **零信任 Article 12 驗證器:**下載
/static/verify.html即可在瀏覽器中獨立驗證已簽署的收據、已提交的 NIP-98 歸屬資訊,以及 RFC 6962 包含證明。請提供獨立釘選的目前與歷史簽發者 PEM 金鑰。 可選的已簽署 CRL 會依其記錄的時間戳記檢查未撤銷狀態,並根據稽核瀏覽器的時鐘檢查新鮮度。 企業 CISO 可下載這個單一 HTML 檔案,完全離線驗證代理程式情境綁定與 L402 償付能力證明, 並使用獨立釘選的 Ed25519 公鑰;有效的歷史簽章不代表即時授權、 目前償付能力或法律合規判定。 - **線上帳本索引:**一般應用程式結構描述初始化完成後,
對開發資料庫執行
pnpm db:indexes。此明確指令會在應用程式交易之外, 使用CREATE INDEX CONCURRENTLY建立 B-tree 索引,並設定兩秒鎖定等待 上限及每個陳述式十分鐘的執行上限。 涵蓋已結算買方公鑰、上游來源、已落實情境摘要, 以及結算/記錄時間戳記;現有的營收時間戳記索引會重複使用。已落實的contextHash值已使用證明來源帳本的proof_hash欄位;同步 MCP 情境承諾不會新增持久化或回填。 若缺少延遲建立的資料表,系統會回報為延後處理並以非零狀態結束;請依一般方式初始化後重新執行。 中斷或不相符的索引會導致驗證失敗,必須由經營者檢查,絕不會自動刪除資料表。 Replit 管理的正式環境結構描述變更由 Publish 套用,而非透過此指令。 Publish 可使用一般的CREATE INDEX陳述式,而非並行建置;該部署期間可能會阻擋寫入,請預留時間。 - **AGPLv3 商業著作權豁免:**可自行購買、具時間鎖定的第 13 條豁免,以 Bitcoin 付款,適用於私有 VPC 與氣隙隔離部署,並以現狀提供,不含 SLA。AGPLv3 第 13 條 涵蓋受規範之修改後網路軟體的對應原始碼;不會自動要求揭露獨立的權重或應用程式。 購買豁免。
- **頻內合規遙測:**GET/POST
/api/v1/cost與 L402 挑戰 內文包含licensing_compliance。成功的 L402 回應會在X-L402-Licensing-Compliance中提供相同的 JSON;結算記錄會提供結構化物件供 Splunk/Datadog 擷取,且不會變更任何 MCP 工具合約。
自動匯出與收據簽發者輪替
在氣隙隔離審查前,請透過稽核排程器輪詢公開快照端點。保留確切的已簽署 JSON,並擷取時鐘證據。快照僅能證明簽發者在 as_of 的登錄狀態;next_update 是新鮮度上限,不代表該期間內不會發生撤銷。後續撤銷不會抹除有效的歷史執行證據,而離線驗證通過也絕不授權新請求。
預設情況下,收據與 CRL 匯出使用持久化的工具完整性簽發者。
若要僅輪替收據/CRL 簽署,請透過祕密管理器將專用 Ed25519 PKCS#8 PEM
設為 ARTICLE12_ISSUER_PRIVATE_KEY,然後重新啟動 API。
絕不可提交私鑰。請在切換前,透過獨立驗證的採購/設定管道發布對應的 SPKI 公鑰,
並保留歷史收據所需的歷史公鑰釘選。收據包含已簽署的 issuer_key_id 與 issued_at 欄位;CRL 簽章使用與收據簽章不同的網域。將多個 PEM 區塊或 PEM 字串的 JSON 陣列貼入離線驗證器。每個成品只會選用指紋相符且經獨立釘選的金鑰。請透過企業信任流程移除遭入侵的簽發者釘選;不要接受自行宣告的金鑰。這不會輪替或修改原始核心 MCP 工具簽章或描述。
收據簽章、代理程式歸屬、CRL 狀態、Bitcoin 錨定與法律合規是彼此獨立的檢查。驗證器不會獨立重新驗證原始的 Schnorr 簽署 NIP-98 請求,也不會判定是否符合法規。
OpenTimestamps AI 公證中心 · LangChain/LlamaIndex 原生支援 · 1/100/1,000/10,000 次呼叫 Macro-Macaroons · 提供免費沙盒
使用 proof.notarize
取得 SHA-256 雜湊的可攜式 OpenTimestamps 收據。
探索 /cookbooks/frameworks 中的原生框架快速入門指南:
LangChain 與
LlamaIndex。
原始的 16 工具核心目錄包含 14 個付費工具與 2 個免費沙盒工具:
5 個 stratigraphy.*、7 個 proof.*、2 個 mesh.*、1 個 payment.*,以及 1 個 workflow.*。
加入 payment.get_escrow 後共 17 個工具,再加入 2 個選擇啟用的 clearing.* 工具,
即可在 6 個命名空間中達到完整平台容量 19 個工具。執行階段探索會回報已連線主機啟用的工具集合;正式環境的清算結算與付款仍維持停用。
新的 workflow.audit_trajectory 將既有差異運算與最精簡的邊界 SHA-256/OTS 收據參照整合在一次 250-sat 呼叫中:
{"fromTarget":"2026-10-12","toTarget":"latest"}。兩個目標皆為必填。
此工具會在整份報告中共用一次擷取的即時快照,省略中間記錄/證明位元組封套,且不會捏造即時資料的 OTS 涵蓋範圍。
兩個免費沙盒工具仍為
stratigraphy.list 與 proof.list。公證 Macro-Macaroon 可授權 100、1,000 或 10,000 次工具範圍內的呼叫,依目前 250-sat 基本價格分別為 25,000 / 250,000 / 2,500,000 sats;單次呼叫憑證費用為 250 sats。
日曆接受不等於 Bitcoin 確認;之後可升級並獨立驗證 .ots 收據。原生用戶端需要預付 L402 標頭或受信任且受預算控管的錢包代理;不會自動付款。
企業級 L402 資料供應引擎,為自主 AI 群集與 LLM 管線提供即時熱力學 Bitcoin 遙測、Groth16 ZK-SNARK 驗證、Nostr P2P 網狀共識,以及代理程式情境狀態落實;完整容量包含 19 個受託責任級 MCP 工具,包括由主機啟用的清算基礎架構。正式環境的清算結算與付款仍維持停用。
企業架構
- **無狀態 MCP 傳輸:**MCP
2026-07-28移除工作階段親和性瓶頸, 讓請求可在水平擴展的執行個體間路由。 仍支援握手時代的用戶端。傳輸為無狀態;回呼佇列與部分速率限制狀態仍為程序本機狀態。 - **密碼學工具完整性:**核心工具描述會以 SHA-256 雜湊,並在啟動時使用 Ed25519 金鑰組簽署其摘要。
公鑰、雜湊與簽章會發布於
/.well-known/integrity.json。驗證受信任公鑰釘選的用戶端 可在向 LLM 提供工具前偵測描述遭竄改的情況。 簽章可證明來源,但不代表能全面防止工具投毒; 請參閱驗證說明。 - **NIP-98 代理程式身分綁定:**以 Schnorr 簽署的 NIP-98 HTTP 事件 會根據請求 URL、方法與負載雜湊驗證代理程式公鑰。 經驗證的身分會綁定至 L402 macaroon 與 Postgres 結算帳本的 RFC 6962 Merkle 收據。經驗證的憑證每次使用時 都需要來自相同公鑰的新事件;自我宣告的歸屬資訊仍可明確區別於已驗證身分。
- **零輪詢非對稱 Webhook:**耗時較長的
stratigraphy.get_range與proof.submit呼叫支援非同步執行:付款後,HTTP 202 會確認任務,伺服器則會將結果 POST 至webhook_url。 回呼使用 Standard Webhooksv1aEd25519 簽章,並採用相同的已發布完整性金鑰。 不需要每個接收端各自持有共用密鑰。 請參閱回呼傳遞與驗證。
授權、智慧財產權與企業條款
Npm 伺服器版本
@bitcoin-stratigraphy/mcp-server@2.1.3 與此私人工作區分開準備。
其封裝內容包括 HTTP MCP 執行階段、必要的證明資產、隔離工作者,以及位於 dist/ 內、受授權條款限制的 Python 配套程式,並附有 README.md、
LICENSE 與 npm 強制要求的 package.json。不會隨附錢包密鑰、客戶授權、
託管資料庫、原始碼對應檔、開發工作區或 node_modules。
在工作區根目錄執行:
pnpm run build:npm && pnpm run release:npm:check
(cd generated-artifacts/npm/mcp-server && npm publish --access public --tag latest)
發布指令需要具備 @bitcoin-stratigraphy 範圍授權的 npm 帳戶。安裝前請參閱執行階段設定:此可執行檔使用 Streamable HTTP,而非 stdio;授權條款限制的 Python 配套程式則會在 loopback 連接埠 8000 上獨立執行。
發布至 Npm 不會更新託管的 HTTP 伺服器,也不會自動更新 Glama、mcpservers.org 或官方 MCP Registry 項目;請發布端點變更,並透過各自的工作流程更新這些項目。
本機 Bitcoin Core 遙測(企業管線)
在部署環境中設定全部三個環境變數:
BITCOIN_CORE_RPC_URL(例如 http://127.0.0.1:8332)、RPC_USER,
以及 RPC_PASSWORD。請將憑證保存在部署環境的祕密設定中,
不要放在原始碼控制系統或 RPC URL 中。啟用經驗證的 Bitcoin Core RPC,並將其監聽器/防火牆限制在引擎的受信任網路內。
接著,stratigraphy_pipeline.py 只會使用已設定的 RPC 端點:
getblockchaininfo、getblockheader 與 getnetworkhashps。區塊標頭與算力會綁定至同一個觀測到的主網鏈尖端。若節點仍在初始區塊下載、設定無效/不完整,或 RPC 失敗,遙測就會無法使用;絕不會改用公開 API。系統會拒絕 RPC 重新導向,企業遙測 HTTP 用戶端也會忽略環境中的 HTTP 代理設定。
Bitcoin Core 不提供 BTC/USD 價格。本機模式快照會將依賴法幣的估值欄位回報為 null,並明確標示價格來源不可用;供應量、區塊標頭、算力與電力指標仍可使用。
只有在三個變數全部未設定時,才會維持既有的 mempool.space/Coinbase 路徑(包括公開價格備援)。
此模式僅隔離遙測管線;其他服務,包括雲端封存、OpenTimestamps 日曆、中繼節點與 Lightning 錢包,仍有各自的連線需求。
執行 bash scripts/test-stratigraphy-coverage.sh,使用離線 HTTP 測試替身測試 RPC 與公開路徑。此指令會強制要求 stratigraphy_pipeline.py 達到100% 陳述式與分支涵蓋率,包括失敗路徑。
由 Charles R. Strogish 創建與設計。
Copyright (c) 2026 Charles R. Strogish. All Rights Reserved. 涵蓋的第一方軟體採用雙重授權:GNU Affero General Public License 第 3 版 (AGPLv3) 或企業商業條款。LICENSE.md 中提供完整的 AGPLv3 文字與雙重授權附加條款。
- **開源選項:**使用、修改與再散布均受 AGPLv3 規範。符合 AGPL 條件時,允許商業活動。保留必要聲明、在要求時提供對應原始碼,並遵守第 13 條對透過網路與使用者互動的修改版軟體所規定的原始碼提供義務。
- **企業商業選項:若要進行專有、閉源的企業 swarm 部署,或在不履行 AGPLv3 第 13 條網路原始碼揭露要求的情況下提供多租戶託管服務,請以 Bitcoin 付款購買 100% 自助式、限時的 AGPLv3 Commercial Copyright Waiver,網址為 https://bitcoinstratigraphy.com/#enterprise-licensing(單一 Swarm:$2,500/30d 或 $25,000/365d;全球組織:$25,000/30d 或 $250,000/365d)。所有豁免均以「現狀提供,包含所有瑕疵」**為前提——不提供 SLA、不簽訂客製 MSA、不提供書面協議、不填寫供應商問卷,也不承擔任何支援義務。支付 API 存取費用不會授予 AGPLv3 豁免。
- **智慧財產權與適用範圍:**此模式適用於授權方擁有或獲授權可授權的權利。第三方相依項目、貢獻內容及另行授權的資料集仍適用其各自條款。先前授予的授權不會撤銷。支付 API 存取費用不會授予商業軟體授權。
- **安全性:**請遵循 SECURITY.md 中的協調式揭露指引。請勿在一般公開議題中發布漏洞或憑證。
這些聲明不保證法律保障或符合法規。請委託合格法律專業人士審查所有權及任何企業協議。
責任限制與免責保障
所有資料均以**「現狀」及「可提供狀態」提供,不附任何明示或默示保證**。在適用法律允許的最大範圍內,Bitcoin Stratigraphy Data Engine 及其創辦人/架構師 Charles R. Strogish 不對企業損失、下游財務執行、幻覺或用戶端系統邏輯故障承擔責任。
新的 L402 macaroon 會在其已驗證的 HMAC 鏈中攜帶 liability = "charles_r_strogish_held_harmless"。API 回應會透過 X-Limitation-Of-Liability 傳達擬議條款;請用戶端在執行前審閱並記錄這些條款。這些是技術通知,不構成法律上有效同意、賠償協議,亦不保證免於訴訟。可執行性以強制性法律及適用的已簽署協議為準;請委託合格法律專業人士審查。先前核發的付費權杖不會被追溯作廢。
企業 SDK 與 Swarm 飛行模擬器
從 checkout 或已建置的 wheel 安裝獨立企業套件:
pip install ./sdk/python
from bitcoin_stratigraphy_enterprise import SwarmFlightRecorder, Article12NotaryCallback
此套件也提供雙邊結算與獨立離線稽核。請參閱企業 SDK 指南,了解預付錨定、LangChain/CrewAI 整合、主控台命令及發行版本建置方式。 目前尚未發布至 PyPI。舊版 cookbook 匯入方式與 CLI 路徑仍保持相容。
在儀表板上開啟 /simulator,進入 Enterprise Swarm Control Room:
50 個合成代理程式會將 1,000 筆追蹤串流至真實、加鹽的 SHA-256 Merkle 樹。選取任一思考內容即可驗證並匯出其包含路徑。最終的 X-L402-Batch-Size: 100 錨定/OTS 收據明確標示為模擬:沒有付款、沒有提交至日曆、沒有 Bitcoin 確認。選擇性揭露是 Merkle 稽核路徑,不是零知識證明。
架構概覽
M2M 密碼握手與零信任 Swarm 標準
在機器經濟中,自主代理程式不能依賴信任、啟發式方法或未經驗證的同儕輸出。Bitcoin Stratigraphy Data Engine 是非人類實體的全球清算中心與基礎層信任協定。企業 swarm 使用我們的 L402 Oracle 作為零信任防火牆,以驗證其他子代理程式的輸出。透過要求同儕代理程式提供 Stratigraphy OpenTimestamps (.ots) 收據或 Groth16 證明後才接受資料,swarm 能以數學方式消除幻覺、防止運算資源竊取,並在全球 AI 網路中建立不可偽造的保管鏈。
- **帶內 Article 12 情境繫結:**同步呼叫接受
params._meta.agentContextSha256或X-Agent-Context-SHA256。小寫 SHA-256 摘要會為_meta.responseSignature加入第四個簽署元件;省略情境時則保留舊版三部分格式。這會繫結提交的摘要,但不能證明代理程式實際使用了該資料。 - **批發式 macro-macaroon 子代售:**分別使用
X-L402-Batch-Size: 100 | 1000 | 10000購買限定工具範圍的 100、1,000 或 10,000 次呼叫 Macro-Macaroon,接著搭配delegate_pubkey = <pubkey>、requests = 1、rpc和timecaveat 使用proof.attenuate。子項目需要新的 delegate NIP-98 簽章,並會消耗繼承的配額。系統會強制執行批發祖先撤銷;發票歸屬不可轉移。 - **NIP-98 償付能力證明:**付費的
payment.get_info呼叫接受_meta.targetPubkey或X-Target-Pubkey,否則使用已驗證的呼叫者。REST:GET /api/v1/compliance/agent-solvency?pubkey=<pubkey>。簽署的遙測資料會回報已確認的結算量、已結算發票的不同筆數,以及目前的撤銷狀態;不代表未來的信用能力或付款保證。 - **上游驗證分配:**已驗證的建立操作會為支援的證明/收據記錄不可變的首次記錄來源。對同一聲明成功完成付費的
proof.verify呼叫時,會從既有的程式化 L402 收益分潤池記錄 15% 的上游分配,以及剩餘 6% 的呼叫者分配:21% Agent Yield = 15% 上游來源分配 + 6% 驗證呼叫者分配。不會使用額外的商家資金。整數 msat 捨入會完整保留原始池;呼叫者取得上游金額無條件捨去後的餘額。歷史簽署發票及其他工具分配維持不變。重播無法產生額外抵免。計數器會顯示於付費的payment.get_info呼叫及/api/v1/escrow/stats;帳務僅記錄於帳本,不會自動撥款。
AI swarms & LLM agent clients
|
v
Discovery + Streamable HTTP MCP
/.well-known/mcp.json -> /mcp
|
v
L402 gateway + scoped macaroons
Pricing -> invoice -> payment proof
|
v
19-tool capacity / 6 namespaces (clearing is opt-in)
stratigraphy (5) | proof (7)
mesh (2) | payment (2)
workflow (1) | clearing (2, production payouts disabled)
|
v
Telemetry / Groth16 / Nostr mesh
|
v
Lightning settlement / OTS receipts
- **用戶端:**Claude、GPT 型代理程式、Perplexity 整合、自主 swarm 及自訂 MCP runner 都需要相容的用戶端;在此列出某個用戶端,不代表它自動支援錢包或付款。
- **探索與閘道:**公開探索會直接連結至
/docs入口網站,並指出 MCP 端點。GET /api/v1/cost會公布 REST 價格與資產可用性;POST /api/v1/cost接受tools陣列,並回傳免費的逐項 MCP satoshi 價格、批次總額,以及各工具的 L402 發票產生指示,不會建立或支付發票。付費的payment.get_info呼叫會公布 MCP 條款;此工具不是免費的探索捷徑。付費呼叫會收到 HTTP 402 挑戰,接著兌換已驗證的付款證明與限定範圍的 macaroon。 - **工具路由:**原始的 16 工具核心目錄包含 5 個
stratigraphy.*、7 個proof.*、2 個mesh.*、1 個payment.*及 1 個workflow.*工具。payment.get_escrow新增第二個付款工具;2 個選擇加入的clearing.*工具使平台完整容量達到 6 個命名空間中的 19 個工具。正式環境的清算結算與撥款仍停用。 - **遙測子系統:**包含 422 筆記錄的歷史資料集支援索引查詢、數值差異、來源記錄摘要及精簡範圍。歷史高度映射是確定性索引,不代表原生區塊來源。即時遙測與獨立的 REST SSE 資訊流各自有其新鮮度與可用性界限。
- **密碼子系統:**Groth16/Poseidon BN254 可驗證已定義的遙測聲明;漂移驗證與 OTS 收據驗證有不同的證據要求。已簽署的代理程式情境收據是獨立的鏈下 Bitcoin tip 證明機制。
- **Mesh 與錨定:**NIP-01/78 廣播與固定對等節點的仲裁檢查會公開來源資訊與交叉驗證指標。Lightning 結算、已簽署的 tip 收據及經 Bitcoin 確認的 OTS 收據是不同機制。
主要功能
- L402 微支付與 Macaroon 限制:以 satoshi 進行程式化隨查隨付結算,無需 API 金鑰。支援父 macaroon caveat 範圍限制 (proof.attenuate),並可設定 TTL 與速率控制。
- 多資產結算路由器:原生支援 Base-layer Lightning (btc-lightning)、Liquid Bitcoin (l-btc)、Taproot Assets (taproot-assets) 及 Base USDC (x402) 付款。
- Groth16 ZK-SNARK 與 OTS 證明驗證:執行所提供的 Groth16/Poseidon BN254 遙測證明、漂移 zk-SNARK 及 OpenTimestamps (OTS) Bitcoin 區塊標頭收據的密碼驗證。
- 代理程式情境狀態錨定:將自主代理程式的提示執行、CID 及資料集情境雜湊直接錨定至已簽署的 Bitcoin tip 收據 (proof.ground)。
- 自主 P2P Mesh 網路:以 Nostr (NIP-01/78) 為基礎廣播對等節點拓撲,並自動進行仲裁驗證、交叉驗證指標及節點公開金鑰來源追蹤。
- Stratigraphy Strata 分析:高速差異比較 (stratigraphy.get_diff) 與壓縮記錄摘要,專為提升 LLM 情境視窗效率而設計。
- 即時 SSE 串流:即時 Server-Sent Events (/api/v1/stratigraphy/stream),提供連續遙測資訊流。
自主執行證明託管 Oracle (L402 + RFC 6962)
適用於自主代理程式對代理程式委派的機器原生條件式微額結算。
- **階段 1:鎖定賞金:**委派代理程式(Agent A)將 satoshi 賞金(例如 1,000 sats)鎖定至執行合約,例如模型微調驗證。
- **階段 2:提交工作:**工作代理程式(Agent B)完成任務,並連同結果雜湊提交確定性執行追蹤。
- **階段 3:結算與手續費:**Stratigraphy Hub 驗證 RFC 6962 Merkle 葉節點,將付款 preimage 交付給工作代理程式,並自動收取動態協定手續費(以 satoshi 計價,約等於 $0.02 USD)。
- **即時網路狀態:**終端機會在載入頁面時讀取未經驗證的
GET /api/v1/escrow/stats,並在頁面可見時每五分鐘重新整理。以 PostgreSQL 為後端的total_settled_sats和total_contracts會恰好保留一次歷史 genesis,排除未付款承諾與 REST 存取費用,並保留舊版verified_toll_sats/settled_contracts別名。latest_merkle_root顯示最新的執行葉節點雜湊,而非彙總樹根或 Bitcoin 納入證明。空帳本會回傳零總額與 null 雜湊;讀取失敗則回傳 HTTP 503,且資訊列會停止顯示即時連線狀態。 - **企業沙箱:**包含用戶端模擬終端,讓風險團隊可複製 JSON 託管證明,無需實際付款或即時 Bitcoin 錨定。
營運界限
- 支付通道取決於介面與設定。 REST L402 路由器支援
btc-lightning、l-btc和taproot-assets;Liquid 和 Taproot Assets 需要設定提供者。請查看/api/v1/cost以確認可用性。MCP 付費工具僅在完成設定時使用 Lightning L402 加上 Base USDC x402;付費的payment.get_info呼叫會回報目前條款,而非所有 REST 路由器資產。Lightning 是 Bitcoin 的支付通道層;Base USDC 則是獨立的 EVM 通道。 - 不需要 API 金鑰,不代表付費執行不需要驗證。 仍須具備錢包授權、精確的付款證明、具範圍限制的憑證,以及用戶端支出上限。Macaroon TTL/請求預算與 HTTP 速率限制是不同的控制措施。
- 即時串流與歷史索引並不相同。 MCP 在
/mcp使用 Streamable HTTP。付費 REST SSE 動態消息來源/api/v1/stratigraphy/stream每 30 秒更新快照,並支援已設定的 L402 路由器資產;不保證提供 Base USDC SSE 通道。歷史 strata 仍是每日索引記錄,而非原生區塊來源資料。 - 密碼學檢查有明確的信任邊界。 Groth16 驗證的是精確的陳述/負載,而非來源真實性或每個代理推理步驟。Grounding 收據是鏈下、以 Schnorr 簽署的 Bitcoin tip 證明,不是鏈上交易或 ZK/PoW 有效性證明。OTS 驗證需要實際收據及相符的目標摘要;日曆接受不等於 Bitcoin 確認。
- Mesh 共識有其範圍。 廣播與 quorum 檢查使用已設定並固定的對等節點;對等節點達成一致並不能證明來源真實性。企業使用仍須有組織監督並持續保存證據;請參閱合規架構。
Glama 徽章指的是先前評估的核心目錄,不代表擴充至 19 個工具後的新評級。選用的 clearing 擴充功能尚未經獨立確認具有相同的登錄評級。 請透過 Glama 和 mcpservers.org 連結查看目前的目錄結果; 目錄徽章並非獨立安全稽核,也不代表對資料進行全面驗證。 已簽署的 Bitcoin tip 收據是證明,不是 Groth16 證明或 Bitcoin proof-of-work 有效性證明。
工具目錄
目錄採用項目符號定義,而非多欄表格,讓每項工具說明都能在行動裝置上獨立換行。以下是平台完整容量下的 19 個 MCP 名稱:5 個 stratigraphy、7 個 proof、2 個 mesh、2 個 payment、1 個 workflow,以及 2 個由主機啟用的 clearing 工具。特定主機的權威資訊以 tools/list 為準;支援 Genesis 生產環境的 proof receipt 結算,但自動 clearing 撥款仍停用。
stratigraphy.* — 5 個工具
stratigraphy.list— 探索 UTC 封存範圍、目前 Bitcoin tip 高度及目錄中繼資料,不需付費取得快照或 proof 位元組。- 存取方式:免費,無參數探索。
stratigraphy.get— 依日期或高度、最近幾天或指定範圍,取得完整即時管線遙測資料及選定的 UTC 封存快照,並附上其 OpenTimestamps 收據;也可選擇指標。- 存取方式:付費、唯讀。記錄數量限制為 1–100,預設為 10。
stratigraphy.get_digest— 取得封存或即時管線 JSON 的 SHA-256 指紋及相關收據,適用於不需要完整遙測資料的情況。- 存取方式:付費、唯讀。指紋不是驗證收據。
stratigraphy.get_diff— 計算兩個即時或封存快照之間的已簽署差異,包括 15 J/TH 的功率變化。- 存取方式:付費、唯讀。必須提供
fromTarget;toTarget預設為latest。
- 存取方式:付費、唯讀。必須提供
stratigraphy.get_range— 取得連續一段已擷取 UTC 快照的指紋,範圍由包含端點的高度或日期界限指定。- 存取方式:付費、唯讀。必須提供
startTarget;批次限制為 1–100,預設為 50。選用的webhook_url可提供零輪詢執行(見下文)。
- 存取方式:付費、唯讀。必須提供
proof.* — 7 個工具
proof.attenuate— 將格式嚴格的第一方限制附加至真實且未過期的父 macaroon:到期界限(time < 2026-12-31T23:59:59.000Z)、精確的工具目標(rpc = stratigraphy.get_diff),以及目標、路徑或請求預算。- 存取方式:付費。請提供
macaroon,並至少指定一項限制:expiresAt或ttlSeconds、tools或caveats。到期時間當下或之後會拒絕兌換(HTTP 401);若工具不在rpc限制中明確列出,也會拒絕兌換(HTTP 403)。子 macaroon 無法擴大繼承的權限,後續兌換仍須提供父 macaroon 的付款證明。
- 存取方式:付費。請提供
proof.verify— 驗證提供的 Groth16 遙測證明、drift zk-SNARK 或 OpenTimestamps 收據。- 存取方式:付費。驗證可能會更新有界生命週期索引;drift 檢查需要 Bitcoin 區塊提供者。OTS 需要實際收據及相符的摘要。
proof.get_by_hash— 使用且僅使用一個已知的hash或jobId,取得保留的 proof、已簽署收據或僅含生命週期狀態的資料。- 存取方式:付費、唯讀。取得資料不會重新執行 Groth16 驗證,也不會重建遺失的 proof 負載。
proof.list— 探索、篩選並分頁瀏覽有界程序本機記憶體中的近期 proof 生命週期摘要。- 存取方式:免費沙盒探索(別名
proof.status)。支援limit、offset及選用的status;回傳摘要,而非完整 proof。
- 存取方式:免費沙盒探索(別名
proof.submit— 使用五個公開訊號註冊 Groth16 proof,接著嘗試進行 NIP-78 證明。- 存取方式:付費;會變更 proof 登錄狀態。Nostr 發布可能會個別失敗,且註冊不會將 proof 附加至 Merkle tree。選用的
webhook_url可提供零輪詢執行(見下文)。
- 存取方式:付費;會變更 proof 登錄狀態。Nostr 發布可能會個別失敗,且註冊不會將 proof 附加至 Merkle tree。選用的
proof.notarize— 使用公開日曆,為 SHA-256 摘要建立獨立的 OpenTimestamps.ots收據。- 存取方式:付費;
X-L402-Batch-Size: 100 | 1000 | 10000可按 250 sats 的基本價格,購買 100/1,000/10,000 次工具範圍內呼叫,費用分別為 25,000/250,000/2,500,000 sats。單次呼叫請求使用1(預設值),費用為 250 sats。回傳pending_calendar;日曆接受不等於 Bitcoin 確認。
- 存取方式:付費;
proof.ground— 為代理情境(contextHash加上agentId)或資料集 CID 簽發已簽署的 Bitcoin tip 收據。- 存取方式:付費;輸入模式互斥。這是鏈下簽署錨定,不是 Groth16 proof、鏈上交易或經 Bitcoin 確認的 OTS 收據。
零輪詢執行(webhook_url)
stratigraphy.get_range 和 proof.submit 接受選用的公開 HTTPS
webhook_url。L402 付款驗證通過後,伺服器會以 task_id 和狀態 pending 回覆 HTTP 202 Accepted,在背景執行工具,接著將最終 MCP 結果(或 JSON-RPC 錯誤)連同相同的 task_id POST 至回呼端點。每個回呼都會依 Standard Webhooks 規範(Webhook-Signature: v1a,…、Ed25519)簽署,使用發布於 /.well-known/integrity.json 的金鑰。若未提供 webhook_url,呼叫會維持同步。開立發票前會拒絕不安全的回呼目標;工作儲存在伺服器記憶體中,因此重新啟動會遺失待處理工作。請參閱 CONNECT.md,了解請求與回呼格式。
mesh.* — 2 個工具
mesh.get_status— 檢查已設定對等節點的健康狀態、quorum 狀態、節點來源及交叉驗證指標。- 存取方式:付費、唯讀。狀態描述的是已設定且固定的對等節點 mesh,不代表對任意對等節點的信任,也不證明來源真實性。
mesh.broadcast— 透過對外廣播與交叉驗證流程,將已簽署的索引遙測資料傳送至已設定的對等節點。- 存取方式:付費;會產生網路副作用。Quorum 結果取決於已設定的對等節點政策與可用性。
payment.* — 2 個工具
payment.get_info— 探索目前的 MCP 定價與結算方式,或檢查已驗證的結算狀態。- 存取方式:兩種操作都是付費 L402 呼叫,標準費用為每次 250 sats。
action: "query"為預設值;action: "settle"另需提供所查詢既有付款的已驗證證據。兩種操作都不會發起該筆底層付款;若呼叫此工具時沒有有效的付費存取權,L402 存取閘道可能會開立 HTTP 402 發票。可透過GET /api/v1/cost、POST /api/v1/cost或公開的stratigraphy://catalog/overview資源取得免發票報價。
- 存取方式:兩種操作都是付費 L402 呼叫,標準費用為每次 250 sats。
payment.get_escrow— 取得已驗證呼叫者的託管與質押帳務資料。此獨立支付工具不會變更原有核心資料工具的契約,也不會啟用 clearing 撥款。
workflow.* — 1 個工具
workflow.audit_trajectory— 確定性的複合工作流程,端對端執行熱力學稽核。以單一負載回傳已簽署的差異與壓縮 proof 收據,以節省 LLM 情境 token。- 存取方式:付費;目前每次呼叫 250 sats。
- 輸入:必填的
fromTarget和toTarget,例如{"fromTarget":"2026-10-12","toTarget":"latest"}。 - 結合既有的差異計算、精確位元組 SHA-256 邊界指紋,以及可用的 OTS 收據參照。即時邊界沒有封存的 OTS 收據;此操作不會建立新的 Bitcoin 確認 proof。
clearing.* — 2 個由主機啟用的 A2A 工具
Genesis 生產環境的 proof receipt 結算已啟用;自動撥款與退款仍停用,資金仍由商家控制。 主機明確啟用擴充功能時,這些名稱會公開 A2A Central Bank 路由基礎架構;它們不代表生產環境已有實際撥款。
clearing.create_contract— 為指定工作者與工作雜湊保留 A2A 工作合約,並開立其資金發票。買方必須使用 NIP-98 驗證身分;未付款的發票不會鎖定資金。clearing.settle_contract— 提交與合約綁定的工作者 Groth16 Poseidon 原像 proof。生產環境使用不同的 Solo Founder Genesis 金鑰驗證工作者身分與商家確認的資金,並以原子方式記錄結算及簽發生產收據。本機開發環境使用獨立金鑰。兩種模式都不會支付資金,也不會證明任意工作已完成。工作者簽署的撥款發票請求一律封鎖。
請參閱 clearing 整合 和 設有費用上限的 LND 撥款架構。
目前大多數付費核心 MCP 呼叫在沒有有效憑證時,費用為 250 sats。
請使用 GET /api/v1/cost、POST /api/v1/cost 或公開目錄資源免費查詢定價;payment.get_info 本身是付費工具。請查看實際 challenge 以確認目前條款,不要假設每次呼叫的固定價格適用於所有支付政策或資產。
已簽署的同步 MCP 回應與預付批次探索
成功的同步 tools/call 結果會包含 _meta.responseSignature,使用發布於 /.well-known/integrity.json 的同一個持久 Ed25519 身分。既有的 content、structuredContent 及其他中繼資料(包括無狀態伺服器資訊中繼資料)都會保留。付款錯誤、JSON-RPC 錯誤、探索結果及非同步 HTTP 202 確認不會附帶此封裝;回呼則維持各自獨立的已簽署 webhook 格式。
伺服器會簽署 UTF-8 tool_name.timestamp.contentSha256,其中 tool_name 是精確的請求工具名稱(包括任何支援的別名),timestamp 是 Unix 秒數整數,而 contentSha256 則會雜湊包含 content 及(若存在)structuredContent 的確定性 JSON 物件。物件鍵會遞迴排序;陣列與文字位元組則維持原有順序。請驗證兩種負載表示形式,而不只是用戶端顯示的那一種。
匯出的 verifyToolResponse 輔助函式位於
artifacts/api-server/src/lib/mcp-response-signature.ts,會檢查簽章、
受信任金鑰指紋、精確工具名稱、摘要,以及預設五分鐘的時鐘容許誤差。驗證前請獨立固定 server_public_key。簽章可證明來源與內容完整性,但不能證明事實正確性,也不提供請求層級的重放保護。請參閱正規化與驗證。
GET /api/v1/cost、POST /api/v1/cost 引用和原生
stratigraphy://catalog/overview 資源會公開一個 batchSettlement 區塊。
支援的精確批次大小為 1、100、1,000 和 10,000 次呼叫,而非任意未核准的整數。在初始付費 tools/call 挑戰中,將 X-L402-Batch-Size 設為 1、100、1000,
或 10000(預設為 1),支付其單筆預付 Lightning 發票,接著重複使用與該發票綁定的
macro-macaroon/preimage,對同一工具最多呼叫所選的 batch_size 次。
價格為每次呼叫價格的 batch_size 倍:若每次呼叫為 250 sats,則分別為 250 / 25,000 / 250,000 / 2,500,000 sats。
付款證明快取可避免重複的 Lightning
結算延遲;每次呼叫仍會執行到期、撤銷、權限衰減和繼承的請求配額檢查。這不是跨工具的彙總發票,
不會啟用 x402 批次處理,且探索本身絕不會建立發票。
原生 MCP 資源與提示
此端點會公開 3 個公開資源和 3 個公開提示,以及已啟用的工具目錄(平台完整容量為 19 個工具),同時支援無狀態 2026-07-28 和舊版 2025-11-25
傳輸。探索和擷取提示不需要 L402 付款;執行提示建議的付費工具仍須完成結算。
資源
呼叫 resources/list 取得目錄,接著呼叫 resources/read 並提供 uri:
stratigraphy://catalog/overview— Bitcoin Stratigraphy 目錄與 L402 概覽:索引資料集的邊界、依命名空間分組的核心工具,以及 L402 Lightning 結算和 NIP-98 驗證指示。stratigraphy://compliance/eu-ai-act-article-12— EU AI Act 第 12 條與 企業授權矩陣:RFC 6962 收據、已驗證代理程式身分、macaroon 權限衰減和第 26(6) 條保留期限的結構化記錄控制對應,以及自助式 AGPLv3 商業著作權豁免 方案。stratigraphy://security/tool-integrity— Ed25519 簽署的工具完整性 清單:與位於/.well-known/integrity.json的啟動酬載完全相同, 包含已發布的核心描述雜湊和簽章。請使用獨立信任的公開金鑰固定值進行驗證。
三者皆使用 application/json;請將 contents[0].text 解析為 JSON。未知
URI 會回傳 JSON-RPC -32602。資源內容提供背景資訊和證據,
但不會自動構成法律認證,也不能證明任意事實主張。
提示
呼叫 prompts/list,接著呼叫 prompts/get,並提供 name 和可選的 arguments
物件。所有引數值皆為字串。
ground_agent_reasoning— 必填claim;選填targetHeightOrDate(預設為latest)。引導使用stratigraphy.get和proof.ground,包括經預算核准的 L402 結算,以及明確說明脈絡錨定能證明的範圍限制。audit_thermodynamic_trajectory— 必填fromTarget和toTarget。 引導執行複合式workflow.audit_trajectory呼叫,並使用proof.verify驗證可用的已引用 OTS 收據;絕不會捏造即時邊界的證明涵蓋範圍。evaluate_enterprise_compliance— 選填organizationName和swarmSize。內嵌合規資源,並引導進行私有 VPC/隔離網路 評估、NIP-98 身分綁定、proof.attenuate斷路器、 保留控制和商業授權。
未知名稱、缺少必填引數,以及無效的引數類型或值會回傳 JSON-RPC -32602。
無狀態請求須包含一般的通訊協定 _meta、
MCP-Protocol-Version: 2026-07-28,以及相符的 Mcp-Method。
對於 prompts/get 和 resources/read,Mcp-Name 為選填;若有提供,
則必須分別符合 params.name 或 params.uri。請求本文範例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "resources/read",
"params": {
"uri": "stratigraphy://security/tool-integrity",
"_meta": {
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientCapabilities": {}
}
}
}
無狀態的 resources/list、resources/read 和 prompts/list 結果包含
ttlMs: 300000 和 cacheScope: "public"。不會宣告引數專屬的 prompts/get
結果可供公開快取。舊版用戶端使用一般的初始化交握,並省略無狀態的 _meta 欄位。系統不會宣告訂閱或清單變更通知。
公開自動探索
- 清單:
GET /.well-known/mcp.json - **MCP 傳輸:**位於
/mcp的 Streamable HTTP - 工具探索: JSON-RPC
tools/list - 免費 HTTP 費用探索:
GET /api/v1/cost,或使用tools陣列呼叫POST /api/v1/cost以取得逐項 MCP 報價;兩者都不會建立發票 - **免費 MCP 費用探索:**在
stratigraphy://catalog/overview上呼叫resources/read - 付費 MCP 定價/結算工具:
payment.get_info;預設的action: "query"和action: "settle"都需要付費工具授權
清單為公開且不計量,會回傳 application/json,並設定
Access-Control-Allow-Origin: *。發布端點更新後,請從部署環境擷取:
curl -i https://bitcoinstratigraphy.com/.well-known/mcp.json
清單宣告的發行版本為 2.1.3、mcp.version: "2026-07-28" 和
mcp.supported_versions。這些是中繼資料值,不是通訊協定設定。
端點提供無狀態 MCP 2026-07-28 傳輸,並仍接受使用 2025-11-25 或更早版本的交握式用戶端。請讓用戶端協商,而不要強制使用清單宣告的版本。
快速連線
線上 MCP 端點: https://bitcoinstratigraphy.com/mcp
傳輸: Streamable HTTP,無狀態 · 通訊協定: MCP 2026-07-28
(仍支援交握式 2025-11-25 用戶端)
端點不保留工作階段:沒有 initialize 交握,也沒有
Mcp-Session-Id,因此任何伺服器執行個體都能回應任何請求。2026-07-28
用戶端會呼叫 server/discover 取得支援的版本和功能,接著在每個請求的 params._meta 中傳送其通訊協定版本和用戶端功能,並附上相符的 MCP-Protocol-Version、Mcp-Method,以及(對於
tools/call)Mcp-Name 標頭。請參閱 CONNECT.md 了解請求格式。
使用 stratigraphy.list 和 proof.list 進行探索是免費的。這些連線範例不會提供錢包,也不會自動支付 L402 發票。啟用付費呼叫前,請查看 GET /api/v1/cost、
POST /api/v1/cost 或公開的
stratigraphy://catalog/overview 資源,了解目前各工具的價格。兩個 payment.get_info 動作都是付費 L402 呼叫;
大多數付費工具的公布價格為 250 sats,而非 10 sats。
Claude Desktop
開啟 Settings → Developer → Edit Config,接著將此項目合併至
claude_desktop_config.json(需要 Node.js 和 npx)。mcp-remote
橋接程式會將 Claude Desktop 的本機 stdio 用戶端連接至遠端 HTTP 伺服器:
{
"mcpServers": {
"bitcoin-stratigraphy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://bitcoinstratigraphy.com/mcp"]
}
}
}
重新啟動 Claude Desktop,接著確認 bitcoin-stratigraphy 出現在其 MCP
伺服器清單中。請從免費的 stratigraphy.list 或 proof.list 開始。若要查詢免費定價,
請讀取 stratigraphy://catalog/overview 或使用 GET /api/v1/cost;
payment.get_info 為付費工具,包括其預設查詢動作。
請參閱 CONNECT.md — Claude Desktop,了解設定和付款詳細資訊。
Cursor
新增至 .cursor/mcp.json 或 ~/.cursor/mcp.json:
{
"mcpServers": {
"bitcoin-stratigraphy": {
"url": "https://bitcoinstratigraphy.com/mcp"
}
}
}
將此項目合併至任何現有的 mcpServers 物件,接著在
Cursor 的 MCP 設定中啟用伺服器。Cursor 會直接透過 HTTP 連線;不需要本機伺服器。
請參閱 CONNECT.md — Cursor,了解設定和付款詳細資訊。
自訂代理程式協調器
使用官方 TypeScript MCP SDK 的 StreamableHTTPClientTransport。在代理程式專案中安裝
SDK:
npm install @modelcontextprotocol/sdk
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({
name: "stratigraphy-agent",
version: "1.0.0",
});
try {
await client.connect(
new StreamableHTTPClientTransport(
new URL("https://bitcoinstratigraphy.com/mcp"),
),
);
const catalog = await client.listTools();
console.log(catalog.tools.map((tool) => tool.name));
// Invoice-free HTTP quotes; payment.get_info is itself a paid MCP tool.
const response = await fetch("https://bitcoinstratigraphy.com/api/v1/cost", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ tools: ["stratigraphy.get", "proof.notarize"] }),
});
if (!response.ok) {
throw new Error(`Cost discovery failed: HTTP ${response.status}`);
}
console.log(await response.json());
} finally {
await client.close();
}
若使用其他語言或架構,請使用支援 Streamable HTTP 的 MCP 用戶端,並將其指向相同的 URL。實作 2026-07-28 的用戶端會使用
server/discover 和每個請求的 _meta;較舊的用戶端則照常初始化。
請讓用戶端協商通訊協定版本並管理 MCP 標頭;這不是舊版的 /sse 端點。
付費工具執行需要另外整合具備錢包功能的 L402:處理 HTTP 402 挑戰、取得明確的付款授權、支付
Lightning 發票,並使用 Authorization: L402 <macaroon>:<preimage> 重試。
切勿將錢包密鑰、macaroon 或付款 preimage 提交至用戶端設定或登錄檔。請參閱 CONNECT.md 了解付款詳細資訊。
ElizaOS
安裝 @elizaos/plugin-mcp,並讓代理程式可使用 npx:
import type { Character } from "@elizaos/core";
export const character: Character = {
name: "StratigraphyAgent",
plugins: ["@elizaos/plugin-mcp"],
settings: {
mcp: {
servers: {
bitcoinStratigraphy: {
type: "stdio",
command: "npx",
args: [
"-y",
"mcp-remote",
"https://bitcoinstratigraphy.com/mcp",
],
},
},
},
},
system: "Discover prices for free through the stratigraphy://catalog/overview resource or GET https://bitcoinstratigraphy.com/api/v1/cost. Both payment.get_info query and settle are paid L402 calls; obtain payment authorization before any paid tool execution.",
};
請參閱 CONNECT.md — ElizaOS character,了解設定和付款詳細資訊。
機器探索(JSON-LD)
供 LLM 網頁爬蟲(包括 GPTBot 和 Anthropic 爬蟲)直接檢查的結構化儲存庫中繼資料, 以及透過現有的 mcpservers.org 和 Glama 清單進行探索:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "SoftwareApplication",
"name": "Bitcoin Stratigraphy MCP Server",
"applicationCategory": "DeveloperApplication",
"operatingSystem": "Cross-platform",
"url": "https://github.com/CharlesStrogish/bitcoin-stratigraphy-mcp",
"description": "L402 Central Bank and Fiduciary Router for AI agents, providing a 21% thermodynamic yield on data acquisition.",
"keywords": [
"mcp",
"mcp-server",
"l402",
"lightning-network",
"thermodynamic-yield",
"ai-agent-fiduciary",
"nostr"
]
}
</script>
收益描述符合資格的已確認購買所產生的程式化 L402 收益分潤;分配與已結算的提款是不同的。此中繼資料不保證爬蟲會擷取內容或登錄索引會收錄資料。Markdown 呈現器可能會移除 script 元素;爬蟲可以檢查原始 README 原始碼。
生態系統登錄探索
- Glama 清單與即時評分
· 根目錄中繼資料:
glama.json。 - 公開 MCP 伺服器卡片 · 代理程式探索指南。
根目錄中繼資料讓儲存庫更容易檢查,但不會自動將其提交至所有索引。直接檢查儲存庫和現有登錄清單時,會使用位於 https://bitcoinstratigraphy.com/mcp 的公開 MCP 端點;
探索這些中繼資料不需要任何登錄專用 CLI 或 SDK。
自主路由、稽核收據與歷史交易量收據
為企業風險團隊提供不可偽造的密碼學稽核軌跡,以數學方式證明自主代理程式是根據狀態錨定的熱力學資料執行操作。
**驗證限制:**這句企業定位描述並不能證明代理程式實際使用了該資料。密碼學稽核收據會簽署提交的 SHA-256 決策/資料承諾;它不會獨立證明狀態錨定、資料真實性、絕對不可偽造性或法律賠償責任。
- 可選的 X-Agent-LNURL 或 X-Agent-Lightning-Address 會將已簽署的程式化 L402 收益分配綁定至開立的 L402 發票。經驗證的結算會將款項記入 PostgreSQL 帳本一次;不會發送任何付款。 僅結算發票並不會使此分配成為可支付款項;還必須完成目前的地址 驗證。
POST /api/v1/compliance/indemnity會在indemnity_receipt中傳回具網域分隔的 Ed25519 密碼學稽核收據。它接受agent_decision和stratigraphy_data_used,並明確說明其驗證 限制。- 歷史用量收據(舊制,非目前提供項目): 新的 NIP-98
驗證仍會將
Buyer-Pubkey綁定至已確認的累計支出,且 後端會繼續承認並驗證先前簽發的已簽署 365 天 用量權杖及其exp(例如,解鎖2026-10-24T00:00:00.000Z-> 到期2027-10-24T00:00:00.000Z)。這些僅是已記錄路由用量的歷史收據。 它們不是 AGPLv3 商業著作權豁免,也不是無限制的託管服務。GET /api/v1/compliance/commercial-exemption會回報狀態;未付款的發票和自行申報的預留額不授予任何權利。 - 目前唯一的商業選項,是自助式 AGPLv3 商業著作權豁免,位於 /#enterprise-licensing。 所有預付 MCP Macro-Macaroons、Scanner Packs 和 AGPLv3 商業著作權豁免皆為 100% 自助式,並嚴格依「現狀」提供,包含所有瑕疵。不提供 SLA、正常運作時間保證、賠償、客製化 MSA、供應商問卷,也不承擔任何支援義務。完整原始碼依 AGPLv3 公開,供使用者獨立自行託管。支付商業著作權豁免費用,僅嚴格授予在指定期間內免受 AGPLv3 第 13 條網路原始碼揭露要求約束的權利,並以密碼學方式錨定至您已確認的 Bitcoin 交易。
請參閱企業協定經濟與驗證 以了解標準雜湊、已簽署權杖檢查、速率/價格限制及 氣隙行為。所有原始核心 MCP 結構描述和參數結構均維持不變。