Postcept

io.github.Postcept由 GitHub 帳號 Postcept 發布v0.3.3更新於 Oct 24, 2026

Verify agent actions against the system of record and get signed completion receipts.

已驗證STDIO僅桌面開發者工具商業與電商

概覽

AI 產生的概覽

Postcept MCP 讓助理核實退款、取消訂閱、工單處理等高風險動作是否真的完成，並取得簽章回執。

可以做什麼
核實退款、訂閱取消與支援工單狀態是否與紀錄系統一致，每項檢查可選用沙箱測試模式。依編號取得過去的核實紀錄及其簽章回執。將過去的核實紀錄重新對照即時紀錄系統進行複核。讀取組織的已驗證完成率。
適用情境
適用於代理執行退款、取消訂閱或工單處理等有後果的動作，且需要可查核的完成證明時，特別適合開發、展示，以及已信任代理判斷的工作流程。
執行需求
透過 npx 以 stdio 程序在本機執行（需要 Node.js）。需要具備 verifications:write 權限的 Postcept API 金鑰，透過環境變數 POSTCEPT_API_KEY 提供。可選的 POSTCEPT_BASE_URL 可指向自架或預備環境 API；需要能連線至 Postcept API 的網路。
安裝前請注意
API 金鑰屬機密資訊，透過 POSTCEPT_API_KEY 傳入。核實屬建議性質：代理可以略過呼叫、傳錯識別碼或忽略結果，因此有後果的決定應在代理之外強制執行。核實據稱對紀錄系統為唯讀，但伺服器會將核實請求送往 Postcept API。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@postcept/mcp

A Model Context Protocol server that exposes Postcept, outcome verification for AI agents, as MCP tools.

After an agent performs a high-risk action (a refund, a subscription cancellation, a support-ticket resolution), it calls a verify_* tool to confirm the action actually completed in the system of record (Stripe, Zendesk, and more) and obtain a signed completion receipt. "done" becomes proof, not a claim.

The server is a thin wrapper over the live Postcept HTTP API. It holds no credentials of its own beyond your Postcept API key, and verification is read-only against your systems of record.

Configuration

VariableRequiredDefaultNotes
POSTCEPT_API_KEYyesnoneA Postcept API key (pcpt_sk_...) with verifications:write.
POSTCEPT_BASE_URLnohttps://api.postcept.comPoint at a self-hosted or staging API.

Create an API key in the Postcept dashboard under API keys.

Use with Claude Desktop / Claude Code

json
{  "mcpServers": {    "postcept": {      "command": "npx",      "args": ["-y", "@postcept/mcp"],      "env": { "POSTCEPT_API_KEY": "pcpt_sk_..." }    }  }}

Tools

ToolPurpose
verify_refundVerify a claimed refund (exists, amount/currency/customer match, not duplicated).
verify_cancellationVerify a subscription was actually cancelled.
verify_ticketVerify a support ticket is in the expected state.
get_verificationFetch a past verification and its signed receipt by id.
reconcile_verificationRe-verify a past verification against the live system of record.
verified_completion_rateRead the organization's Verified Completion Rate.

Every verify_* tool accepts test: true to run against the deterministic sandbox connector (excluded from your Verified Completion Rate), so an agent can exercise the full flow without a live system of record.

A non-verified result (incomplete, duplicated, mismatched, policy_failed) means the work is not done. Surface the gap and recover.

Advisory, by design

MCP puts the verification call in the agent's hands, which makes it the right integration for development, demos, and workflows where the agent's judgment is already trusted. It is advisory: an agent can skip the call, pass the wrong identifiers, or ignore the answer.

For consequential actions, enforce the decision outside the agent. The workflow or orchestrator calls the Postcept API (or the SDK's guard()) itself and branches on safe_to_claim_complete before anything customer-facing happens. The agent then receives the allowed outcome instead of deciding it. Both patterns use the same API and the same receipts, what changes is who owns the branch.

Development

bash
pnpm --filter @postcept/mcp build       # compile to dist/pnpm --filter @postcept/mcp typecheckPOSTCEPT_API_KEY=pcpt_sk_... node dist/index.js   # stdio server

來源：README.md，提交 7089af4

工具

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

版本歷史

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

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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