Skip to main content
Glama

Store Readiness Audit

muse_agentic_store_readiness_auditor
Read-only

Audit a public store domain for agent-readable readiness: machine-readable product data, UCP/ACP discovery, payment hints, robots.txt access, heuristic score, and prioritized fixes.

Instructions

Returns structured public evidence and explicit unknowns. Store audit for shopping agents: machine-readable product data, UCP/ACP discovery, payment hints and robots.txt access, with a heuristic score and prioritized fixes. Not a certification or checkout test. $0.01 per result. Use to diagnose agent-readable store discovery and prioritize fixes; use universal_product_url_to_json for one product or pre_purchase_merchant_trust_check for purchase-risk evidence. Does not modify the store.

Input Schema

NameRequiredDescriptionDefault
domainYesPublic domain without scheme, path or port.
contextNoOptional. A few words on why you are calling this tool. Recorded without your identity to improve the tools; leave out personal data.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changedv1.0.0
    • addedInput schema / properties / context
      Added value: +{
      +  "description": "Optional. A few words on why you are calling this tool. Recorded without your identity to improve the tools; leave out personal data.",
      +  "type": "string"
      +}
    • changedInput schema / properties / domain / examples
      Previous value: -[
      -  "example.com"
      -]New value: +[
      +  "allbirds.com"
      +]
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "description": "Only status=ok is charged. Diagnostic results may omit result fields; unknown facts are null.",
      +    "properties": {
      +      "bot_access": {
      +        "additionalProperties": {
      +          "properties": {
      +            "home_allowed": {
      +              "type": "boolean"
      +            },
      +            "sample_product_allowed": {
      +              "type": "boolean"
      +            }
      +          },
      +          "required": [
      +            "home_allowed",
      +            "sample_product_allowed"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "object"
      +      },
      +      "discovery": {
      +        "additionalProperties": {
      +          "properties": {
      +            "http_status": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "valid": {
      +              "type": "boolean"
      +            },
      +            "validation": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "http_status",
      +            "valid",
      +            "validation"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "object"
      +      },
      +      "domain": {
      +        "type": "string"
      +      },
      +      "error_reason": {
      +        "type": "string"
      +      },
      +      "fixes": {
      +        "items": {
      +          "properties": {
      +            "action": {
      +              "type": "string"
      +            },
      +            "check": {
      +              "type": "string"
      +            },
      +            "priority": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "priority",
      +            "check",
      +            "action"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "payment_hints": {
      +        "properties": {
      +          "paypal": {
      +            "type": "boolean"
      +          },
      +          "shop_pay": {
      +            "type": "boolean"
      +          },
      +          "stripe_link": {
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "stripe_link",
      +          "shop_pay",
      +          "paypal"
      +        ],
      +        "type": "object"
      +      },
      +      "product": {
      +        "properties": {
      +          "agentic_checkout_supported": {
      +            "properties": {
      +              "paypal": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "shop_pay": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "stripe_link": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "ucp": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "ucp",
      +              "stripe_link",
      +              "shop_pay",
      +              "paypal"
      +            ],
      +            "type": "object"
      +          },
      +          "aggregate_rating": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "brand": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "checkout_hints": {
      +            "properties": {
      +              "paypal": {
      +                "type": "boolean"
      +              },
      +              "shop_pay": {
      +                "type": "boolean"
      +              },
      +              "stripe_link": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "stripe_link",
      +              "shop_pay",
      +              "paypal"
      +            ],
      +            "type": "object"
      +          },
      +          "currency": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "extraction_source": {
      +            "type": "string"
      +          },
      +          "in_stock": {
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "limitations": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "price": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "return_policy": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "review_count": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "shipping_summary": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "structured_fields": {
      +            "properties": {
      +              "aggregateRating": {
      +                "type": "boolean"
      +              },
      +              "availability": {
      +                "type": "boolean"
      +              },
      +              "hasMerchantReturnPolicy": {
      +                "type": "boolean"
      +              },
      +              "offers": {
      +                "type": "boolean"
      +              },
      +              "price": {
      +                "type": "boolean"
      +              },
      +              "product_json_ld": {
      +                "type": "boolean"
      +              },
      +              "shippingDetails": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "product_json_ld",
      +              "offers",
      +              "price",
      +              "availability",
      +              "shippingDetails",
      +              "hasMerchantReturnPolicy",
      +              "aggregateRating"
      +            ],
      +            "type": "object"
      +          },
      +          "title": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "url": {
      +            "type": "string"
      +          },
      +          "variants": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "url",
      +          "title",
      +          "brand",
      +          "price",
      +          "currency",
      +          "in_stock",
      +          "variants",
      +          "aggregate_rating",
      +          "review_count",
      +          "shipping_summary",
      +          "return_policy",
      +          "agentic_checkout_supported",
      +          "checkout_hints",
      +          "structured_fields",
      +          "extraction_source",
      +          "limitations"
      +        ],
      +        "type": "object"
      +      },
      +      "readiness_score": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "sample_product_url": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "enum": [
      +          "ok",
      +          "no_data",
      +          "unreachable"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "domain",
      +      "status"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "code": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "status": {
      +        "maximum": 599,
      +        "minimum": 400,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "code"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / description
      Removed value: -"Only status=ok is charged. Diagnostic results may omit result fields; unknown facts are null."
    • removedOutput schema / properties
      Removed value: -{
      -  "bot_access": {
      -    "additionalProperties": {
      -      "properties": {
      -        "home_allowed": {
      -          "type": "boolean"
      -        },
      -        "sample_product_allowed": {
      -          "type": "boolean"
      -        }
      -      },
      -      "required": [
      -        "home_allowed",
      -        "sample_product_allowed"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "object"
      -  },
      -  "discovery": {
      -    "additionalProperties": {
      -      "properties": {
      -        "http_status": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "valid": {
      -          "type": "boolean"
      -        },
      -        "validation": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "http_status",
      -        "valid",
      -        "validation"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "object"
      -  },
      -  "domain": {
      -    "type": "string"
      -  },
      -  "error_reason": {
      -    "type": "string"
      -  },
      -  "fixes": {
      -    "items": {
      -      "properties": {
      -        "action": {
      -          "type": "string"
      -        },
      -        "check": {
      -          "type": "string"
      -        },
      -        "priority": {
      -          "type": "integer"
      -        }
      -      },
      -      "required": [
      -        "priority",
      -        "check",
      -        "action"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "limitations": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "payment_hints": {
      -    "properties": {
      -      "paypal": {
      -        "type": "boolean"
      -      },
      -      "shop_pay": {
      -        "type": "boolean"
      -      },
      -      "stripe_link": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "stripe_link",
      -      "shop_pay",
      -      "paypal"
      -    ],
      -    "type": "object"
      -  },
      -  "product": {
      -    "properties": {
      -      "agentic_checkout_supported": {
      -        "properties": {
      -          "paypal": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "shop_pay": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "stripe_link": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          },
      -          "ucp": {
      -            "type": [
      -              "boolean",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "ucp",
      -          "stripe_link",
      -          "shop_pay",
      -          "paypal"
      -        ],
      -        "type": "object"
      -      },
      -      "aggregate_rating": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "brand": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "checkout_hints": {
      -        "properties": {
      -          "paypal": {
      -            "type": "boolean"
      -          },
      -          "shop_pay": {
      -            "type": "boolean"
      -          },
      -          "stripe_link": {
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "stripe_link",
      -          "shop_pay",
      -          "paypal"
      -        ],
      -        "type": "object"
      -      },
      -      "currency": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "extraction_source": {
      -        "type": "string"
      -      },
      -      "in_stock": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "price": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "return_policy": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "review_count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "shipping_summary": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "structured_fields": {
      -        "properties": {
      -          "aggregateRating": {
      -            "type": "boolean"
      -          },
      -          "availability": {
      -            "type": "boolean"
      -          },
      -          "hasMerchantReturnPolicy": {
      -            "type": "boolean"
      -          },
      -          "offers": {
      -            "type": "boolean"
      -          },
      -          "price": {
      -            "type": "boolean"
      -          },
      -          "product_json_ld": {
      -            "type": "boolean"
      -          },
      -          "shippingDetails": {
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "product_json_ld",
      -          "offers",
      -          "price",
      -          "availability",
      -          "shippingDetails",
      -          "hasMerchantReturnPolicy",
      -          "aggregateRating"
      -        ],
      -        "type": "object"
      -      },
      -      "title": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "url": {
      -        "type": "string"
      -      },
      -      "variants": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "url",
      -      "title",
      -      "brand",
      -      "price",
      -      "currency",
      -      "in_stock",
      -      "variants",
      -      "aggregate_rating",
      -      "review_count",
      -      "shipping_summary",
      -      "return_policy",
      -      "agentic_checkout_supported",
      -      "checkout_hints",
      -      "structured_fields",
      -      "extraction_source",
      -      "limitations"
      -    ],
      -    "type": "object"
      -  },
      -  "readiness_score": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "sample_product_url": {
      -    "type": "string"
      -  },
      -  "status": {
      -    "enum": [
      -      "ok",
      -      "no_data",
      -      "unreachable"
      -    ],
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "domain",
      -  "status"
      -]
  2. First observedv0.1.0

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint and openWorldHint, and the description adds material context beyond them: cost ('$0.01 per result'), the non-mutating guarantee ('Does not modify the store'), the heuristic (not authoritative) nature of the score, and that unknowns are surfaced explicitly. That is exactly the kind of pricing and confidence disclosure annotations cannot carry.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with scope and outputs, then alternatives, then exclusions, with no filler. Dense but every clause carries information; the opening 'Returns structured public evidence and explicit unknowns' is the only mildly abstract sentence before the concrete list arrives.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return shape needn't be described, and annotations cover safety. With both parameters documented at 100% coverage and the description adding cost, scope, and sibling routing, an agent has everything needed to call this correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the domain parameter is fully documented ('Public domain without scheme, path or port'), so the schema does the heavy lifting. The description adds no format or constraint detail beyond what the schema already states, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Store audit for shopping agents') and enumerates the concrete signals checked: machine-readable product data, UCP/ACP discovery, payment hints, robots.txt, plus a heuristic score and prioritized fixes. An agent can separate this from siblings like agentic_shelf_schema_comparator without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes the agent: 'Use to diagnose agent-readable store discovery and prioritize fixes; use universal_product_url_to_json for one product or pre_purchase_merchant_trust_check for purchase-risk evidence.' It also carves out what it is not ('Not a certification or checkout test'), covering both when-to-use and when-not.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.