ThoughtProof

io.github.ThoughtProof由 GitHub 帳號 ThoughtProof 發布v0.3.2更新於 Nov 10, 2026

Pre-action gate: verify before pay/trade/write/deploy. execute=true only on ALLOW.

發布方自己的服務:Proof Holdings

概覽

AI 產生的概覽

本機 stdio MCP 伺服器,讓 AI 代理在付款、交易、寫入或部署前驗證擬執行的動作,並回傳失敗即拒絕的 execute 旗標。

可以做什麼
  • 在執行前驗證擬執行動作:提交目標、擬執行動作與推理,取得裁決、異議與回執,並自動路由到支出或不可逆操作檢查
  • 依指定風險等級、領域與深度驗證陳述及 AI 產生的推理
  • 查詢 ERC-8004 登錄中代理的綜合信任分數
  • 為交易類代理提供選用的執行前檢核
  • 回傳固定結構的結果,僅在裁決為 ALLOW 時 execute 才為 true
適用情境
當代理即將執行有後果的動作(花錢、結帳、發布、刪除、部署或寫入記憶)時,可在其行動前加入一次獨立檢核。也適合查核陳述與推理,或查詢代理信任分數。
執行需求
需要 Node.js 18+ 以及本機 stdio MCP 用戶端(如 Claude Desktop、Cursor、Windsurf、Cline),透過 npx 執行。預設 verify_decision 路徑需要 DQL_API_KEY;當 mode=sentinel 或自動路由選到 Sentinel 時需要 SENTINEL_API_KEY;THOUGHTPROOF_API_KEY 是 verify_claim、verify_trade 與 Sentinel 備援所用的營運金鑰。金鑰需向服務商定價頁面取得,並需要連線至服務商 API 的網路存取。
安裝前請注意
需要付費的服務商 API 金鑰(DQL_API_KEY、SENTINEL_API_KEY、THOUGHTPROOF_API_KEY),且不得提交到程式碼儲存庫。提交的目標、擬執行動作、推理與上下文會傳送到服務商 API。失敗即拒絕是軟性的:工具回傳 execute=false,但不會強制阻止宿主,用戶端必須自行遵守。缺少 Sentinel 金鑰時回傳 execute=false,而不會退回 DQL。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ThoughtProof,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

thoughtproof-mcp

[npm version] [CI] [HOL Guard Scanner] [HOL Verified] [License: MIT]

thoughtproof-mcp — local stdio. Hero tool verify_decision (DQL spend / Sentinel irreversible exit). execute is true only on ALLOW. Sentinel ALLOW must match a verified signed export.

MCP server for ThoughtProof — pre-execution decision verification for AI agents.

Hero tool: verify_decision. It routes inside the tool to DQL (spend / checkout) or Sentinel (irreversible exit) and returns a fail-closed execute flag. execute is true only on a native ALLOW.

This package is a local stdio MCP server (Node 18+) for Desktop / CLI hosts such as Cursor, Claude Desktop, Windsurf, and Cline. It is not a remote HTTP MCP server. It is not a Grok Web/Mobile custom connector.

Get keys at https://app.thoughtproof.ai/pricing.

Unpublished work is documented in UNRELEASED.md.

Quick Start

json
{  "mcpServers": {    "thoughtproof": {      "command": "npx",      "args": ["-y", "[email protected]"],      "env": {        "DQL_API_KEY": "<YOUR_DQL_VERIFY_KEY>"      }    }  }}

Install with npx -y [email protected]. Works with Claude Desktop, Cursor, Windsurf, Cline, and other local stdio MCP clients.

Tools

verify_before_action / verify_decision (hero)

verify_before_action is an alias of verify_decision (identical schema + handler). Soft fail-closed: host must honor execute=false.

Pre-execution gate for a proposed action. Routing is inside the tool — not an agent quiz.

ParameterTypeDefaultDescription
mandatestring(required)User's stated goal / instruction
proposed_actionstring(required)What the agent is about to do
reasoningstring(required)The agent's own plan / reasoning
contextstring(optional)Extra evidence
modedql / sentinel / autoautoExplicit surface, or auto-route

Auto-route: spend / checkout / booking / purchase / payment / cart / Stripe / price / budget / cap → DQL. High-blast irreversible exit without that language (publish, delete, deploy, send-to-prod, memory write) → Sentinel. Unsure → DQL. Explicit mode wins. RV / PLV are not on this path.

Camera mandate: do not put the overshoot in proposed_action or reasoning (for example, do not write “price is above the cap”). The verifier has to find the mismatch.

Envelope (always this shape):

json
{  "verdict": "ALLOW",  "execute": true,  "objections": [],  "receipt_id": "dql_…",  "surface": "dql",  "axes": [],  "recommendation": "execute"}

execute is true only on ALLOW. REVIEW, UNCERTAIN, BLOCK, timeouts, HTTP 402/4xx/5xx, and missing keys return execute: false. Fail-closed is soft at the protocol layer — the tool does not hard-stop the host. Replan is a new call (new receipt).

verify_claim

Verify any claim or AI-generated reasoning via RV (POST /v1/check). Unchanged.

ParameterTypeDefaultDescription
claimstring(required)The text to verify
stakeLevellow / medium / high / criticalmediumRisk level — higher stakes trigger deeper verification
domainfinancial / medical / legal / code / generalgeneralDomain context for specialized verification
speedfast / standard / deepstandardVerification depth

check_agent_score

Look up an agent's composite trust score on the ERC-8004 registry.

ParameterTypeDescription
agentIdstringAgent ID to look up
domainstringOptional domain filter

verify_trade

Optional pre-execution gate for trading agents (Sentinel → RV). Not the default verify_decision path. See VERIFY_TRADE.md.

Configuration

Environment VariableDefaultDescription
DQL_API_KEY(none)DQL key (dqlk_…) for the default verify_decision path. Alias: THOUGHTPROOF_DQL_KEY
SENTINEL_API_KEY(none)Optional. Required only when mode=sentinel or auto-route picks Sentinel. Fallback: THOUGHTPROOF_API_KEY as X-Sentinel-Key
DQL_SANDBOX(off)Set to 1 to send sandbox: true on DQL calls (local/dev only)
THOUGHTPROOF_API_KEY(none)Operator key for verify_claim / verify_trade / Sentinel fallback
THOUGHTPROOF_BASE_URLhttps://api.thoughtproof.aiRV API base URL (verify_claim)

A missing Sentinel key returns execute: false with “Sentinel key not configured” — it does not silently call DQL.

Development

bash
git clone https://github.com/ThoughtProof/thoughtproof-mcp.gitcd thoughtproof-mcpnpm installnpm run buildnpm testnpm run dev          # Run with tsx (hot reload)npm run inspect      # Test with MCP Inspector

For local MCP clients, point command at node and args at dist/index.js after npm run build.

Security

See SECURITY.md for supported versions, private reporting ([email protected]), and key handling (dqlk_… for MCP hero — never commit real keys).

HOL listing / Guard scanner score is a review baseline only. It is not next-action authorization and not a substitute for fail-closed host behavior (execute: true only on ALLOW).

Related

  • ThoughtProof — Decision verification for AI agents
  • pot-cli — CLI for reasoning verification
  • ERC-8004 — Autonomous Agent Registry

License

MIT — ThoughtProof

來源:README.md,提交 cb7a6c6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.3.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Proof 整合