AgentReady Woo

xyz.utilityhouse由 utilityhouse.xyz 发布官方发布者v1.2.0更新于 Oct 24, 2026

Check WooCommerce agent readiness and run owner-authorized release gates.

已验证Streamable HTTP可网页运行开发者工具商业与电商

概览

AI 生成的概览

一个远程 MCP 服务器,用于检查公开 WooCommerce 店铺对购物智能体的就绪程度,并运行店主授权的发布门禁。

可以做什么
扫描公开 WooCommerce 店铺的智能体就绪情况,返回评分与修复建议;无法读取时明确返回不可读状态,而不是编造低分。在特定更新或发布前,对选定协议族(WooCommerce、robots、JSON-LD、MCP、UCP、ACP)执行只读预检,按协议族返回 PASS、FAIL、BLOCKED 或 UNMEASURED。启动、读取并领取由签名且仅含汇总数据的插件证据支撑的店主授权发布门禁运行。
适用场景
当你需要确认某个公开 WooCommerce 店铺能否被购物智能体读取,或在 WooCommerce 发布前后获取协议族证据时使用。店主授权的门禁工具仅适用于持有受限 bearer 令牌的已验证店主。
运行要求
通过 streamable HTTP 访问的远程端点,无需本地运行时或安装包。公开扫描与预检工具只需店铺的 HTTPS 源地址。三个发布门禁工具需要受限 bearer 令牌和已验证的店铺所有权。公开端点限流为每个目标源每天三次、每个调用 IP 每天十次。
安装前请注意
发布门禁工具需要带 release 权限范围的 bearer 令牌,请妥善保密。README 说明这些工具不会创建订单、预留库存、发送客户邮件或处理支付凭据,且该操作不会改动店铺。针对真实商家店铺的诊断准确性尚未测量,发布门禁结算功能已停用。另有一个需认证、使用只读 WooCommerce 凭据的独立商务接口,属于不同的产品约定。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentReady Woo,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/xyz.utilityhouse%2Fagentready-woo/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "agentready-woo": {
      "type": "http",
      "url": "https://app.utilityhouse.xyz/mcp"
    }
  }
}

README

AgentReady Woo — WooCommerce Release Gate

[UtilityHouse Release Gate checks the agent-facing WooCommerce surface before a release ships]

Verify the agent-facing WooCommerce surface after a release—without touching orders, checkout or payment credentials.

Run the free public preflight or add the dependency-free Node 24 action to a deployment workflow. It fails CI only on an explicit HOLD by default; BLOCKED, UNMEASURED and UNREADABLE remain visible abstentions.

yaml
- name: AgentReady Woo preflight  uses: tytutueh13-sudo/agentready-woo@v1  with:    store-origin: https://shop.example

What the release check gives you

  • One read-only public preflight for WooCommerce, robots, JSON-LD, MCP, UCP and ACP surfaces.
  • A finite decision and unknown-reason list instead of a padded readiness score.
  • An optional owner-authorized gate fed by signed, aggregate-only WordPress evidence.
  • No order creation, inventory reservation, checkout mutation or payment access.

Live service: app.utilityhouse.xyz

AgentReady runs a passive public preflight, then lets a verified store owner make a version-pinned release decision from signed plugin evidence. A target that cannot be read returns an abstention rather than a fabricated low score.

This is not a certification, ranking promise or checkout test. The root tools do not create orders, reserve inventory, send customer email or handle payment credentials.

Public MCP tools

POST https://app.utilityhouse.xyz/mcp speaks MCP JSON-RPC 2.0 and advertises five tools. Always use tools/list as the authoritative schema.

ToolUse it for
scan_woo_store_readinessA general public-store audit, score and fix list
preflight_woo_storeProtocol-family evidence for a specific update or release

Three additional tools start, read and claim an owner-authorized Release Gate run. They require a scoped bearer token and verified store ownership.

The general scanner returns state: UNREADABLE with score: null when it cannot read the target. Diagnostic accuracy against real merchant stores is unmeasured. Release Gate settlement is disabled.

