Read-only OpenAPI facade for the public WordPress and WooCommerce Store API endpoints exposed by Kunst in Kaart, with local SQLite caching and MCP tool registration
12 tools with consistent naming (verb_noun pattern: wc_get-*, wc_list-*) and explicit schemas. All tools have descriptions (avg 120 chars) and input parameters with types. However, descriptions are minimal and lack actionable context for LLM selection. Parameter descriptions are generic ('Id', 'Search') without format constraints, ranges, or dependency hints. No output schema documentation visible. Error handling and recovery guidance absent. Tool annotations (readOnlyHint, destructiveHint, openWorldHint) present but underutilized.
Get a WooCommerce product attribute by ID. Required: id. Returns the WcGetProductAttributeResponse.
Get a WooCommerce product brand by ID or slug. Required: identifier. Returns the WcGetProductBrandResponse.
Get a WooCommerce product category by ID. Required: id. Returns the Category.
Get collection metadata such as price range and counts. Optional: search, category. Returns the WcGetProductCollectionDataResponse.
Get a WooCommerce storefront product by ID. Required: id. Returns the Product.
List terms for a WooCommerce product attribute. Required: attribute_id. Optional: search, per_page (default: 10), page (default: 1). Returns array of WcListProductAttributeTermsItem.
Parameter descriptions are generic placeholders ('Id', 'Search', 'Per page') without format constraints, ranges, or actionable guidance. LLMs cannot infer valid values or constraints.
No output schema documentation visible. Tool descriptions mention return types (e.g., 'Returns the WcGetProductAttributeResponse') but actual response field structures are not documented. LLMs cannot plan downstream tool calls or extract required fields.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
List WooCommerce product attributes. Returns array of WcListProductAttributesItem.
List WooCommerce product brands. Optional: search, per_page (default: 10), page (default: 1). Returns array of WcListProductBrandsItem.
List WooCommerce product categories. Optional: search, parent, hide_empty (plus 4 more). Returns array of Category.
List public WooCommerce product reviews. Optional: product_id, per_page (default: 10), page (default: 1). Returns array of WcListProductReviewsItem.
List WooCommerce product tags. Optional: search, per_page (default: 10), page (default: 1). Returns array of WcListProductTagsItem.
Search and list WooCommerce storefront products. Optional: search, category, tag (plus 8 more). Returns array of Product.
Pagination parameters (per_page, page) lack documented defaults, ranges, and maximum limits. LLMs may pass invalid values (e.g., per_page=10000) causing API failures or context window exhaustion.
No error handling or recovery guidance documented. Tool descriptions do not explain what happens on invalid input, missing resources, or API failures. LLMs have no guidance on retry logic or fallback strategies.
Tool descriptions lack context for LLM selection. Descriptions are minimal (avg 120 chars) and do not explain WHEN to use each tool vs. similar alternatives (e.g., when to call wc_get-store-product vs. wc_list-products with filters).