Agent Commerce Guard

io.github.fxjim由 GitHub 帳號 fxjim 發布v1.2.0更新於 Oct 24, 2026

Policy review and purchase discovery for AI-agent commerce actions.

已驗證Streamable HTTP可網頁執行安全與監控商業與電商

概覽

AI 產生的概覽

遠端 MCP 伺服器,可審查最多五個公開的 AI 代理商務動作,回傳核准與證據要求,本身不執行任何動作。

可以做什麼
  • 審查最多五個非敏感的公開代理動作(錢包支出、正式環境部署、代幣發行、市集任務),回傳決策與所需證據
  • 回傳去識別化的政策決策,不回顯送出的動作文字
  • 透過公開 JSON 資源檢視供應商的付費方案,與政策結果分開
  • 使用「購買前審查」提示,串接政策審查、方案檢視、明確核准與收據驗證,且不發起付款
適用情境
當助理即將執行與商務相關的動作,例如從錢包支出、部署到正式環境、發行代幣或公開發文時,可用它做政策預檢,判斷應阻擋、升級處理或憑證據核准。它只是唯讀的諮詢性檢查,並非強制執行機制。
執行需求
需要一個遠端 Streamable HTTP 端點;未宣告任何套件、帳號、API 金鑰或環境變數。用戶端需能透過網路存取該託管服務。
安裝前請注意
只應送出公開、非敏感的動作清單;README 明確警告不要傳送密鑰、私有原始碼、憑證或客戶資料。此伺服器同時是銷售管道:其資源、提示與示範回應會推廣售價 1 USDC(Base 鏈)的付費包,README 也描述錢包結帳與交易驗證流程。任何付款步驟都應要求人工明確核准。

安裝

在 SourceWeft 中

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

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.fxjim%2Fagent-commerce-guard/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "agent-commerce-guard": {
      "type": "http",
      "url": "https://agent-commerce-guard.vercel.app/api/mcp"
    }
  }
}

README

Agent Commerce Guard

Approval gates and receipts for AI agents that can spend money, sell services, post socially, launch tokens, deploy publicly, or touch wallets.

Agent Commerce Guard is a local-first CLI and skill pack for builders adding x402, ACP, wallets, seller runtimes, paid APIs, or social integrations to autonomous agents.

[Agent Commerce Guard preview]

[GitHub Action smoke] [Agent Skills installs]

Try the free evaluator | Preview the paid package | Add the GitHub Action | Buy the private package for 1 USDC | Get support

The live evaluator includes one-click presets for wallet spend, production deploys, token launches, and marketplace jobs, so each decision path can be tested without writing a manifest first.

Free hosted preflightPrivate local package
Best forPublic CI action manifestsPrivate or sensitive agent workflows
ExecutionHosted evaluator, up to 5 actions / 20 KBLocal CLI, HTTP evaluator, skills, policies, and templates
PriceFree1 USDC on Base

The checkout links to the full sample report, Base MCP purchase recipe, and support before payment, then verifies the Base USDC transaction server-side. Both the checkout and success handoff retry pending receipts automatically before the private package unlocks. A submitted transaction hash is preserved in the current URL so a refresh resumes verification instead of losing the unlock path.

The public package proof shows the exact CLI report format and file inventory before payment. Canonical tests compare the samples to the current policy engine and verify each advertised file against the paid tarball:

Install The Free Evaluator Skill

Install a non-executing preflight workflow for public, non-sensitive action manifests:

bash
npx skills add https://github.com/fxjim/agent-commerce-guard --skill try-agent-commerce-guard

The skill enforces the hosted-data boundary, evaluates at most five actions and 20 KB through the free endpoint, and hands private workflows to the paid local package without initiating a payment.

GitHub Copilot Plugin

Install the policy-only review plugin directly from GitHub:

bash
copilot plugin install fxjim/agent-commerce-guard:plugins/agent-commerce-guard

The plugin's skill uses /api/policy-review, returns only decisions and required evidence, and includes no checkout or payment links. Its immutable 1.0.0 source is tagged copilot-plugin-v1.0.0. The official Awesome Copilot review is ready for review after passing its automated quality gates.

