SuperCatch

Find cards in my store

supercatch_search_listings

Read-onlyIdempotent

Find seller-owned card copies by text, exact SKU, catalog ID, grader/grade, status, USD asking-price range and on-hand stock. A stock filter tests unsold on-hand counts before checkout holds; returned availability subtracts holds. Live cursor pages use a stable created-at/ID order and must retain the same filters and page size. Ambiguous matches remain separate candidates. Use supercatch_search_listings for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires a currently approved owned store. Prices exclude shipping and tax. Graded and raw copies remain distinct; estimates and asks are not sold transactions. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "grade": "10",
      "query": "Topps",
      "grading_company": "PSA"
    },
    "name": "supercatch_search_listings"
  }
}

Input Schema

Name	Required	Description
`sku`	No	Exact seller SKU. Case and spelling match the stored SKU.
`grade`	No	Exact numeric slab grade as a string; requires a supported grading_company and preserves half grades.
`limit`	No	Maximum rows in this live page; keep the same value when continuing its cursor.
`query`	No	Card title/subject search words; all words must match the owned copy or its catalog subject.
`stock`	No	Filters unsold on-hand quantity before checkout holds. Returned available quantity additionally subtracts holds.
`cursor`	No	Opaque next_cursor from this connection's prior page. Keep store, filters and limit unchanged.
`status`	No	Exact local listing lifecycle state; this is separate from marketplace publication status.
`channel`	No	Seller dashboard's persisted channel sync-state filter. It does not perform a live provider-price probe.
`max_price`	No	Inclusive maximum USD asking price; must not be below min_price.
`min_price`	No	Inclusive minimum USD asking price, as a decimal string with at most two fractional digits; excludes shipping and tax.
`catalog_card_id`	No	Catalog identity filter. Results remain separate owned listing IDs and never authorize mutation by catalog ID.
`grading_company`	No	Stored grading company, or UNGRADED for raw copies.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 6, 2026

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "account_ref": {
-            "type": "string"
-          },
-          "app_id": {
-            "const": "supercatch",
-            "type": "string"
-          },
-          "connection_ref": {
-            "type": "string"
-          },
-          "environment": {
-            "enum": [
-              "public",
-              "production",
-              "staging",
-              "paper",
-              "sandbox"
-            ],
-            "type": "string"
-          },
-          "tenant_ref": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "timezone": {
-            "minLength": 1,
-            "type": "string"
-          }
-        },
-        "required": [
-          "app_id",
-          "tenant_ref",
-          "environment",
-          "timezone"
-        ],
-        "type": "object"
-      },
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "completeness": {
-            "enum": [
-              "complete",
-              "partial",
-              "unavailable"
-            ],
-            "type": "string"
-          },
-          "items": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "app_url": {
-                  "format": "uri",
-                  "type": "string"
-                },
-                "asking_price": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "amount": {
-                      "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
-                      "type": "string"
-                    },
-                    "currency": {
-                      "const": "USD",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "amount",
-                    "currency"
-                  ],
-                  "type": "object"
-                },
-                "card": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "autograph_status": {
-                          "enum": [
-                            "yes",
-                            "no",
-                            "unknown"
-                          ],
-                          "type": "string"
-                        },
-                        "card_number": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "catalog_card_id": {
-                          "description": "Opaque identifier returned by the authorized application; never substitute a display label or another entity's ID.",
-                          "maxLength": 128,
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "set_name": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "sport_or_game": {
-                          "type": "string"
-                        },
-                        "subject": {
-                          "type": "string"
-                        },
-                        "variation": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "year": {
-                          "anyOf": [
-                            {
-                              "maximum": 9007199254740991,
-                              "minimum": -9007199254740991,
-                              "type": "integer"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        }
-                      },
-                      "required": [
-                        "catalog_card_id",
-                        "sport_or_game",
-                        "year",
-                        "set_name",
-                        "card_number",
-                        "subject",
-                        "variation",
-                        "autograph_status"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "effective_sale_price": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "amount": {
-                          "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
-                          "type": "string"
-                        },
-                        "currency": {
-                          "const": "USD",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "amount",
-                        "currency"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "grade": {
-                  "oneOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "condition": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "kind": {
-                          "const": "raw",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "condition"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "certification_id": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "company": {
-                          "type": "string"
-                        },
-                        "grade": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "kind": {
-                          "const": "graded",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "company",
-                        "grade",
-                        "certification_id"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "image_count": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "images": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "artifact_id": {
-                        "type": "string"
-                      },
-                      "image_id": {
-                        "type": "string"
-                      },
-                      "is_primary": {
-                        "type": "boolean"
-                      }
-                    },
-                    "required": [
-                      "image_id",
-                      "artifact_id",
-                      "is_primary"
-                    ],
-                    "type": "object"
-                  },
-                  "maxItems": 4,
-                  "type": "array"
-                },
-                "inventory": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "available": {
-                      "maximum": 9007199254740991,
-                      "minimum": -9007199254740991,
-                      "type": "integer"
-                    },
-                    "basis": {
-                      "type": "string"
-                    },
-                    "observed_at": {
-                      "anyOf": [
-                        {
-                          "format": "date-time",
-                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "on_hand": {
-                      "maximum": 9007199254740991,
-                      "minimum": -9007199254740991,
-                      "type": "integer"
-                    },
-                    "reserved": {
-                      "maximum": 9007199254740991,
-                      "minimum": -9007199254740991,
-                      "type": "integer"
-                    }
-                  },
-                  "required": [
-                    "on_hand",
-                    "reserved",
-                    "available",
-                    "basis",
-                    "observed_at"
-                  ],
-                  "type": "object"
-                },
-                "lifecycle_state": {
-                  "enum": [
-                    "DRAFT",
-                    "PENDING",
-                    "PROCESSING",
-                    "ACTIVE",
-                    "SOLD",
-                    "RESERVED",
-                    "INACTIVE",
-                    "REMOVED",
-                    "REJECTED",
-                    "SHOWCASE"
-                  ],
-                  "type": "string"
-                },
-                "listing_id": {
-                  "description": "Opaque identifier returned by the authorized application; never substitute a display label or another entity's ID.",
-                  "maxLength": 128,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "sku": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "store_id": {
-                  "description": "Opaque identifier returned by the authorized application; never substitute a display label or another entity's ID.",
-                  "maxLength": 128,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                },
-                "version": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "listing_id",
-                "store_id",
-                "version",
-                "card",
-                "grade",
-                "sku",
-                "title",
-                "asking_price",
-                "effective_sale_price",
-                "inventory",
-                "lifecycle_state",
-                "image_count",
-                "images",
-                "app_url"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "omissions": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "code": {
-                  "type": "string"
-                },
-                "count": {
-                  "anyOf": [
-                    {
-                      "maximum": 9007199254740991,
-                      "minimum": 0,
-                      "type": "integer"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "reason": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "code",
-                "reason",
-                "count"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "page": {
-            "additionalProperties": false,
-            "properties": {
-              "consistency": {
-                "enum": [
-                  "snapshot",
-                  "live"
-                ],
-                "type": "string"
-              },
-              "has_more": {
-                "type": "boolean"
-              },
-              "next_cursor": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "returned_count": {
-                "maximum": 9007199254740991,
-                "minimum": 0,
-                "type": "integer"
-              },
-              "snapshot_expires_at": {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              "snapshot_id": {
-                "type": "string"
-              },
-              "total_count": {
-                "anyOf": [
-                  {
-                    "maximum": 9007199254740991,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "returned_count",
-              "total_count",
-              "has_more",
-              "next_cursor",
-              "consistency"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "items",
-          "page",
-          "completeness",
-          "omissions"
-        ],
-        "type": "object"
-      },
-      "generated_at": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-        "type": "string"
-      },
-      "kind": {
-        "const": "collection",
-        "type": "string"
-      },
-      "next_actions": {
-        "items": {
-          "oneOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "reason": {
-                  "type": "string"
-                },
-                "tool_name": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": {
-                  "const": "call_tool",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "tool_name",
-                "reason"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "reason": {
-                  "type": "string"
-                },
-                "type": {
-                  "const": "open_url",
-                  "type": "string"
-                },
-                "url": {
-                  "format": "uri",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "url",
-                "reason"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "fields": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "reason": {
-                  "type": "string"
-                },
-                "type": {
-                  "const": "provide_input",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "fields",
-                "reason"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "reason": {
-                  "type": "string"
-                },
-                "retry_after_ms": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "type": {
-                  "const": "wait",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "retry_after_ms",
-                "reason"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      },
-      "provenance": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "freshness": {
-              "enum": [
-                "fresh",
-                "stale",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "observed_at": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "retrieved_at": {
-              "format": "date-time",
-              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-              "type": "string"
-            },
-            "source_id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "source_url": {
-              "format": "uri",
-              "type": "string"
-            },
-            "source_version": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "source_id",
-            "observed_at",
-            "retrieved_at",
-            "freshness"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "request_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "schema_version": {
-        "const": "1.0.0",
-        "type": "string"
-      },
-      "warnings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "field": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "code",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "schema_version",
-      "kind",
-      "request_id",
-      "generated_at",
-      "context",
-      "data",
-      "warnings",
-      "next_actions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "account_ref": {
-            "type": "string"
-          },
-          "app_id": {
-            "const": "supercatch",
-            "type": "string"
-          },
-          "connection_ref": {
-            "type": "string"
-          },
-          "environment": {
-            "enum": [
-              "public",
-              "production",
-              "staging",
-              "paper",
-              "sandbox"
-            ],
-            "type": "string"
-          },
-          "tenant_ref": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "timezone": {
-            "minLength": 1,
-            "type": "string"
-          }
-        },
-        "required": [
-          "app_id",
-          "tenant_ref",
-          "environment",
-          "timezone"
-        ],
-        "type": "object"
-      },
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "enum": [
-              "invalid_input",
-              "unauthenticated",
-              "permission_denied",
-              "consent_required",
-              "ambiguous_target",
-              "not_found",
-              "unsupported_capability",
-              "configuration_required",
-              "integration_expired",
-              "stale_data",
-              "version_conflict",
-              "approval_required",
-              "approval_expired",
-              "idempotency_conflict",
-              "rate_limited",
-              "quota_exceeded",
-              "provider_unavailable",
-              "outcome_unknown",
-              "reconciliation_required",
-              "cursor_expired",
-              "artifact_expired",
-              "internal_error"
-            ],
-            "type": "string"
-          },
-          "domain_code": {
-            "type": "string"
-          },
-          "effects": {
-            "enum": [
-              "none",
-              "committed",
-              "partial",
-              "unknown"
-            ],
-            "type": "string"
-          },
-          "field_errors": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "field": {
-                  "type": "string"
-                },
-                "message": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "field",
-                "message"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "message": {
-            "type": "string"
-          },
-          "operation_id": {
-            "type": "string"
-          },
-          "retry_after_ms": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "retry_strategy": {
-            "enum": [
-              "never",
-              "same_request",
-              "after_delay",
-              "after_correction",
-              "reconcile_first"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message",
-          "effects",
-          "retry_strategy"
-        ],
-        "type": "object"
-      },
-      "generated_at": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-        "type": "string"
-      },
-      "kind": {
-        "const": "error",
-        "type": "string"
-      },
-      "next_actions": {
-        "items": {
-          "oneOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "reason": {
-                  "type": "string"
-                },
-                "tool_name": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": {
-                  "const": "call_tool",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "tool_name",
-                "reason"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "reason": {
-                  "type": "string"
-                },
-                "type": {
-                  "const": "open_url",
-                  "type": "string"
-                },
-                "url": {
-                  "format": "uri",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "url",
-                "reason"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "fields": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "reason": {
-                  "type": "string"
-                },
-                "type": {
-                  "const": "provide_input",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "fields",
-                "reason"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "reason": {
-                  "type": "string"
-                },
-                "retry_after_ms": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "type": {
-                  "const": "wait",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "type",
-                "retry_after_ms",
-                "reason"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      },
-      "provenance": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "freshness": {
-              "enum": [
-                "fresh",
-                "stale",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "observed_at": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "retrieved_at": {
-              "format": "date-time",
-              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-              "type": "string"
-            },
-            "source_id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "source_url": {
-              "format": "uri",
-              "type": "string"
-            },
-            "source_version": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "source_id",
-            "observed_at",
-            "retrieved_at",
-            "freshness"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "request_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "schema_version": {
-        "const": "1.0.0",
-        "type": "string"
-      },
-      "warnings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "field": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "code",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "schema_version",
-      "kind",
-      "request_id",
-      "generated_at",
-      "context",
-      "data",
-      "warnings",
-      "next_actions"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "account_ref": {
+            "type": "string"
+          },
+          "app_id": {
+            "const": "supercatch",
+            "type": "string"
+          },
+          "connection_ref": {
+            "type": "string"
+          },
+          "environment": {
+            "enum": [
+              "public",
+              "production",
+              "staging",
+              "paper",
+              "sandbox"
+            ],
+            "type": "string"
+          },
+          "tenant_ref": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "timezone": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "app_id",
+          "tenant_ref",
+          "environment",
+          "timezone"
+        ],
+        "type": "object"
+      },
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "completeness": {
+            "enum": [
+              "complete",
+              "partial",
+              "unavailable"
+            ],
+            "type": "string"
+          },
+          "items": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "app_url": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "asking_price": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "amount": {
+                      "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                      "type": "string"
+                    },
+                    "currency": {
+                      "const": "USD",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "amount",
+                    "currency"
+                  ],
+                  "type": "object"
+                },
+                "card": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "autograph_status": {
+                          "enum": [
+                            "yes",
+                            "no",
+                            "unknown"
+                          ],
+                          "type": "string"
+                        },
+                        "card_number": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "catalog_card_id": {
+                          "description": "Opaque identifier returned by the authorized application; never substitute a display label or another entity's ID.",
+                          "maxLength": 128,
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "set_name": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "sport_or_game": {
+                          "type": "string"
+                        },
+                        "subject": {
+                          "type": "string"
+                        },
+                        "subset": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "variation": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "year": {
+                          "anyOf": [
+                            {
+                              "maximum": 9007199254740991,
+                              "minimum": -9007199254740991,
+                              "type": "integer"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        }
+                      },
+                      "required": [
+                        "catalog_card_id",
+                        "sport_or_game",
+                        "year",
+                        "set_name",
+                        "card_number",
+                        "subject",
+                        "subset",
+                        "variation",
+                        "autograph_status"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "effective_sale_price": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "amount": {
+                          "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                          "type": "string"
+                        },
+                        "currency": {
+                          "const": "USD",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "amount",
+                        "currency"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "grade": {
+                  "oneOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "condition": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "kind": {
+                          "const": "raw",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "condition"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "certification_id": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "company": {
+                          "type": "string"
+                        },
+                        "grade": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "kind": {
+                          "const": "graded",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "company",
+                        "grade",
+                        "certification_id"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                },
+                "image_count": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "images": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "artifact_id": {
+                        "type": "string"
+                      },
+                      "image_id": {
+                        "type": "string"
+                      },
+                      "is_primary": {
+                        "type": "boolean"
+                      }
+                    },
+                    "required": [
+                      "image_id",
+                      "artifact_id",
+                      "is_primary"
+                    ],
+                    "type": "object"
+                  },
+                  "maxItems": 4,
+                  "type": "array"
+                },
+                "inventory": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "available": {
+                      "maximum": 9007199254740991,
+                      "minimum": -9007199254740991,
+                      "type": "integer"
+                    },
+                    "basis": {
+                      "type": "string"
+                    },
+                    "observed_at": {
+                      "anyOf": [
+                        {
+                          "format": "date-time",
+                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "on_hand": {
+                      "maximum": 9007199254740991,
+                      "minimum": -9007199254740991,
+                      "type": "integer"
+                    },
+                    "reserved": {
+                      "maximum": 9007199254740991,
+                      "minimum": -9007199254740991,
+                      "type": "integer"
+                    }
+                  },
+                  "required": [
+                    "on_hand",
+                    "reserved",
+                    "available",
+                    "basis",
+                    "observed_at"
+                  ],
+                  "type": "object"
+                },
+                "lifecycle_state": {
+                  "enum": [
+                    "DRAFT",
+                    "PENDING",
+                    "PROCESSING",
+                    "ACTIVE",
+                    "SOLD",
+                    "RESERVED",
+                    "INACTIVE",
+                    "REMOVED",
+                    "REJECTED",
+                    "SHOWCASE"
+                  ],
+                  "type": "string"
+                },
+                "listing_id": {
+                  "description": "Opaque identifier returned by the authorized application; never substitute a display label or another entity's ID.",
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "sku": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "store_id": {
+                  "description": "Opaque identifier returned by the authorized application; never substitute a display label or another entity's ID.",
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "listing_id",
+                "store_id",
+                "version",
+                "card",
+                "grade",
+                "sku",
+                "title",
+                "asking_price",
+                "effective_sale_price",
+                "inventory",
+                "lifecycle_state",
+                "image_count",
+                "images",
+                "app_url"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "omissions": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "count": {
+                  "anyOf": [
+                    {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "reason": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "code",
+                "reason",
+                "count"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "page": {
+            "additionalProperties": false,
+            "properties": {
+              "consistency": {
+                "enum": [
+                  "snapshot",
+                  "live"
+                ],
+                "type": "string"
+              },
+              "has_more": {
+                "type": "boolean"
+              },
+              "next_cursor": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "returned_count": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "snapshot_expires_at": {
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                "type": "string"
+              },
+              "snapshot_id": {
+                "type": "string"
+              },
+              "total_count": {
+                "anyOf": [
+                  {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "returned_count",
+              "total_count",
+              "has_more",
+              "next_cursor",
+              "consistency"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "items",
+          "page",
+          "completeness",
+          "omissions"
+        ],
+        "type": "object"
+      },
+      "generated_at": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+        "type": "string"
+      },
+      "kind": {
+        "const": "collection",
+        "type": "string"
+      },
+      "next_actions": {
+        "items": {
+          "oneOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "reason": {
+                  "type": "string"
+                },
+                "tool_name": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": {
+                  "const": "call_tool",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "tool_name",
+                "reason"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "reason": {
+                  "type": "string"
+                },
+                "type": {
+                  "const": "open_url",
+                  "type": "string"
+                },
+                "url": {
+                  "format": "uri",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "url",
+                "reason"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "fields": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "reason": {
+                  "type": "string"
+                },
+                "type": {
+                  "const": "provide_input",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "fields",
+                "reason"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "reason": {
+                  "type": "string"
+                },
+                "retry_after_ms": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "type": {
+                  "const": "wait",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "retry_after_ms",
+                "reason"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      "provenance": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "freshness": {
+              "enum": [
+                "fresh",
+                "stale",
+                "unknown"
+              ],
+              "type": "string"
+            },
+            "observed_at": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "retrieved_at": {
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+              "type": "string"
+            },
+            "source_id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "source_url": {
+              "format": "uri",
+              "type": "string"
+            },
+            "source_version": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "source_id",
+            "observed_at",
+            "retrieved_at",
+            "freshness"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "request_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "schema_version": {
+        "const": "1.0.0",
+        "type": "string"
+      },
+      "warnings": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "field": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "schema_version",
+      "kind",
+      "request_id",
+      "generated_at",
+      "context",
+      "data",
+      "warnings",
+      "next_actions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "account_ref": {
+            "type": "string"
+          },
+          "app_id": {
+            "const": "supercatch",
+            "type": "string"
+          },
+          "connection_ref": {
+            "type": "string"
+          },
+          "environment": {
+            "enum": [
+              "public",
+              "production",
+              "staging",
+              "paper",
+              "sandbox"
+            ],
+            "type": "string"
+          },
+          "tenant_ref": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "timezone": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "app_id",
+          "tenant_ref",
+          "environment",
+          "timezone"
+        ],
+        "type": "object"
+      },
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "invalid_input",
+              "unauthenticated",
+              "permission_denied",
+              "consent_required",
+              "ambiguous_target",
+              "not_found",
+              "unsupported_capability",
+              "configuration_required",
+              "integration_expired",
+              "stale_data",
+              "version_conflict",
+              "approval_required",
+              "approval_expired",
+              "idempotency_conflict",
+              "rate_limited",
+              "quota_exceeded",
+              "provider_unavailable",
+              "outcome_unknown",
+              "reconciliation_required",
+              "cursor_expired",
+              "artifact_expired",
+              "internal_error"
+            ],
+            "type": "string"
+          },
+          "domain_code": {
+            "type": "string"
+          },
+          "effects": {
+            "enum": [
+              "none",
+              "committed",
+              "partial",
+              "unknown"
+            ],
+            "type": "string"
+          },
+          "field_errors": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "field": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "field",
+                "message"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "message": {
+            "type": "string"
+          },
+          "operation_id": {
+            "type": "string"
+          },
+          "retry_after_ms": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "retry_strategy": {
+            "enum": [
+              "never",
+              "same_request",
+              "after_delay",
+              "after_correction",
+              "reconcile_first"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "effects",
+          "retry_strategy"
+        ],
+        "type": "object"
+      },
+      "generated_at": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+        "type": "string"
+      },
+      "kind": {
+        "const": "error",
+        "type": "string"
+      },
+      "next_actions": {
+        "items": {
+          "oneOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "reason": {
+                  "type": "string"
+                },
+                "tool_name": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": {
+                  "const": "call_tool",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "tool_name",
+                "reason"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "reason": {
+                  "type": "string"
+                },
+                "type": {
+                  "const": "open_url",
+                  "type": "string"
+                },
+                "url": {
+                  "format": "uri",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "url",
+                "reason"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "fields": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "reason": {
+                  "type": "string"
+                },
+                "type": {
+                  "const": "provide_input",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "fields",
+                "reason"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "reason": {
+                  "type": "string"
+                },
+                "retry_after_ms": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "type": {
+                  "const": "wait",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "retry_after_ms",
+                "reason"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      "provenance": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "freshness": {
+              "enum": [
+                "fresh",
+                "stale",
+                "unknown"
+              ],
+              "type": "string"
+            },
+            "observed_at": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "retrieved_at": {
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+              "type": "string"
+            },
+            "source_id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "source_url": {
+              "format": "uri",
+              "type": "string"
+            },
+            "source_version": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "source_id",
+            "observed_at",
+            "retrieved_at",
+            "freshness"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "request_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "schema_version": {
+        "const": "1.0.0",
+        "type": "string"
+      },
+      "warnings": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "field": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "schema_version",
+      "kind",
+      "request_id",
+      "generated_at",
+      "context",
+      "data",
+      "warnings",
+      "next_actions"
+    ],
+    "type": "object"
+  }
+]

AddedNov 5, 2026

TDQS

A4/5.0

Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds real context beyond that: the stock filter tests pre-hold counts while returned availability subtracts holds, ambiguous matches stay separate, pages use stable created-at/ID ordering, cursors expire, and the return envelope is Baseline 1.0.0 with typed errors. It does not detail rate limits or exact error codes, so a 4 rather than a 5.

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

Conciseness3/5

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

The core functionality and cursor rules are front-loaded, but the description then lists a long series of disclaimers (no prices, inventory, orders, automation, marketplace publication or provider configuration changed) and repeated caveats about estimates, raw versus graded copies, and failures. These earn some place as scope boundaries, yet the passage is denser than needed for a read tool whose annotations already signal safety.

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

Completeness4/5

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

With 12 parameters, 4 enums, an output schema and full annotation coverage, the description supplies the missing context: OAuth scope, approved-store requirement, cursor expiry, stable sort order, and price excluding shipping/tax. It is nearly complete; only explicit pagination defaults and error taxonomy detail are left to the schema and envelope.

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 description coverage is 100% and every parameter already carries a precise description, including enums and patterns. The description mostly restates the filter set at a high level (price range, grader/grade, stock, status) without adding syntax or interaction details beyond the schema. Baseline 3 applies when the schema does the heavy lifting.

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 ('Find') plus the resource ('seller-owned card copies') and enumerates the exact filter dimensions: text, SKU, catalog ID, grader/grade, status, price range and stock. This distinguishes it clearly from siblings like list_store_listings and search_marketplace, which are not seller-scoped copy searches.

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

Usage Guidelines4/5

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

Gives a clear operating context ('Use supercatch_search_listings for this read in the connected account') and implied preconditions (approved owned store, OAuth store:read). It also notes cursor continuation rules. It does not explicitly name when to use a sibling instead, so it stops short of a 5.

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

All SuperCatch tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?