GitHub Action

The repository includes a dependency-free Node 24 action. It calls the same public preflight contract, writes a reason-coded job summary and fails only on an explicit HOLD. BLOCKED and UNMEASURED remain abstentions.

Add families: woo,robots,jsonld,mcp when the workflow should check only those four protocol families.

The public endpoint allows three calls per target origin per day and ten calls per calling IP per day. The action changes nothing on the store.

WordPress plugin

wordpress-plugin/utilityhouse-release-gate-for-woocommerce is version 1.2.1. It provides a useful local readiness snapshot before connection. Activation neither contacts UtilityHouse nor creates a schedule. An administrator must make a one-time manual send or separately opt in to a daily signed aggregate evidence schedule.

The evidence envelope contains version identifiers, opaque store/run fields, timestamps, nonce, family name and aggregate check state/count. It contains no customer, order, payment, email, address, product description, URL, credential or raw log field.

Build the deterministic plugin package with:

bash
npm run build:plugin

Try the local-only snapshot without touching a real store in the version-pinned WordPress Playground demo. The disposable site configures no UtilityHouse endpoint and sends no evidence.

REST preflight

POST https://app.utilityhouse.xyz/api/v2/preflight is documented in mcp-registry/openapi-preflight.yaml. HTTP 200 does not necessarily mean the target was measurable; inspect the returned state and per-family checks.

Separate commerce surface

An authenticated account may connect read-only WooCommerce credentials to a store-bound catalog, offer and signed cart-handoff surface at /mcp/{store_id}. That is a separate product contract and does not grant Release Gate access. Checkout and payment remain on the merchant's store.

Development

bash
npm installnpm run typechecknpm testnpm run test:wordpress

This public repository is a review mirror, not the production deployment source. Its wrangler.toml carries a placeholder database id. Deployment is performed from the private monorepo.

License scope

  • action.yml and action/** are licensed under the MIT License in action/LICENSE.
  • wordpress-plugin/utilityhouse-release-gate-for-woocommerce/** is licensed GPL-2.0-or-later as declared in the plugin header and readme.txt.
  • No license is granted for the remaining server, test, deployment or mirror files unless a file or subtree states one explicitly. Those files remain all rights reserved.

The scoped licenses do not apply to the hosted AgentReady service, its data, trademarks or private deployment configuration.

来源:README.md,提交 3a5c2a2

工具

5

scan_woo_store_readiness

Use ONLY for a general storefront audit, readiness score, or fix recommendations. Do NOT use it to inspect a specific update or release; use preflight_woo_store for that. Check whether a public WooCommerce storefront is readable by shopping agents. Provide the store's HTTPS origin. The tool reads only public pages and the public WooCommerce Store API, changes nothing, and returns aggregate checks and recommendations without product text or customer data. When the storefront cannot be read at all, the tool abstains: state is UNREADABLE, score and grade are null, and the caller must not present that as a finding about the store.

输入参数demostore_url

preflight_woo_store

Use ONLY before a specific WooCommerce update or release when you need protocol-family evidence. Do NOT use it for a general score or fix list; use scan_woo_store_readiness for that. Inspect selected public WooCommerce and agent-protocol surfaces and return per-family PASS, FAIL, BLOCKED or UNMEASURED evidence. It changes nothing, is free, and BLOCKED or UNMEASURED is an abstention rather than a finding about the store.

输入参数store_origin必填requested_families

start_woo_release_verification

Start an ownership-authorized Release Gate run. Requires a bearer token with release:start.

输入参数mode必填store_id必填baseline_run_ididempotency_key必填requested_families必填

get_woo_release_verification

Get a Release Gate run owned by the bearer token account. Requires release:read.

输入参数run_id必填

claim_woo_release_result

Claim a completed Release Gate result once. Requires release:claim; replay is never billable.

输入参数run_id必填

版本历史

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

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

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

其他 Utilityhouse 集成