Remote MCP Server

Connect an MCP client to the public, stateless Streamable HTTP endpoint:

text
https://agent-commerce-guard.vercel.app/api/mcp

Codex:

bash
codex mcp add agent-commerce-guard --url https://agent-commerce-guard.vercel.app/api/mcp

Claude Code:

bash
claude mcp add --transport http agent-commerce-guard https://agent-commerce-guard.vercel.app/api/mcp

VS Code mcp.json:

json
{  "servers": {    "agent-commerce-guard": {      "type": "http",      "url": "https://agent-commerce-guard.vercel.app/api/mcp"    }  }}

Setup and verification: Vercel guide or GitHub Pages mirror.

The server exposes one read-only, non-destructive tool, review_agent_commerce_actions. It accepts up to five non-sensitive public actions and 20 KB, returns decisions and required evidence, and does not execute, pay, sign, deploy, post, or include purchase instructions in tool output. MCP 1.2.0 also exposes one public JSON resource, https://agent-commerce-guard.vercel.app/offer.json, so clients can discover the exact 1 USDC Base offer without mixing purchase data into policy-tool results. Server initialization points clients to that resource, requires explicit approval before payment, and requires Base transaction verification after payment. The review-before-purchase prompt joins policy review, offer inspection, explicit approval, and receipt verification without initiating a payment. Registry metadata is available in server.json. The official Registry lists io.github.fxjim/agent-commerce-guard as an active remote server.

Install The Buyer Skill

Install the free public buyer workflow for Codex, Claude Code, Cursor, and other Agent Skills-compatible assistants:

bash
npx skills add https://github.com/fxjim/agent-commerce-guard --skill buy-agent-commerce-guard

The same skill is also available from the canonical product domain:

bash
npx skills add https://agent-commerce-guard.vercel.app --skill buy-agent-commerce-guard

The skill preflights the public offer and requires explicit approval before any Base Account, Base MCP, x402, browser-wallet, or manual payment. Its source is available at skills/buy-agent-commerce-guard/SKILL.md. Its indexed directory page is available on skills.sh. The paid product package remains available only after a verified 1 USDC payment.

GitHub Action

Run the free hosted policy preflight in an ubuntu-latest workflow:

yaml
- uses: fxjim/agent-commerce-guard@v1  with:    manifest: agent-commerce-actions.json    fail-on: deny

The manifest may be a single action, an action array, or an object with an actions array. The Action sends at most five actions and 20 KB to the public hosted evaluator, prints sanitized decisions, and can fail on denied actions or actions requiring review. It rejects obvious secret-bearing JSON keys before the request.

The Action exposes checkout-url for the private local package, x402-evaluate-url for the paid workflow API, sample-report-url for the full CLI example, package-metadata-url for the machine-readable inventory, and base-mcp-recipe-url for an authorized Base MCP assistant. The job summary links to the proof and purchase paths after every completed evaluation.

Do not submit secrets, private source, credentials, or sensitive customer data. Use the paid local package when an action manifest cannot leave the runner. See examples/github-actions/ for a complete workflow and harmless example manifest.

Launch Pass

The launch pass is available for 1 USDC on Base.

