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 整合