AgentReady Woo

xyz.utilityhousePublished by utilityhouse.xyzOfficial publisherv1.2.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

A remote MCP server that audits public WooCommerce storefronts for shopping-agent readiness and runs owner-authorized release gates.

What you can do
Scan a public WooCommerce storefront for agent readiness, returning a score and fix recommendations, or an explicit unreadable state instead of a fabricated score. Run a read-only preflight over selected protocol families (WooCommerce, robots, JSON-LD, MCP, UCP, ACP) before a specific update or release, with per-family PASS, FAIL, BLOCKED or UNMEASURED results. Start, read and claim an owner-authorized Release Gate run fed by signed, aggregate-only plugin evidence.
When to use it
Use it when you want to check whether a public WooCommerce storefront is readable by shopping agents, or to get protocol-family evidence before or after a WooCommerce release. The owner-authorized gate tools are only relevant to verified store owners with a scoped bearer token.
Requirements
A remote endpoint reached over streamable HTTP; no local runtime or package is needed. The public scan and preflight tools need only the store's HTTPS origin. The three Release Gate tools require a scoped bearer token and verified store ownership. The public endpoint is rate-limited to three calls per target origin and ten calls per calling IP per day.
Before you install
The Release Gate tools require a bearer token with release scopes; keep it private. The README states the tools do not create orders, reserve inventory, send customer email or handle payment credentials, and that the action changes nothing on the store. Diagnostic accuracy against real merchant stores is unmeasured, and Release Gate settlement is disabled. A separate authenticated commerce surface with read-only WooCommerce credentials is a different product contract.

Installation

In SourceWeft

  1. Open AgentReady Woo in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/xyz.utilityhouse%2Fagentready-woo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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.

Source: README.md at commit 3a5c2a2

Tools

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.

Parametersdemostore_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.

Parametersstore_originrequiredrequested_families

start_woo_release_verification

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

Parametersmoderequiredstore_idrequiredbaseline_run_ididempotency_keyrequiredrequested_familiesrequired

get_woo_release_verification

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

Parametersrun_idrequired

claim_woo_release_result

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

Parametersrun_idrequired

Version history

1
  1. v1.2.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Utilityhouse integrations