What It Includes

  • CLI policy engine.
  • Agent skill pack for Codex, Claude, and OpenClaw-style workflows.
  • Approval log and launch checklist templates.
  • Action manifest examples.
  • Local HTTP evaluator.
  • Vercel-gated download flow.
  • Hosted demo endpoint that returns sanitized decisions without echoing submitted action text.
  • One-click hosted demo presets for wallet spend, production deploys, token launches, and marketplace jobs.
  • Free evaluator skill for non-sensitive action manifests with an explicit local-package handoff.
  • Free GitHub Action for CI policy preflight with local secret-key rejection and configurable failure behavior.
  • Demo responses include paid purchase metadata and exact x402 next-action commands.
  • Agent/plugin manifests for coding-agent, OpenAPI, x402, and LLM discovery.
  • Copy-paste purchase guides for x402 agents and manual Base buyers.
  • Machine-readable Base USDC payment request with an EIP-681 transfer URI.
  • Machine-readable payment metadata advertises both /verify?tx={tx} and /success?tx={tx} as post-payment unlock pages.
  • Product-specific Base MCP purchase recipe with exact chain, token, receiver, amount, and explicit approval constraints.
  • Free installable buyer skill with preflight, approval, verification, and unlock steps.
  • Scan-to-pay SVG QR for mobile wallet payment.
  • Homepage buyer-command section with exact x402 inspect/pay commands and copy buttons.
  • Social preview image wired into OG/Twitter/schema metadata.
  • Structured Product/SoftwareApplication metadata on the live homepage for search and crawler discovery.
  • IndexNow key route and refreshed submitted URL batch for faster search discovery.
  • Pinned GitHub launch/support issue for buyer questions and x402 integration notes.
  • Public GitHub launch discussion for product context and buyer discovery.
  • GitHub Pages launch page for search and buyer discovery.
  • Public GitHub Gist buyer brief with exact Base/x402 purchase commands.
  • GitHub Pages agent-readable mirrors for llms.txt, agents.json, agent.json, offer.json, .well-known/agent-commerce-guard.json, .well-known/offer.json, openapi.json, .well-known/openapi.json, .well-known/ai-plugin.json, package-metadata.json, .well-known/package-metadata.json, status.json, .well-known/status.json, .well-known/x402, .well-known/agents.json, .well-known/agent.json, .well-known/purchase.json, pay/, robots.txt, and sitemap.xml.
  • OpenAPI 3.1 spec for paid and demo endpoints.
  • x402 paid package endpoint for agent-native purchase on Base mainnet.
  • x402 paid evaluation endpoint for agent-native policy decisions over POSTed action manifests.
  • Discovery metadata for agent workflow validation, command-risk scoring, destructive-action review, and wallet-spend approval.
  • x402 Bazaar metadata tags: agent-commerce, agent-safety, guardrails, approval-gates, codex, x402.

Why It Exists

Agent commerce is moving faster than agent governance. This tool blocks or escalates actions that cross financial, production, social, token, or credential boundaries until there is explicit evidence and approval.

Agent Buyer Flow

  1. Read https://agent-commerce-guard.vercel.app/offer.json.
  2. Open https://agent-commerce-guard.vercel.app/pay and use the official Base Account control to review and confirm 1 USDC on Base mainnet.
  3. Or load https://agent-commerce-guard.vercel.app/base-mcp.json in an authorized Base MCP assistant, read https://agent-commerce-guard.vercel.app/pay.json for the exact manual Base payment request, or scan https://agent-commerce-guard.vercel.app/qr.
  4. Verify the transaction at /verify?tx={tx}, /success?tx={tx}, or /api/base-payment-status?tx={tx}. Both browser pages automatically retry a pending Base receipt and resume from the URL after a refresh.
  5. Download the package from /success?tx={tx} or /api/base-download?tx={tx}.

Agent buyers can also call https://agent-commerce-guard.vercel.app/api/x402-download directly and satisfy the returned x402 payment requirement.

Agent workflows can call POST https://agent-commerce-guard.vercel.app/api/x402-evaluate and satisfy the returned x402 payment requirement to receive a sanitized policy decision.

The x402 endpoints return Base-mainnet exact payment requirements for 1000000 atomic USDC and include route-level Bazaar metadata for agent discovery.

Purchase questions, wallet-flow issues, and x402 integration notes can go in the pinned launch/support issue: https://github.com/fxjim/agent-commerce-guard/issues/1.

Launch context and buyer discovery thread: https://github.com/fxjim/agent-commerce-guard/discussions/2.

來源:README.md,提交 305b342

工具

1

review_agent_commerce_actions

Review agent commerce actions

Review up to five non-sensitive public AI-agent actions for approval and evidence requirements. This tool does not execute, pay, sign, deploy, post, or reveal purchase instructions.

輸入參數actions必填

版本歷史

1
  1. v1.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。