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 分

    请在仓库或注册中心条目中声明许可证。