Skip to main content
Glama

Which suppliers fit a shop

supplier_guide
Read-onlyIdempotent

Use this when a seller is choosing a supplier for a product type (t-shirts, hoodies, mugs, wall art, stickers or phone cases) and their shop: where buyers are, the platform, whether they need custom branding, want to start free, or want to choose their print provider. Returns suppliers that fit, that need a check, and that don't, each with dated reasons and sources, plus a delivered price range for an example product. No AI ranking.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "supplier_guide"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoHow many results to return.
offsetNoHow many results to skip. Pass nextOffset from the previous page.
destinationNoThe buyer's country, where the order ships. Product cost, shipping and duty depend on it.US
productTypeNoWhat the seller wants to sell.t-shirts
salesChannelNoWhere the seller sells. Leave out if they haven't decided.
shopLocationNoThe country the seller's shop is based in, for platform fees. Leave out if they haven't said.
wantsFreeStartNoThe seller wants to start without a monthly fee.
needsCustomBrandingNoThe seller wants their own branding on packaging, labels or inserts.
wantsToChooseProviderNoThe seller wants to pick the print provider that makes each order.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / destination / description
      Previous value: -"Where the buyer lives: US, GB, DE, CA or AU."New value: +"The buyer's country, where the order ships. Product cost, shipping and duty depend on it."
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "deliveredRange": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "currency": {
      -                "description": "The currency of this range.",
      -                "enum": [
      -                  "USD",
      -                  "EUR",
      -                  "GBP",
      -                  "AUD",
      -                  "CAD"
      -                ],
      -                "type": "string"
      -              },
      -              "maximum": {
      -                "description": "The highest delivered price, in this currency.",
      -                "type": "number"
      -              },
      -              "minimum": {
      -                "description": "The lowest delivered price, in this currency.",
      -                "type": "number"
      -              }
      -            },
      -            "required": [
      -              "minimum",
      -              "maximum",
      -              "currency"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The delivered price range across the suppliers that fit; null when unavailable."
      -      },
      -      "destination": {
      -        "description": "Where the buyer lives: US, GB, DE, CA or AU.",
      -        "enum": [
      -          "US",
      -          "GB",
      -          "DE",
      -          "AU",
      -          "CA"
      -        ],
      -        "type": "string"
      -      },
      -      "doesNotFit": {
      -        "additionalProperties": false,
      -        "description": "Suppliers that do not fit.",
      -        "properties": {
      -          "items": {
      -            "description": "One supplier each.",
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "description": "The supplier's name.",
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "description": "Why it fits, needs a check or does not fit.",
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "When it was checked, as an ISO date-time; null when unknown."
      -                      },
      -                      "detail": {
      -                        "description": "What the supplier states about it.",
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "description": "The condition, such as monthly fee.",
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "description": "What the source is, such as the supplier's pricing page.",
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "description": "The source page itself.",
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "Where the answer comes from; null when there is no source."
      -                      },
      -                      "status": {
      -                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "description": "The supplier's id.",
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Offset to pass for the next page; null on the last page."
      -          },
      -          "totalCount": {
      -            "description": "How many results match in total, across every page.",
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "exampleProduct": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "canonicalProductId": {
      -                "description": "The example product's id, to pass to compare_product.",
      -                "type": "string"
      -              },
      -              "name": {
      -                "description": "The example product's name.",
      -                "type": "string"
      -              },
      -              "option": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "The configuration the prices refer to; null when none."
      -              },
      -              "url": {
      -                "description": "The example product's comparison page on POD Benchmark.",
      -                "format": "uri",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "canonicalProductId",
      -              "name",
      -              "option",
      -              "url"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The product the delivered prices refer to; null when none."
      -      },
      -      "fits": {
      -        "additionalProperties": false,
      -        "description": "Suppliers that fit the shop.",
      -        "properties": {
      -          "items": {
      -            "description": "One supplier each.",
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "description": "The supplier's name.",
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "description": "Why it fits, needs a check or does not fit.",
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "When it was checked, as an ISO date-time; null when unknown."
      -                      },
      -                      "detail": {
      -                        "description": "What the supplier states about it.",
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "description": "The condition, such as monthly fee.",
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "description": "What the source is, such as the supplier's pricing page.",
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "description": "The source page itself.",
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "Where the answer comes from; null when there is no source."
      -                      },
      -                      "status": {
      -                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "description": "The supplier's id.",
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Offset to pass for the next page; null on the last page."
      -          },
      -          "totalCount": {
      -            "description": "How many results match in total, across every page.",
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "needsCheck": {
      -        "additionalProperties": false,
      -        "description": "Suppliers that might fit but need something confirmed first.",
      -        "properties": {
      -          "items": {
      -            "description": "One supplier each.",
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "description": "The supplier's name.",
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "description": "Why it fits, needs a check or does not fit.",
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "When it was checked, as an ISO date-time; null when unknown."
      -                      },
      -                      "detail": {
      -                        "description": "What the supplier states about it.",
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "description": "The condition, such as monthly fee.",
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "description": "What the source is, such as the supplier's pricing page.",
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "description": "The source page itself.",
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "description": "Where the answer comes from; null when there is no source."
      -                      },
      -                      "status": {
      -                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "description": "The supplier's id.",
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Offset to pass for the next page; null on the last page."
      -          },
      -          "totalCount": {
      -            "description": "How many results match in total, across every page.",
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "productType": {
      -        "description": "The product type the guide answers for.",
      -        "type": "string"
      -      },
      -      "state": {
      -        "description": "ready when suppliers were assessed; coverage-unknown when no product data covers this choice.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "state",
      -      "productType",
      -      "destination",
      -      "exampleProduct",
      -      "fits",
      -      "needsCheck",
      -      "doesNotFit",
      -      "deliveredRange"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "error": {
      -        "additionalProperties": false,
      -        "description": "The error this call returned instead of a result.",
      -        "properties": {
      -          "code": {
      -            "description": "The machine-readable reason the call failed.",
      -            "enum": [
      -              "invalid_input",
      -              "not_found",
      -              "product_not_found",
      -              "invalid_option",
      -              "comparison_unavailable",
      -              "unavailable",
      -              "rate_limited"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "description": "What went wrong, in words, and what to do next.",
      -            "type": "string"
      -          },
      -          "retryable": {
      -            "description": "Whether calling again could succeed.",
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "retryable"
      -        ],
      -        "type": "object"
      -      },
      -      "ok": {
      -        "const": false,
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "deliveredRange": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "currency": {
      +                "description": "The currency of this range.",
      +                "enum": [
      +                  "USD",
      +                  "EUR",
      +                  "GBP",
      +                  "AUD",
      +                  "CAD"
      +                ],
      +                "type": "string"
      +              },
      +              "maximum": {
      +                "description": "The highest delivered price, in this currency.",
      +                "type": "number"
      +              },
      +              "minimum": {
      +                "description": "The lowest delivered price, in this currency.",
      +                "type": "number"
      +              }
      +            },
      +            "required": [
      +              "minimum",
      +              "maximum",
      +              "currency"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The delivered price range across the suppliers that fit; null when unavailable."
      +      },
      +      "destination": {
      +        "description": "The buyer's country these prices are for.",
      +        "enum": [
      +          "US",
      +          "GB",
      +          "DE",
      +          "AU",
      +          "CA"
      +        ],
      +        "type": "string"
      +      },
      +      "doesNotFit": {
      +        "additionalProperties": false,
      +        "description": "Suppliers that do not fit.",
      +        "properties": {
      +          "items": {
      +            "description": "One supplier each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "description": "The supplier's name.",
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "description": "Why it fits, needs a check or does not fit.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "When it was checked, as an ISO date-time; null when unknown."
      +                      },
      +                      "detail": {
      +                        "description": "What the supplier states about it.",
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "description": "The condition, such as monthly fee.",
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "description": "What the source is, such as the supplier's pricing page.",
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "description": "The source page itself.",
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "Where the answer comes from; null when there is no source."
      +                      },
      +                      "status": {
      +                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "description": "The supplier's id.",
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Offset to pass for the next page; null on the last page."
      +          },
      +          "totalCount": {
      +            "description": "How many results match in total, across every page.",
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "exampleProduct": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "canonicalProductId": {
      +                "description": "The example product's id, to pass to compare_product.",
      +                "type": "string"
      +              },
      +              "name": {
      +                "description": "The example product's name.",
      +                "type": "string"
      +              },
      +              "option": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "The configuration the prices refer to; null when none."
      +              },
      +              "url": {
      +                "description": "The example product's comparison page on POD Benchmark.",
      +                "format": "uri",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "canonicalProductId",
      +              "name",
      +              "option",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The product the delivered prices refer to; null when none."
      +      },
      +      "fits": {
      +        "additionalProperties": false,
      +        "description": "Suppliers that fit the shop.",
      +        "properties": {
      +          "items": {
      +            "description": "One supplier each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "description": "The supplier's name.",
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "description": "Why it fits, needs a check or does not fit.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "When it was checked, as an ISO date-time; null when unknown."
      +                      },
      +                      "detail": {
      +                        "description": "What the supplier states about it.",
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "description": "The condition, such as monthly fee.",
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "description": "What the source is, such as the supplier's pricing page.",
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "description": "The source page itself.",
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "Where the answer comes from; null when there is no source."
      +                      },
      +                      "status": {
      +                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "description": "The supplier's id.",
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Offset to pass for the next page; null on the last page."
      +          },
      +          "totalCount": {
      +            "description": "How many results match in total, across every page.",
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "needsCheck": {
      +        "additionalProperties": false,
      +        "description": "Suppliers that might fit but need something confirmed first.",
      +        "properties": {
      +          "items": {
      +            "description": "One supplier each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "description": "The supplier's name.",
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "description": "Why it fits, needs a check or does not fit.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "When it was checked, as an ISO date-time; null when unknown."
      +                      },
      +                      "detail": {
      +                        "description": "What the supplier states about it.",
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "description": "The condition, such as monthly fee.",
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "description": "What the source is, such as the supplier's pricing page.",
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "description": "The source page itself.",
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "Where the answer comes from; null when there is no source."
      +                      },
      +                      "status": {
      +                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "description": "The supplier's id.",
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Offset to pass for the next page; null on the last page."
      +          },
      +          "totalCount": {
      +            "description": "How many results match in total, across every page.",
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "productType": {
      +        "description": "The product type the guide answers for.",
      +        "type": "string"
      +      },
      +      "state": {
      +        "description": "ready when suppliers were assessed; coverage-unknown when no product data covers this choice.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "state",
      +      "productType",
      +      "destination",
      +      "exampleProduct",
      +      "fits",
      +      "needsCheck",
      +      "doesNotFit",
      +      "deliveredRange"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": false,
      +        "description": "The error this call returned instead of a result.",
      +        "properties": {
      +          "code": {
      +            "description": "The machine-readable reason the call failed.",
      +            "enum": [
      +              "invalid_input",
      +              "not_found",
      +              "product_not_found",
      +              "invalid_option",
      +              "comparison_unavailable",
      +              "unavailable",
      +              "rate_limited"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "What went wrong, in words, and what to do next.",
      +            "type": "string"
      +          },
      +          "retryable": {
      +            "description": "Whether calling again could succeed.",
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "retryable"
      +        ],
      +        "type": "object"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed8 schema fields changed
    • addedInput schema / properties / limit / description
      Added value: +"How many results to return."
    • addedInput schema / properties / needsCustomBranding / description
      Added value: +"The seller wants their own branding on packaging, labels or inserts."
    • addedInput schema / properties / offset / description
      Added value: +"How many results to skip. Pass nextOffset from the previous page."
    • addedInput schema / properties / productType / description
      Added value: +"What the seller wants to sell."
    • addedInput schema / properties / shopLocation / description
      Added value: +"The country the seller's shop is based in, for platform fees. Leave out if they haven't said."
    • addedInput schema / properties / wantsFreeStart / description
      Added value: +"The seller wants to start without a monthly fee."
    • addedInput schema / properties / wantsToChooseProvider / description
      Added value: +"The seller wants to pick the print provider that makes each order."
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "deliveredRange": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "currency": {
      -                "enum": [
      -                  "USD",
      -                  "EUR",
      -                  "GBP",
      -                  "AUD",
      -                  "CAD"
      -                ],
      -                "type": "string"
      -              },
      -              "maximum": {
      -                "type": "number"
      -              },
      -              "minimum": {
      -                "type": "number"
      -              }
      -            },
      -            "required": [
      -              "minimum",
      -              "maximum",
      -              "currency"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "destination": {
      -        "enum": [
      -          "US",
      -          "GB",
      -          "DE",
      -          "AU",
      -          "CA"
      -        ],
      -        "type": "string"
      -      },
      -      "doesNotFit": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "detail": {
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "status": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "totalCount": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "exampleProduct": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "canonicalProductId": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "type": "string"
      -              },
      -              "option": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "url": {
      -                "format": "uri",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "canonicalProductId",
      -              "name",
      -              "option",
      -              "url"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "fits": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "detail": {
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "status": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "totalCount": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "needsCheck": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "detail": {
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "status": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "totalCount": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "productType": {
      -        "type": "string"
      -      },
      -      "state": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "state",
      -      "productType",
      -      "destination",
      -      "exampleProduct",
      -      "fits",
      -      "needsCheck",
      -      "doesNotFit",
      -      "deliveredRange"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "enum": [
      -              "invalid_input",
      -              "not_found",
      -              "product_not_found",
      -              "invalid_option",
      -              "comparison_unavailable",
      -              "unavailable",
      -              "rate_limited"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "type": "string"
      -          },
      -          "retryable": {
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "retryable"
      -        ],
      -        "type": "object"
      -      },
      -      "ok": {
      -        "const": false,
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "deliveredRange": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "currency": {
      +                "description": "The currency of this range.",
      +                "enum": [
      +                  "USD",
      +                  "EUR",
      +                  "GBP",
      +                  "AUD",
      +                  "CAD"
      +                ],
      +                "type": "string"
      +              },
      +              "maximum": {
      +                "description": "The highest delivered price, in this currency.",
      +                "type": "number"
      +              },
      +              "minimum": {
      +                "description": "The lowest delivered price, in this currency.",
      +                "type": "number"
      +              }
      +            },
      +            "required": [
      +              "minimum",
      +              "maximum",
      +              "currency"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The delivered price range across the suppliers that fit; null when unavailable."
      +      },
      +      "destination": {
      +        "description": "Where the buyer lives: US, GB, DE, CA or AU.",
      +        "enum": [
      +          "US",
      +          "GB",
      +          "DE",
      +          "AU",
      +          "CA"
      +        ],
      +        "type": "string"
      +      },
      +      "doesNotFit": {
      +        "additionalProperties": false,
      +        "description": "Suppliers that do not fit.",
      +        "properties": {
      +          "items": {
      +            "description": "One supplier each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "description": "The supplier's name.",
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "description": "Why it fits, needs a check or does not fit.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "When it was checked, as an ISO date-time; null when unknown."
      +                      },
      +                      "detail": {
      +                        "description": "What the supplier states about it.",
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "description": "The condition, such as monthly fee.",
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "description": "What the source is, such as the supplier's pricing page.",
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "description": "The source page itself.",
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "Where the answer comes from; null when there is no source."
      +                      },
      +                      "status": {
      +                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "description": "The supplier's id.",
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Offset to pass for the next page; null on the last page."
      +          },
      +          "totalCount": {
      +            "description": "How many results match in total, across every page.",
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "exampleProduct": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "canonicalProductId": {
      +                "description": "The example product's id, to pass to compare_product.",
      +                "type": "string"
      +              },
      +              "name": {
      +                "description": "The example product's name.",
      +                "type": "string"
      +              },
      +              "option": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "The configuration the prices refer to; null when none."
      +              },
      +              "url": {
      +                "description": "The example product's comparison page on POD Benchmark.",
      +                "format": "uri",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "canonicalProductId",
      +              "name",
      +              "option",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The product the delivered prices refer to; null when none."
      +      },
      +      "fits": {
      +        "additionalProperties": false,
      +        "description": "Suppliers that fit the shop.",
      +        "properties": {
      +          "items": {
      +            "description": "One supplier each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "description": "The supplier's name.",
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "description": "Why it fits, needs a check or does not fit.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "When it was checked, as an ISO date-time; null when unknown."
      +                      },
      +                      "detail": {
      +                        "description": "What the supplier states about it.",
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "description": "The condition, such as monthly fee.",
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "description": "What the source is, such as the supplier's pricing page.",
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "description": "The source page itself.",
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "Where the answer comes from; null when there is no source."
      +                      },
      +                      "status": {
      +                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "description": "The supplier's id.",
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Offset to pass for the next page; null on the last page."
      +          },
      +          "totalCount": {
      +            "description": "How many results match in total, across every page.",
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "needsCheck": {
      +        "additionalProperties": false,
      +        "description": "Suppliers that might fit but need something confirmed first.",
      +        "properties": {
      +          "items": {
      +            "description": "One supplier each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "description": "The supplier's name.",
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "description": "Why it fits, needs a check or does not fit.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "When it was checked, as an ISO date-time; null when unknown."
      +                      },
      +                      "detail": {
      +                        "description": "What the supplier states about it.",
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "description": "The condition, such as monthly fee.",
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "description": "What the source is, such as the supplier's pricing page.",
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "description": "The source page itself.",
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ],
      +                        "description": "Where the answer comes from; null when there is no source."
      +                      },
      +                      "status": {
      +                        "description": "met when the condition holds, qualified when it holds with conditions, unknown when unconfirmed, blocked when it fails.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "description": "The supplier's id.",
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The supplier's profile page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Offset to pass for the next page; null on the last page."
      +          },
      +          "totalCount": {
      +            "description": "How many results match in total, across every page.",
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "productType": {
      +        "description": "The product type the guide answers for.",
      +        "type": "string"
      +      },
      +      "state": {
      +        "description": "ready when suppliers were assessed; coverage-unknown when no product data covers this choice.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "state",
      +      "productType",
      +      "destination",
      +      "exampleProduct",
      +      "fits",
      +      "needsCheck",
      +      "doesNotFit",
      +      "deliveredRange"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": false,
      +        "description": "The error this call returned instead of a result.",
      +        "properties": {
      +          "code": {
      +            "description": "The machine-readable reason the call failed.",
      +            "enum": [
      +              "invalid_input",
      +              "not_found",
      +              "product_not_found",
      +              "invalid_option",
      +              "comparison_unavailable",
      +              "unavailable",
      +              "rate_limited"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "What went wrong, in words, and what to do next.",
      +            "type": "string"
      +          },
      +          "retryable": {
      +            "description": "Whether calling again could succeed.",
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "retryable"
      +        ],
      +        "type": "object"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • changedInput schema / properties / salesChannel / enum
      Previous value: -[
      -  "shopify",
      -  "etsy",
      -  "woocommerce",
      -  "tiktok-shop"
      -]New value: +[
      +  "etsy",
      +  "shopify",
      +  "woocommerce",
      +  "tiktok-shop"
      +]
  4. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "deliveredRange": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "currency": {
      -                "enum": [
      -                  "USD",
      -                  "EUR",
      -                  "GBP",
      -                  "AUD",
      -                  "CAD"
      -                ],
      -                "type": "string"
      -              },
      -              "maximum": {
      -                "type": "number"
      -              },
      -              "minimum": {
      -                "type": "number"
      -              }
      -            },
      -            "required": [
      -              "minimum",
      -              "maximum",
      -              "currency"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "destination": {
      -        "enum": [
      -          "US",
      -          "GB",
      -          "DE",
      -          "AU",
      -          "CA"
      -        ],
      -        "type": "string"
      -      },
      -      "doesNotFit": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "detail": {
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "status": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "format": "uri",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "totalCount": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "exampleProduct": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "canonicalProductId": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "type": "string"
      -              },
      -              "option": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "url": {
      -                "format": "uri",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "canonicalProductId",
      -              "name",
      -              "option",
      -              "url"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "fits": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "detail": {
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "status": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "format": "uri",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "totalCount": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "needsCheck": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "name": {
      -                  "type": "string"
      -                },
      -                "reasons": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checkedAt": {
      -                        "anyOf": [
      -                          {
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "detail": {
      -                        "type": "string"
      -                      },
      -                      "label": {
      -                        "type": "string"
      -                      },
      -                      "source": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "label": {
      -                                "type": "string"
      -                              },
      -                              "url": {
      -                                "format": "uri",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "label",
      -                              "url"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "status": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "label",
      -                      "detail",
      -                      "checkedAt",
      -                      "source"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "supplierId": {
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "format": "uri",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "supplierId",
      -                "name",
      -                "url",
      -                "reasons"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "nextOffset": {
      -            "anyOf": [
      -              {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "totalCount": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "items",
      -          "totalCount",
      -          "nextOffset"
      -        ],
      -        "type": "object"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "productType": {
      -        "type": "string"
      -      },
      -      "state": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "state",
      -      "productType",
      -      "destination",
      -      "exampleProduct",
      -      "fits",
      -      "needsCheck",
      -      "doesNotFit",
      -      "deliveredRange"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "enum": [
      -              "invalid_input",
      -              "not_found",
      -              "product_not_found",
      -              "invalid_option",
      -              "comparison_unavailable",
      -              "unavailable",
      -              "rate_limited"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "type": "string"
      -          },
      -          "retryable": {
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "retryable"
      -        ],
      -        "type": "object"
      -      },
      -      "ok": {
      -        "const": false,
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "deliveredRange": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "currency": {
      +                "enum": [
      +                  "USD",
      +                  "EUR",
      +                  "GBP",
      +                  "AUD",
      +                  "CAD"
      +                ],
      +                "type": "string"
      +              },
      +              "maximum": {
      +                "type": "number"
      +              },
      +              "minimum": {
      +                "type": "number"
      +              }
      +            },
      +            "required": [
      +              "minimum",
      +              "maximum",
      +              "currency"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "destination": {
      +        "enum": [
      +          "US",
      +          "GB",
      +          "DE",
      +          "AU",
      +          "CA"
      +        ],
      +        "type": "string"
      +      },
      +      "doesNotFit": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "items": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "detail": {
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "status": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "totalCount": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "exampleProduct": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "canonicalProductId": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "option": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "url": {
      +                "format": "uri",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "canonicalProductId",
      +              "name",
      +              "option",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "fits": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "items": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "detail": {
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "status": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "totalCount": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "needsCheck": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "items": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "reasons": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checkedAt": {
      +                        "anyOf": [
      +                          {
      +                            "type": "string"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "detail": {
      +                        "type": "string"
      +                      },
      +                      "label": {
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "label": {
      +                                "type": "string"
      +                              },
      +                              "url": {
      +                                "format": "uri",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "label",
      +                              "url"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "status": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "label",
      +                      "detail",
      +                      "checkedAt",
      +                      "source"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "supplierId": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "supplierId",
      +                "name",
      +                "url",
      +                "reasons"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "nextOffset": {
      +            "anyOf": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "totalCount": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "items",
      +          "totalCount",
      +          "nextOffset"
      +        ],
      +        "type": "object"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "productType": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "state",
      +      "productType",
      +      "destination",
      +      "exampleProduct",
      +      "fits",
      +      "needsCheck",
      +      "doesNotFit",
      +      "deliveredRange"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "enum": [
      +              "invalid_input",
      +              "not_found",
      +              "product_not_found",
      +              "invalid_option",
      +              "comparison_unavailable",
      +              "unavailable",
      +              "rate_limited"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "retryable": {
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "retryable"
      +        ],
      +        "type": "object"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already cover safety (readOnly, idempotent, non-destructive, closed-world), and the description adds real value beyond them: it discloses the three-outcome structure, that reasons are dated and sourced, that a price range is included, and that ranking is not AI-generated. Pagination behaviour is left to the schema's nextOffset note rather than described here.

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?

Two sentences, front-loaded with the trigger condition, then the return contract. The opening sentence is long but every clause maps to a distinct input dimension; the 'No AI ranking' fragment is short and carries real information, though the block is denser than it needs to be.

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 an output schema present, the description needn't spell out return fields, yet it still summarises the verdict categories and price range, which aids selection. For a nine-parameter read-only matching tool with full schema coverage, nothing an agent needs in order to invoke it correctly is missing.

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 each parameter already explains itself, including the 'leave out if undecided' cases for salesChannel and shopLocation. The description restates the same criteria in prose ('where buyers are, the platform, whether they need custom branding') without adding format or interaction detail, so 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?

The description names a specific job: matching suppliers to a seller's product type and shop constraints, and it defines the output shape as three buckets (fit / needs a check / doesn't fit) with dated reasons and sources plus a delivered price range. That is clearly distinct from the lookup-style siblings such as list_suppliers and get_supplier, which return supplier records rather than fit verdicts.

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?

It gives an explicit triggering condition ('Use this when a seller is choosing a supplier') and enumerates the five buyer/seller circumstances that make the call appropriate, each mapping to a parameter. It stops short of stating when NOT to use it or naming a sibling alternative, so it sits below a true routing statement.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.