Skip to main content
Glama

Where a supplier is cheapest

get_supplier_prices
Read-onlyIdempotent

Use this when a seller asks how a supplier's prices compare overall, by category, or against one other supplier: how many products it is the cheapest for, where it costs more, and by how much. Uses each product's usual configuration delivered to the destination; checkedAt is when that supplier's prices were last checked. For one product's prices, use compare_product.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "supplierId": "<supplierId>"
    },
    "name": "get_supplier_prices"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoHow many results to return.
offsetNoHow many results to skip. Pass nextOffset from the previous page.
searchNoOnly products matching these words, such as `hoodie`.
versusNoCompare against this supplier only, instead of every other one.
withinNoHow close to the cheapest still counts as near-cheapest.
categoryNoOnly this category, by id from list_categories, such as `mugs`.
currencyNoCurrency for every price. Defaults to the destination's own currency.
supplierIdYesThe supplier whose prices to rank, such as printify. list_suppliers lists them.
destinationNoThe buyer's country, where the order ships. Product cost, shipping and duty depend on it.US
pricingTierNobase is each supplier's standard price; tier1 and tier2 are its paid plans.base
categoryLimitNoHow many per-category tallies to return. 0 skips them.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 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."
    • changedInput schema / properties / within / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "amount": {
      -        "maximum": 1000,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "kind": {
      -        "const": "amount",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "amount"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "const": "percent",
      -        "type": "string"
      -      },
      -      "percent": {
      -        "maximum": 100,
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "percent"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "description": "How far above the cheapest price still counts, in the response currency.",
      +        "maximum": 1000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "kind": {
      +        "const": "amount",
      +        "description": "Measure closeness as a fixed amount of money.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "amount"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "percent",
      +        "description": "Measure closeness as a share of the cheapest price.",
      +        "type": "string"
      +      },
      +      "percent": {
      +        "description": "How far above the cheapest price still counts, as a percent of it.",
      +        "maximum": 100,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "percent"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "categories": {
      -        "description": "The same counts per category.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "cheaperElsewhere": {
      -              "description": "How many where another supplier is cheaper.",
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "cheapest": {
      -              "description": "How many of them it wins outright, costing less than every other supplier.",
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "compared": {
      -              "description": "How many products were compared.",
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "id": {
      -              "description": "The category id.",
      -              "type": "string"
      -            },
      -            "medianLosingGap": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "The typical amount it loses by, in the response currency; null when it never loses."
      -            },
      -            "medianWinningGap": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "The typical amount it wins by, in the response currency; null when it never wins."
      -            },
      -            "name": {
      -              "description": "The category's display name.",
      -              "type": "string"
      -            },
      -            "nearCheapest": {
      -              "description": "How many of those are within the near-cheapest amount.",
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "tied": {
      -              "description": "How many where it ties another supplier as cheapest.",
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "compared",
      -            "cheapest",
      -            "tied",
      -            "cheaperElsewhere",
      -            "nearCheapest",
      -            "medianWinningGap",
      -            "medianLosingGap",
      -            "id",
      -            "name"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "cheaperElsewhere": {
      -        "additionalProperties": false,
      -        "description": "Products where another supplier is cheaper, largest gap first.",
      -        "properties": {
      -          "items": {
      -            "description": "One product each.",
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "canonicalProductId": {
      -                  "description": "The product's id, to pass to compare_product.",
      -                  "type": "string"
      -                },
      -                "delivered": {
      -                  "description": "This supplier's delivered price, product plus shipping, in the response currency.",
      -                  "type": "number"
      -                },
      -                "gap": {
      -                  "description": "How far apart the two delivered prices are, in the response currency, always positive.",
      -                  "type": "number"
      -                },
      -                "name": {
      -                  "description": "The product's name.",
      -                  "type": "string"
      -                },
      -                "option": {
      -                  "description": "The configuration both prices refer to.",
      -                  "type": "string"
      -                },
      -                "otherDelivered": {
      -                  "anyOf": [
      -                    {
      -                      "type": "number"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The other supplier's delivered price in the response currency; null when unknown."
      -                },
      -                "otherSupplier": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The other supplier's id; null when unknown."
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The product's page on POD Benchmark; null when it has none."
      -                }
      -              },
      -              "required": [
      -                "canonicalProductId",
      -                "name",
      -                "url",
      -                "option",
      -                "delivered",
      -                "otherDelivered",
      -                "otherSupplier",
      -                "gap"
      -              ],
      -              "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"
      -      },
      -      "cheapest": {
      -        "additionalProperties": false,
      -        "description": "Products where this supplier is cheapest, largest gap first.",
      -        "properties": {
      -          "items": {
      -            "description": "One product each.",
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "canonicalProductId": {
      -                  "description": "The product's id, to pass to compare_product.",
      -                  "type": "string"
      -                },
      -                "delivered": {
      -                  "description": "This supplier's delivered price, product plus shipping, in the response currency.",
      -                  "type": "number"
      -                },
      -                "gap": {
      -                  "description": "How far apart the two delivered prices are, in the response currency, always positive.",
      -                  "type": "number"
      -                },
      -                "name": {
      -                  "description": "The product's name.",
      -                  "type": "string"
      -                },
      -                "option": {
      -                  "description": "The configuration both prices refer to.",
      -                  "type": "string"
      -                },
      -                "otherDelivered": {
      -                  "anyOf": [
      -                    {
      -                      "type": "number"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The other supplier's delivered price in the response currency; null when unknown."
      -                },
      -                "otherSupplier": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The other supplier's id; null when unknown."
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "description": "The product's page on POD Benchmark; null when it has none."
      -                }
      -              },
      -              "required": [
      -                "canonicalProductId",
      -                "name",
      -                "url",
      -                "option",
      -                "delivered",
      -                "otherDelivered",
      -                "otherSupplier",
      -                "gap"
      -              ],
      -              "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"
      -      },
      -      "checkedAt": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "When this supplier's prices were last checked, as an ISO date-time; null when unknown."
      -      },
      -      "currency": {
      -        "description": "Currency for every price, such as USD, GBP or EUR.",
      -        "enum": [
      -          "USD",
      -          "EUR",
      -          "GBP",
      -          "AUD",
      -          "CAD"
      -        ],
      -        "type": "string"
      -      },
      -      "destination": {
      -        "description": "Where the buyer lives: US, GB, DE, CA or AU.",
      -        "enum": [
      -          "US",
      -          "GB",
      -          "DE",
      -          "AU",
      -          "CA"
      -        ],
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "overview": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "cheaperElsewhere": {
      -                "description": "How many where another supplier is cheaper.",
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "cheapest": {
      -                "description": "How many of them it wins outright, costing less than every other supplier.",
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "compared": {
      -                "description": "How many products were compared.",
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "medianLosingGap": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "The typical amount it loses by, in the response currency; null when it never loses."
      -              },
      -              "medianWinningGap": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "The typical amount it wins by, in the response currency; null when it never wins."
      -              },
      -              "nearCheapest": {
      -                "description": "How many of those are within the near-cheapest amount.",
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "tied": {
      -                "description": "How many where it ties another supplier as cheapest.",
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "compared",
      -              "cheapest",
      -              "tied",
      -              "cheaperElsewhere",
      -              "nearCheapest",
      -              "medianWinningGap",
      -              "medianLosingGap"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The comparison across every product; null when unavailable."
      -      },
      -      "status": {
      -        "description": "ready when prices could be compared, unavailable when not.",
      -        "enum": [
      -          "ready",
      -          "unavailable"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "status",
      -      "destination",
      -      "currency",
      -      "checkedAt",
      -      "overview",
      -      "categories",
      -      "cheapest",
      -      "cheaperElsewhere"
      -    ],
      -    "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": {
      +      "categories": {
      +        "description": "The same counts per category.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "cheaperElsewhere": {
      +              "description": "How many where another supplier is cheaper.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "cheapest": {
      +              "description": "How many of them it wins outright, costing less than every other supplier.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "compared": {
      +              "description": "How many products were compared.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "id": {
      +              "description": "The category id.",
      +              "type": "string"
      +            },
      +            "medianLosingGap": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "The typical amount it loses by, in the response currency; null when it never loses."
      +            },
      +            "medianWinningGap": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "The typical amount it wins by, in the response currency; null when it never wins."
      +            },
      +            "name": {
      +              "description": "The category's display name.",
      +              "type": "string"
      +            },
      +            "nearCheapest": {
      +              "description": "How many of those are within the near-cheapest amount.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "tied": {
      +              "description": "How many where it ties another supplier as cheapest.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "compared",
      +            "cheapest",
      +            "tied",
      +            "cheaperElsewhere",
      +            "nearCheapest",
      +            "medianWinningGap",
      +            "medianLosingGap",
      +            "id",
      +            "name"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "cheaperElsewhere": {
      +        "additionalProperties": false,
      +        "description": "Products where another supplier is cheaper, largest gap first.",
      +        "properties": {
      +          "items": {
      +            "description": "One product each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "canonicalProductId": {
      +                  "description": "The product's id, to pass to compare_product.",
      +                  "type": "string"
      +                },
      +                "delivered": {
      +                  "description": "This supplier's delivered price, product plus shipping, in the response currency.",
      +                  "type": "number"
      +                },
      +                "gap": {
      +                  "description": "How far apart the two delivered prices are, in the response currency, always positive.",
      +                  "type": "number"
      +                },
      +                "name": {
      +                  "description": "The product's name.",
      +                  "type": "string"
      +                },
      +                "option": {
      +                  "description": "The configuration both prices refer to.",
      +                  "type": "string"
      +                },
      +                "otherDelivered": {
      +                  "anyOf": [
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's delivered price in the response currency; null when unknown."
      +                },
      +                "otherSupplier": {
      +                  "anyOf": [
      +                    {
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's id; null when unknown."
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The product's page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "canonicalProductId",
      +                "name",
      +                "url",
      +                "option",
      +                "delivered",
      +                "otherDelivered",
      +                "otherSupplier",
      +                "gap"
      +              ],
      +              "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"
      +      },
      +      "cheapest": {
      +        "additionalProperties": false,
      +        "description": "Products where this supplier is cheapest, largest gap first.",
      +        "properties": {
      +          "items": {
      +            "description": "One product each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "canonicalProductId": {
      +                  "description": "The product's id, to pass to compare_product.",
      +                  "type": "string"
      +                },
      +                "delivered": {
      +                  "description": "This supplier's delivered price, product plus shipping, in the response currency.",
      +                  "type": "number"
      +                },
      +                "gap": {
      +                  "description": "How far apart the two delivered prices are, in the response currency, always positive.",
      +                  "type": "number"
      +                },
      +                "name": {
      +                  "description": "The product's name.",
      +                  "type": "string"
      +                },
      +                "option": {
      +                  "description": "The configuration both prices refer to.",
      +                  "type": "string"
      +                },
      +                "otherDelivered": {
      +                  "anyOf": [
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's delivered price in the response currency; null when unknown."
      +                },
      +                "otherSupplier": {
      +                  "anyOf": [
      +                    {
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's id; null when unknown."
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The product's page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "canonicalProductId",
      +                "name",
      +                "url",
      +                "option",
      +                "delivered",
      +                "otherDelivered",
      +                "otherSupplier",
      +                "gap"
      +              ],
      +              "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"
      +      },
      +      "checkedAt": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When this supplier's prices were last checked, as an ISO date-time; null when unknown."
      +      },
      +      "currency": {
      +        "description": "Currency for every price, such as USD, GBP or EUR.",
      +        "enum": [
      +          "USD",
      +          "EUR",
      +          "GBP",
      +          "AUD",
      +          "CAD"
      +        ],
      +        "type": "string"
      +      },
      +      "destination": {
      +        "description": "The buyer's country these prices are for.",
      +        "enum": [
      +          "US",
      +          "GB",
      +          "DE",
      +          "AU",
      +          "CA"
      +        ],
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "overview": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "cheaperElsewhere": {
      +                "description": "How many where another supplier is cheaper.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "cheapest": {
      +                "description": "How many of them it wins outright, costing less than every other supplier.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "compared": {
      +                "description": "How many products were compared.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "medianLosingGap": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "The typical amount it loses by, in the response currency; null when it never loses."
      +              },
      +              "medianWinningGap": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "The typical amount it wins by, in the response currency; null when it never wins."
      +              },
      +              "nearCheapest": {
      +                "description": "How many of those are within the near-cheapest amount.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "tied": {
      +                "description": "How many where it ties another supplier as cheapest.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "compared",
      +              "cheapest",
      +              "tied",
      +              "cheaperElsewhere",
      +              "nearCheapest",
      +              "medianWinningGap",
      +              "medianLosingGap"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The comparison across every product; null when unavailable."
      +      },
      +      "status": {
      +        "description": "ready when prices could be compared, unavailable when not.",
      +        "enum": [
      +          "ready",
      +          "unavailable"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "status",
      +      "destination",
      +      "currency",
      +      "checkedAt",
      +      "overview",
      +      "categories",
      +      "cheapest",
      +      "cheaperElsewhere"
      +    ],
      +    "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 / category / description
      Added value: +"Only this category, by id from list_categories, such as `mugs`."
    • addedInput schema / properties / categoryLimit / description
      Added value: +"How many per-category tallies to return. 0 skips them."
    • addedInput schema / properties / limit / description
      Added value: +"How many results to return."
    • addedInput schema / properties / offset / description
      Added value: +"How many results to skip. Pass nextOffset from the previous page."
    • addedInput schema / properties / pricingTier / description
      Added value: +"base is each supplier's standard price; tier1 and tier2 are its paid plans."
    • addedInput schema / properties / search / description
      Added value: +"Only products matching these words, such as `hoodie`."
    • addedInput schema / properties / supplierId / description
      Added value: +"The supplier whose prices to rank, such as printify. list_suppliers lists them."
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "categories": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "cheaperElsewhere": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "cheapest": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "compared": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "id": {
      -              "type": "string"
      -            },
      -            "medianLosingGap": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "medianWinningGap": {
      -              "anyOf": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "nearCheapest": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "tied": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "compared",
      -            "cheapest",
      -            "tied",
      -            "cheaperElsewhere",
      -            "nearCheapest",
      -            "medianWinningGap",
      -            "medianLosingGap",
      -            "id",
      -            "name"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "cheaperElsewhere": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "canonicalProductId": {
      -                  "type": "string"
      -                },
      -                "delivered": {
      -                  "type": "number"
      -                },
      -                "gap": {
      -                  "type": "number"
      -                },
      -                "name": {
      -                  "type": "string"
      -                },
      -                "option": {
      -                  "type": "string"
      -                },
      -                "otherDelivered": {
      -                  "anyOf": [
      -                    {
      -                      "type": "number"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "otherSupplier": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "canonicalProductId",
      -                "name",
      -                "url",
      -                "option",
      -                "delivered",
      -                "otherDelivered",
      -                "otherSupplier",
      -                "gap"
      -              ],
      -              "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"
      -      },
      -      "cheapest": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "items": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "canonicalProductId": {
      -                  "type": "string"
      -                },
      -                "delivered": {
      -                  "type": "number"
      -                },
      -                "gap": {
      -                  "type": "number"
      -                },
      -                "name": {
      -                  "type": "string"
      -                },
      -                "option": {
      -                  "type": "string"
      -                },
      -                "otherDelivered": {
      -                  "anyOf": [
      -                    {
      -                      "type": "number"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "otherSupplier": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "url": {
      -                  "anyOf": [
      -                    {
      -                      "format": "uri",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "canonicalProductId",
      -                "name",
      -                "url",
      -                "option",
      -                "delivered",
      -                "otherDelivered",
      -                "otherSupplier",
      -                "gap"
      -              ],
      -              "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"
      -      },
      -      "checkedAt": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "currency": {
      -        "enum": [
      -          "USD",
      -          "EUR",
      -          "GBP",
      -          "AUD",
      -          "CAD"
      -        ],
      -        "type": "string"
      -      },
      -      "destination": {
      -        "enum": [
      -          "US",
      -          "GB",
      -          "DE",
      -          "AU",
      -          "CA"
      -        ],
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "overview": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "cheaperElsewhere": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "cheapest": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "compared": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "medianLosingGap": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "medianWinningGap": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "nearCheapest": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "tied": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "compared",
      -              "cheapest",
      -              "tied",
      -              "cheaperElsewhere",
      -              "nearCheapest",
      -              "medianWinningGap",
      -              "medianLosingGap"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "status": {
      -        "enum": [
      -          "ready",
      -          "unavailable"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "status",
      -      "destination",
      -      "currency",
      -      "checkedAt",
      -      "overview",
      -      "categories",
      -      "cheapest",
      -      "cheaperElsewhere"
      -    ],
      -    "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": {
      +      "categories": {
      +        "description": "The same counts per category.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "cheaperElsewhere": {
      +              "description": "How many where another supplier is cheaper.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "cheapest": {
      +              "description": "How many of them it wins outright, costing less than every other supplier.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "compared": {
      +              "description": "How many products were compared.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "id": {
      +              "description": "The category id.",
      +              "type": "string"
      +            },
      +            "medianLosingGap": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "The typical amount it loses by, in the response currency; null when it never loses."
      +            },
      +            "medianWinningGap": {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "The typical amount it wins by, in the response currency; null when it never wins."
      +            },
      +            "name": {
      +              "description": "The category's display name.",
      +              "type": "string"
      +            },
      +            "nearCheapest": {
      +              "description": "How many of those are within the near-cheapest amount.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "tied": {
      +              "description": "How many where it ties another supplier as cheapest.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "compared",
      +            "cheapest",
      +            "tied",
      +            "cheaperElsewhere",
      +            "nearCheapest",
      +            "medianWinningGap",
      +            "medianLosingGap",
      +            "id",
      +            "name"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "cheaperElsewhere": {
      +        "additionalProperties": false,
      +        "description": "Products where another supplier is cheaper, largest gap first.",
      +        "properties": {
      +          "items": {
      +            "description": "One product each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "canonicalProductId": {
      +                  "description": "The product's id, to pass to compare_product.",
      +                  "type": "string"
      +                },
      +                "delivered": {
      +                  "description": "This supplier's delivered price, product plus shipping, in the response currency.",
      +                  "type": "number"
      +                },
      +                "gap": {
      +                  "description": "How far apart the two delivered prices are, in the response currency, always positive.",
      +                  "type": "number"
      +                },
      +                "name": {
      +                  "description": "The product's name.",
      +                  "type": "string"
      +                },
      +                "option": {
      +                  "description": "The configuration both prices refer to.",
      +                  "type": "string"
      +                },
      +                "otherDelivered": {
      +                  "anyOf": [
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's delivered price in the response currency; null when unknown."
      +                },
      +                "otherSupplier": {
      +                  "anyOf": [
      +                    {
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's id; null when unknown."
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The product's page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "canonicalProductId",
      +                "name",
      +                "url",
      +                "option",
      +                "delivered",
      +                "otherDelivered",
      +                "otherSupplier",
      +                "gap"
      +              ],
      +              "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"
      +      },
      +      "cheapest": {
      +        "additionalProperties": false,
      +        "description": "Products where this supplier is cheapest, largest gap first.",
      +        "properties": {
      +          "items": {
      +            "description": "One product each.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "canonicalProductId": {
      +                  "description": "The product's id, to pass to compare_product.",
      +                  "type": "string"
      +                },
      +                "delivered": {
      +                  "description": "This supplier's delivered price, product plus shipping, in the response currency.",
      +                  "type": "number"
      +                },
      +                "gap": {
      +                  "description": "How far apart the two delivered prices are, in the response currency, always positive.",
      +                  "type": "number"
      +                },
      +                "name": {
      +                  "description": "The product's name.",
      +                  "type": "string"
      +                },
      +                "option": {
      +                  "description": "The configuration both prices refer to.",
      +                  "type": "string"
      +                },
      +                "otherDelivered": {
      +                  "anyOf": [
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's delivered price in the response currency; null when unknown."
      +                },
      +                "otherSupplier": {
      +                  "anyOf": [
      +                    {
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The other supplier's id; null when unknown."
      +                },
      +                "url": {
      +                  "anyOf": [
      +                    {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ],
      +                  "description": "The product's page on POD Benchmark; null when it has none."
      +                }
      +              },
      +              "required": [
      +                "canonicalProductId",
      +                "name",
      +                "url",
      +                "option",
      +                "delivered",
      +                "otherDelivered",
      +                "otherSupplier",
      +                "gap"
      +              ],
      +              "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"
      +      },
      +      "checkedAt": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "When this supplier's prices were last checked, as an ISO date-time; null when unknown."
      +      },
      +      "currency": {
      +        "description": "Currency for every price, such as USD, GBP or EUR.",
      +        "enum": [
      +          "USD",
      +          "EUR",
      +          "GBP",
      +          "AUD",
      +          "CAD"
      +        ],
      +        "type": "string"
      +      },
      +      "destination": {
      +        "description": "Where the buyer lives: US, GB, DE, CA or AU.",
      +        "enum": [
      +          "US",
      +          "GB",
      +          "DE",
      +          "AU",
      +          "CA"
      +        ],
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "overview": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "cheaperElsewhere": {
      +                "description": "How many where another supplier is cheaper.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "cheapest": {
      +                "description": "How many of them it wins outright, costing less than every other supplier.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "compared": {
      +                "description": "How many products were compared.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "medianLosingGap": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "The typical amount it loses by, in the response currency; null when it never loses."
      +              },
      +              "medianWinningGap": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "The typical amount it wins by, in the response currency; null when it never wins."
      +              },
      +              "nearCheapest": {
      +                "description": "How many of those are within the near-cheapest amount.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "tied": {
      +                "description": "How many where it ties another supplier as cheapest.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "compared",
      +              "cheapest",
      +              "tied",
      +              "cheaperElsewhere",
      +              "nearCheapest",
      +              "medianWinningGap",
      +              "medianLosingGap"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The comparison across every product; null when unavailable."
      +      },
      +      "status": {
      +        "description": "ready when prices could be compared, unavailable when not.",
      +        "enum": [
      +          "ready",
      +          "unavailable"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "status",
      +      "destination",
      +      "currency",
      +      "checkedAt",
      +      "overview",
      +      "categories",
      +      "cheapest",
      +      "cheaperElsewhere"
      +    ],
      +    "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. Changed2 schema fields changed
    • changedInput schema / properties / supplierId / enum
      Previous value: -[
      -  "apliiq",
      -  "artelo",
      -  "customcat",
      -  "fourthwall",
      -  "gelato",
      -  "inkthreadable",
      -  "printful",
      -  "printify",
      -  "prodigi"
      -]New value: +[
      +  "apliiq",
      +  "artelo",
      +  "merchone",
      +  "customcat",
      +  "fourthwall",
      +  "gelato",
      +  "inkthreadable",
      +  "printful",
      +  "printify",
      +  "prodigi"
      +]
    • changedInput schema / properties / versus / enum
      Previous value: -[
      -  "apliiq",
      -  "artelo",
      -  "customcat",
      -  "fourthwall",
      -  "gelato",
      -  "inkthreadable",
      -  "printful",
      -  "printify",
      -  "prodigi"
      -]New value: +[
      +  "apliiq",
      +  "artelo",
      +  "merchone",
      +  "customcat",
      +  "fourthwall",
      +  "gelato",
      +  "inkthreadable",
      +  "printful",
      +  "printify",
      +  "prodigi"
      +]
  4. Changed2 schema fields changed
    • changedInput schema / properties / supplierId / enum
      Previous value: -[
      -  "apliiq",
      -  "customcat",
      -  "fourthwall",
      -  "gelato",
      -  "inkthreadable",
      -  "printful",
      -  "printify",
      -  "prodigi"
      -]New value: +[
      +  "apliiq",
      +  "artelo",
      +  "customcat",
      +  "fourthwall",
      +  "gelato",
      +  "inkthreadable",
      +  "printful",
      +  "printify",
      +  "prodigi"
      +]
    • changedInput schema / properties / versus / enum
      Previous value: -[
      -  "apliiq",
      -  "customcat",
      -  "fourthwall",
      -  "gelato",
      -  "inkthreadable",
      -  "printful",
      -  "printify",
      -  "prodigi"
      -]New value: +[
      +  "apliiq",
      +  "artelo",
      +  "customcat",
      +  "fourthwall",
      +  "gelato",
      +  "inkthreadable",
      +  "printful",
      +  "printify",
      +  "prodigi"
      +]
  5. Changed2 schema fields changed
    • changedInput schema / properties / supplierId / enum
      Previous value: -[
      -  "customcat",
      -  "fourthwall",
      -  "gelato",
      -  "inkthreadable",
      -  "printful",
      -  "printify",
      -  "prodigi"
      -]New value: +[
      +  "apliiq",
      +  "customcat",
      +  "fourthwall",
      +  "gelato",
      +  "inkthreadable",
      +  "printful",
      +  "printify",
      +  "prodigi"
      +]
    • changedInput schema / properties / versus / enum
      Previous value: -[
      -  "customcat",
      -  "fourthwall",
      -  "gelato",
      -  "inkthreadable",
      -  "printful",
      -  "printify",
      -  "prodigi"
      -]New value: +[
      +  "apliiq",
      +  "customcat",
      +  "fourthwall",
      +  "gelato",
      +  "inkthreadable",
      +  "printful",
      +  "printify",
      +  "prodigi"
      +]
  6. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already state readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds real behavior beyond them: prices assume each product's usual configuration delivered to the destination, and checkedAt reports when the supplier's prices were last verified. It says nothing about how much data is returned or pagination, though the output schema and params cover that.

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

Conciseness5/5

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

Three tight sentences: the trigger and outputs come first, the pricing basis and checkedAt next, and the sibling handoff last. Every sentence carries distinct information and there is no restatement of the title.

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?

For an 11-parameter tool with a full output schema and safety annotations, the description covers the pieces an agent cannot infer: when to use it, what checkedAt means, and that prices assume standard configuration shipped to the destination. Only minor gaps remain, such as how the near-cheapest 'within' threshold shapes the result, and that concept is already explained in the schema.

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%, so every parameter (versus, within, category, destination, pricingTier, paging) is already documented with defaults, enums and bounds. The description only indirectly illuminates semantics, via 'usual configuration delivered to the destination', which explains why destination matters, but adds no format or constraint detail beyond the schema. Baseline 3 applies.

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

Purpose5/5

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

The description gives a specific verb and resource: it compares a named supplier's prices overall, by category, or against one other supplier, and reports how often it is cheapest, where it costs more, and by how much. It also names the sibling it must not be confused with (compare_product), so the boundary is clear without opening either schema.

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 opens with an explicit trigger ('Use this when a seller asks how a supplier's prices compare...') and routes the one-product case to compare_product. It does not spell out when not to reach for this tool, such as plain supplier discovery (list_suppliers) or raw product search, so the guidance is clear but not exhaustive.

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.