Skip to main content
Glama

Screen asking price against melt and policy bands

fair_offer_check
Read-onlyIdempotent

Screen an asking price against spot, melt and policy bands; returns buy, counter or pass, with counter and walk-away prices when a bid exists. Example: {"product":"american-gold-eagle-1oz","price":4250}.

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": "fair_offer_check"
  }
}

Input Schema

NameRequiredDescriptionDefault
spotNo
unitNo
as_ofNo
costsNo
karatNo
metalNo
priceNo
policyNo
purityNo
weightNo
productNo
fees_usdNo
quantityNo
offer_usdNo
other_usdNo
spot_asofNo
asking_priceNo
shipping_usdNo
spot_max_age_secondsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed21 schema fields changed
    • removedInput schema / examples
      Removed value: -[
      -  {
      -    "price": 4250,
      -    "product": "american-gold-eagle-1oz"
      -  }
      -]
    • removedInput schema / properties / as_of / description
      Removed value: -"Evaluation timestamp (ISO-8601). Defaults to the request time. The spot must also be fresh at the request time."
    • removedInput schema / properties / asking_price / description
      Removed value: -"Per-unit asking price {amount, currency} or pass price / offer_usd in USD."
    • removedInput schema / properties / costs / description
      Removed value: -"Optional full costs object. Defaults to known $0.00 shipping/fees/other."
    • removedInput schema / properties / fees_usd / description
      Removed value: -"Optional fees in USD (defaults to 0 when costs is omitted)."
    • removedInput schema / properties / karat / description
      Removed value: -"Gold karat for custom/scrap items."
    • removedInput schema / properties / metal / description
      Removed value: -"Metal (inferred automatically when a tracked BPC product is given)."
    • removedInput schema / properties / offer_usd / description
      Removed value: -"Alias for price: per-unit asking/offer price in USD."
    • removedInput schema / properties / other_usd / description
      Removed value: -"Optional other cost in USD (defaults to 0 when costs is omitted)."
    • removedInput schema / properties / policy / description
      Removed value: -"Optional policy bands. Defaults to live BPC dealer ask median/range bands."
    • removedInput schema / properties / price / description
      Removed value: -"Shorthand per-unit asking price in USD."
    • removedInput schema / properties / product / description
      Removed value: -"Tracked BPC product slug/name (e.g. \"american-gold-eagle-1oz\") or full product spec object."
    • removedInput schema / properties / purity / description
      Removed value: -"Fineness fraction (0-1) for custom/scrap items."
    • removedInput schema / properties / quantity / description
      Removed value: -"Quantity of units (defaults to \"1\")."
    • removedInput schema / properties / shipping_usd / description
      Removed value: -"Optional shipping cost in USD (defaults to 0 when costs is omitted)."
    • removedInput schema / properties / spot / description
      Removed value: -"Optional spot override (USD/ozt or full spot object). Defaults to live BPC spot. A caller spot needs its own time (spot_asof or spot.as_of); an untimed spot returns insufficient_data."
    • removedInput schema / properties / spot_asof / description
      Removed value: -"ISO timestamp of the caller spot override. Without it the screen returns insufficient_data, never buy, counter or pass."
    • removedInput schema / properties / spot_max_age_seconds / description
      Removed value: -"Maximum spot age in seconds before the spot price is treated as stale. Default and maximum 7200 (120 min), plus a 5-minute future allowance. A stale, future-dated or untimed spot returns insufficient_data, never buy, counter or pass."
    • removedInput schema / properties / unit / description
      Removed value: -"Weight unit for custom/scrap items."
    • removedInput schema / properties / weight / description
      Removed value: -"Optional gross weight for custom/scrap items."
    • changedOutput schema / (root)
      Previous value: -{
      -  "$schema": "https://json-schema.org/draft/2020-12/schema",
      -  "oneOf": [
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "all_in": {
      -          "type": "object"
      -        },
      -        "as_of": {
      -          "type": "string"
      -        },
      -        "asking_price_basis": {
      -          "const": "per_unit"
      -        },
      -        "attribution_credit": {
      -          "type": "object"
      -        },
      -        "counter_basis": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "counter_price_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "customization": {
      -          "type": "string"
      -        },
      -        "data_as_of": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "data_sources": {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        "decision": {
      -          "enum": [
      -            "buy",
      -            "counter",
      -            "pass",
      -            "insufficient_data"
      -          ]
      -        },
      -        "decision_basis": {
      -          "enum": [
      -            "melt_screen",
      -            "all_in",
      -            "market_cap",
      -            "none"
      -          ]
      -        },
      -        "disclaimer": {
      -          "type": "string"
      -        },
      -        "execution_mode": {
      -          "enum": [
      -            "caller_supplied_stateless",
      -            "bpc_live_and_caller"
      -          ]
      -        },
      -        "freshness": {
      -          "required": [
      -            "stale"
      -          ],
      -          "type": "object"
      -        },
      -        "market_evidence": {
      -          "type": "object"
      -        },
      -        "melt_screen": {
      -          "type": "object"
      -        },
      -        "no_accuracy_guarantee": {
      -          "type": "string"
      -        },
      -        "ok": {
      -          "const": true
      -        },
      -        "plausibility": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "pct_below_melt": {
      -              "type": "number"
      -            },
      -            "plausible": {
      -              "type": "boolean"
      -            },
      -            "status": {
      -              "enum": [
      -                "ok",
      -                "warning_below_spot"
      -              ]
      -            },
      -            "warning": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "status",
      -            "plausible",
      -            "pct_below_melt",
      -            "warning"
      -          ],
      -          "type": "object"
      -        },
      -        "policy_id": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "reason": {
      -          "type": "string"
      -        },
      -        "schema_version": {
      -          "const": "1.0.0"
      -        },
      -        "screen_note": {
      -          "type": "string"
      -        },
      -        "tool": {
      -          "const": "fair_offer_check"
      -        },
      -        "walk_away_price_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        }
      -      },
      -      "required": [
      -        "ok",
      -        "tool",
      -        "schema_version",
      -        "execution_mode",
      -        "as_of",
      -        "disclaimer",
      -        "no_accuracy_guarantee",
      -        "decision",
      -        "decision_basis",
      -        "policy_id",
      -        "asking_price_basis",
      -        "melt_screen",
      -        "all_in",
      -        "market_evidence",
      -        "screen_note"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "customization": {
      -          "type": "string"
      -        },
      -        "data_as_of": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "error": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "const": "INVALID_INPUT"
      -            },
      -            "diagnostics": {
      -              "items": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "blocks_eligibility": {
      -                    "type": "boolean"
      -                  },
      -                  "blocks_validity": {
      -                    "type": "boolean"
      -                  },
      -                  "code": {
      -                    "type": "string"
      -                  },
      -                  "field": {
      -                    "type": "string"
      -                  },
      -                  "message": {
      -                    "type": "string"
      -                  },
      -                  "severity": {
      -                    "enum": [
      -                      "error",
      -                      "warning",
      -                      "info"
      -                    ]
      -                  }
      -                },
      -                "required": [
      -                  "code",
      -                  "severity",
      -                  "field",
      -                  "message",
      -                  "blocks_validity",
      -                  "blocks_eligibility"
      -                ],
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            "message": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "message",
      -            "diagnostics"
      -          ],
      -          "type": "object"
      -        },
      -        "execution_mode": {
      -          "const": "caller_supplied_stateless"
      -        },
      -        "ok": {
      -          "const": false
      -        },
      -        "schema_version": {
      -          "const": "1.0.0"
      -        },
      -        "tool": {
      -          "const": "fair_offer_check"
      -        }
      -      },
      -      "required": [
      -        "ok",
      -        "tool",
      -        "schema_version",
      -        "execution_mode",
      -        "error"
      -      ],
      -      "type": "object"
      -    }
      -  ],
      -  "type": "object"
      -}New value: +null
  2. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "all_in": {
      -        "type": "object"
      -      },
      -      "as_of": {
      -        "type": "string"
      -      },
      -      "asking_price_basis": {
      -        "const": "per_unit"
      -      },
      -      "attribution_credit": {
      -        "type": "object"
      -      },
      -      "customization": {
      -        "type": "string"
      -      },
      -      "data_as_of": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "data_sources": {
      -        "additionalProperties": true,
      -        "type": "object"
      -      },
      -      "decision": {
      -        "enum": [
      -          "buy",
      -          "counter",
      -          "pass",
      -          "insufficient_data"
      -        ]
      -      },
      -      "decision_basis": {
      -        "enum": [
      -          "melt_screen",
      -          "all_in",
      -          "market_cap",
      -          "none"
      -        ]
      -      },
      -      "disclaimer": {
      -        "type": "string"
      -      },
      -      "execution_mode": {
      -        "enum": [
      -          "caller_supplied_stateless",
      -          "bpc_live_and_caller"
      -        ]
      -      },
      -      "freshness": {
      -        "required": [
      -          "stale"
      -        ],
      -        "type": "object"
      -      },
      -      "market_evidence": {
      -        "type": "object"
      -      },
      -      "melt_screen": {
      -        "type": "object"
      -      },
      -      "no_accuracy_guarantee": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true
      -      },
      -      "plausibility": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "pct_below_melt": {
      -            "type": "number"
      -          },
      -          "plausible": {
      -            "type": "boolean"
      -          },
      -          "status": {
      -            "enum": [
      -              "ok",
      -              "warning_below_spot"
      -            ]
      -          },
      -          "warning": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "status",
      -          "plausible",
      -          "pct_below_melt",
      -          "warning"
      -        ],
      -        "type": "object"
      -      },
      -      "policy_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "screen_note": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "as_of",
      -      "disclaimer",
      -      "no_accuracy_guarantee",
      -      "decision",
      -      "decision_basis",
      -      "policy_id",
      -      "asking_price_basis",
      -      "melt_screen",
      -      "all_in",
      -      "market_evidence",
      -      "screen_note"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "customization": {
      -        "type": "string"
      -      },
      -      "data_as_of": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "const": "INVALID_INPUT"
      -          },
      -          "diagnostics": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "blocks_eligibility": {
      -                  "type": "boolean"
      -                },
      -                "blocks_validity": {
      -                  "type": "boolean"
      -                },
      -                "code": {
      -                  "type": "string"
      -                },
      -                "field": {
      -                  "type": "string"
      -                },
      -                "message": {
      -                  "type": "string"
      -                },
      -                "severity": {
      -                  "enum": [
      -                    "error",
      -                    "warning",
      -                    "info"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "severity",
      -                "field",
      -                "message",
      -                "blocks_validity",
      -                "blocks_eligibility"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "message": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "diagnostics"
      -        ],
      -        "type": "object"
      -      },
      -      "execution_mode": {
      -        "const": "caller_supplied_stateless"
      -      },
      -      "ok": {
      -        "const": false
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "all_in": {
      +        "type": "object"
      +      },
      +      "as_of": {
      +        "type": "string"
      +      },
      +      "asking_price_basis": {
      +        "const": "per_unit"
      +      },
      +      "attribution_credit": {
      +        "type": "object"
      +      },
      +      "counter_basis": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "counter_price_usd": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "data_sources": {
      +        "additionalProperties": true,
      +        "type": "object"
      +      },
      +      "decision": {
      +        "enum": [
      +          "buy",
      +          "counter",
      +          "pass",
      +          "insufficient_data"
      +        ]
      +      },
      +      "decision_basis": {
      +        "enum": [
      +          "melt_screen",
      +          "all_in",
      +          "market_cap",
      +          "none"
      +        ]
      +      },
      +      "disclaimer": {
      +        "type": "string"
      +      },
      +      "execution_mode": {
      +        "enum": [
      +          "caller_supplied_stateless",
      +          "bpc_live_and_caller"
      +        ]
      +      },
      +      "freshness": {
      +        "required": [
      +          "stale"
      +        ],
      +        "type": "object"
      +      },
      +      "market_evidence": {
      +        "type": "object"
      +      },
      +      "melt_screen": {
      +        "type": "object"
      +      },
      +      "no_accuracy_guarantee": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true
      +      },
      +      "plausibility": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "pct_below_melt": {
      +            "type": "number"
      +          },
      +          "plausible": {
      +            "type": "boolean"
      +          },
      +          "status": {
      +            "enum": [
      +              "ok",
      +              "warning_below_spot"
      +            ]
      +          },
      +          "warning": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "status",
      +          "plausible",
      +          "pct_below_melt",
      +          "warning"
      +        ],
      +        "type": "object"
      +      },
      +      "policy_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "reason": {
      +        "type": "string"
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "screen_note": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      },
      +      "walk_away_price_usd": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "as_of",
      +      "disclaimer",
      +      "no_accuracy_guarantee",
      +      "decision",
      +      "decision_basis",
      +      "policy_id",
      +      "asking_price_basis",
      +      "melt_screen",
      +      "all_in",
      +      "market_evidence",
      +      "screen_note"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "const": "INVALID_INPUT"
      +          },
      +          "diagnostics": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "blocks_eligibility": {
      +                  "type": "boolean"
      +                },
      +                "blocks_validity": {
      +                  "type": "boolean"
      +                },
      +                "code": {
      +                  "type": "string"
      +                },
      +                "field": {
      +                  "type": "string"
      +                },
      +                "message": {
      +                  "type": "string"
      +                },
      +                "severity": {
      +                  "enum": [
      +                    "error",
      +                    "warning",
      +                    "info"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "code",
      +                "severity",
      +                "field",
      +                "message",
      +                "blocks_validity",
      +                "blocks_eligibility"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "diagnostics"
      +        ],
      +        "type": "object"
      +      },
      +      "execution_mode": {
      +        "const": "caller_supplied_stateless"
      +      },
      +      "ok": {
      +        "const": false
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "all_in": {
      -        "type": "object"
      -      },
      -      "as_of": {
      -        "type": "string"
      -      },
      -      "asking_price_basis": {
      -        "const": "per_unit"
      -      },
      -      "customization": {
      -        "type": "string"
      -      },
      -      "data_as_of": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "data_sources": {
      -        "additionalProperties": true,
      -        "type": "object"
      -      },
      -      "decision": {
      -        "enum": [
      -          "buy",
      -          "counter",
      -          "pass",
      -          "insufficient_data"
      -        ]
      -      },
      -      "decision_basis": {
      -        "enum": [
      -          "melt_screen",
      -          "all_in",
      -          "market_cap",
      -          "none"
      -        ]
      -      },
      -      "disclaimer": {
      -        "type": "string"
      -      },
      -      "execution_mode": {
      -        "enum": [
      -          "caller_supplied_stateless",
      -          "bpc_live_and_caller"
      -        ]
      -      },
      -      "freshness": {
      -        "required": [
      -          "stale"
      -        ],
      -        "type": "object"
      -      },
      -      "market_evidence": {
      -        "type": "object"
      -      },
      -      "melt_screen": {
      -        "type": "object"
      -      },
      -      "no_accuracy_guarantee": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true
      -      },
      -      "plausibility": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "pct_below_melt": {
      -            "type": "number"
      -          },
      -          "plausible": {
      -            "type": "boolean"
      -          },
      -          "status": {
      -            "enum": [
      -              "ok",
      -              "warning_below_spot"
      -            ]
      -          },
      -          "warning": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "status",
      -          "plausible",
      -          "pct_below_melt",
      -          "warning"
      -        ],
      -        "type": "object"
      -      },
      -      "policy_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "screen_note": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "as_of",
      -      "disclaimer",
      -      "no_accuracy_guarantee",
      -      "decision",
      -      "decision_basis",
      -      "policy_id",
      -      "asking_price_basis",
      -      "melt_screen",
      -      "all_in",
      -      "market_evidence",
      -      "screen_note"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "customization": {
      -        "type": "string"
      -      },
      -      "data_as_of": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "const": "INVALID_INPUT"
      -          },
      -          "diagnostics": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "blocks_eligibility": {
      -                  "type": "boolean"
      -                },
      -                "blocks_validity": {
      -                  "type": "boolean"
      -                },
      -                "code": {
      -                  "type": "string"
      -                },
      -                "field": {
      -                  "type": "string"
      -                },
      -                "message": {
      -                  "type": "string"
      -                },
      -                "severity": {
      -                  "enum": [
      -                    "error",
      -                    "warning",
      -                    "info"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "severity",
      -                "field",
      -                "message",
      -                "blocks_validity",
      -                "blocks_eligibility"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "message": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "diagnostics"
      -        ],
      -        "type": "object"
      -      },
      -      "execution_mode": {
      -        "const": "caller_supplied_stateless"
      -      },
      -      "ok": {
      -        "const": false
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "all_in": {
      +        "type": "object"
      +      },
      +      "as_of": {
      +        "type": "string"
      +      },
      +      "asking_price_basis": {
      +        "const": "per_unit"
      +      },
      +      "attribution_credit": {
      +        "type": "object"
      +      },
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "data_sources": {
      +        "additionalProperties": true,
      +        "type": "object"
      +      },
      +      "decision": {
      +        "enum": [
      +          "buy",
      +          "counter",
      +          "pass",
      +          "insufficient_data"
      +        ]
      +      },
      +      "decision_basis": {
      +        "enum": [
      +          "melt_screen",
      +          "all_in",
      +          "market_cap",
      +          "none"
      +        ]
      +      },
      +      "disclaimer": {
      +        "type": "string"
      +      },
      +      "execution_mode": {
      +        "enum": [
      +          "caller_supplied_stateless",
      +          "bpc_live_and_caller"
      +        ]
      +      },
      +      "freshness": {
      +        "required": [
      +          "stale"
      +        ],
      +        "type": "object"
      +      },
      +      "market_evidence": {
      +        "type": "object"
      +      },
      +      "melt_screen": {
      +        "type": "object"
      +      },
      +      "no_accuracy_guarantee": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true
      +      },
      +      "plausibility": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "pct_below_melt": {
      +            "type": "number"
      +          },
      +          "plausible": {
      +            "type": "boolean"
      +          },
      +          "status": {
      +            "enum": [
      +              "ok",
      +              "warning_below_spot"
      +            ]
      +          },
      +          "warning": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "status",
      +          "plausible",
      +          "pct_below_melt",
      +          "warning"
      +        ],
      +        "type": "object"
      +      },
      +      "policy_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "reason": {
      +        "type": "string"
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "screen_note": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "as_of",
      +      "disclaimer",
      +      "no_accuracy_guarantee",
      +      "decision",
      +      "decision_basis",
      +      "policy_id",
      +      "asking_price_basis",
      +      "melt_screen",
      +      "all_in",
      +      "market_evidence",
      +      "screen_note"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "const": "INVALID_INPUT"
      +          },
      +          "diagnostics": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "blocks_eligibility": {
      +                  "type": "boolean"
      +                },
      +                "blocks_validity": {
      +                  "type": "boolean"
      +                },
      +                "code": {
      +                  "type": "string"
      +                },
      +                "field": {
      +                  "type": "string"
      +                },
      +                "message": {
      +                  "type": "string"
      +                },
      +                "severity": {
      +                  "enum": [
      +                    "error",
      +                    "warning",
      +                    "info"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "code",
      +                "severity",
      +                "field",
      +                "message",
      +                "blocks_validity",
      +                "blocks_eligibility"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "diagnostics"
      +        ],
      +        "type": "object"
      +      },
      +      "execution_mode": {
      +        "const": "caller_supplied_stateless"
      +      },
      +      "ok": {
      +        "const": false
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed4 schema fields changed
    • changedInput schema / properties / as_of / description
      Previous value: -"Evaluation timestamp (ISO-8601). Defaults to live BPC refresh."New value: +"Evaluation timestamp (ISO-8601). Defaults to the request time. The spot must also be fresh at the request time."
    • changedInput schema / properties / spot / description
      Previous value: -"Optional spot override (USD/ozt or full spot object). Defaults to live BPC spot."New value: +"Optional spot override (USD/ozt or full spot object). Defaults to live BPC spot. A caller spot needs its own time (spot_asof or spot.as_of); an untimed spot returns insufficient_data."
    • changedInput schema / properties / spot_asof / description
      Previous value: -"Optional ISO timestamp for caller spot override."New value: +"ISO timestamp of the caller spot override. Without it the screen returns insufficient_data, never buy, counter or pass."
    • changedInput schema / properties / spot_max_age_seconds / description
      Previous value: -"Maximum spot age in seconds before the spot price is treated as stale."New value: +"Maximum spot age in seconds before the spot price is treated as stale. Default and maximum 7200 (120 min), plus a 5-minute future allowance. A stale, future-dated or untimed spot returns insufficient_data, never buy, counter or pass."
  5. Changed3 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "price": 4250,
      +    "product": "american-gold-eagle-1oz"
      +  }
      +]
    • addedInput schema / properties / spot_max_age_seconds / description
      Added value: +"Maximum spot age in seconds before the spot price is treated as stale."
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "all_in": {
      -        "type": "object"
      -      },
      -      "as_of": {
      -        "type": "string"
      -      },
      -      "asking_price_basis": {
      -        "const": "per_unit"
      -      },
      -      "customization": {
      -        "type": "string"
      -      },
      -      "data_sources": {
      -        "additionalProperties": true,
      -        "type": "object"
      -      },
      -      "decision": {
      -        "enum": [
      -          "buy",
      -          "counter",
      -          "pass",
      -          "insufficient_data"
      -        ]
      -      },
      -      "decision_basis": {
      -        "enum": [
      -          "melt_screen",
      -          "all_in",
      -          "market_cap",
      -          "none"
      -        ]
      -      },
      -      "disclaimer": {
      -        "type": "string"
      -      },
      -      "execution_mode": {
      -        "enum": [
      -          "caller_supplied_stateless",
      -          "bpc_live_and_caller"
      -        ]
      -      },
      -      "freshness": {
      -        "required": [
      -          "stale"
      -        ],
      -        "type": "object"
      -      },
      -      "market_evidence": {
      -        "type": "object"
      -      },
      -      "melt_screen": {
      -        "type": "object"
      -      },
      -      "no_accuracy_guarantee": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true
      -      },
      -      "plausibility": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "pct_below_melt": {
      -            "type": "number"
      -          },
      -          "plausible": {
      -            "type": "boolean"
      -          },
      -          "status": {
      -            "enum": [
      -              "ok",
      -              "warning_below_spot"
      -            ]
      -          },
      -          "warning": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "status",
      -          "plausible",
      -          "pct_below_melt",
      -          "warning"
      -        ],
      -        "type": "object"
      -      },
      -      "policy_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "screen_note": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "as_of",
      -      "disclaimer",
      -      "no_accuracy_guarantee",
      -      "decision",
      -      "decision_basis",
      -      "policy_id",
      -      "asking_price_basis",
      -      "melt_screen",
      -      "all_in",
      -      "market_evidence",
      -      "screen_note"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "customization": {
      -        "type": "string"
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "const": "INVALID_INPUT"
      -          },
      -          "diagnostics": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "blocks_eligibility": {
      -                  "type": "boolean"
      -                },
      -                "blocks_validity": {
      -                  "type": "boolean"
      -                },
      -                "code": {
      -                  "type": "string"
      -                },
      -                "field": {
      -                  "type": "string"
      -                },
      -                "message": {
      -                  "type": "string"
      -                },
      -                "severity": {
      -                  "enum": [
      -                    "error",
      -                    "warning",
      -                    "info"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "severity",
      -                "field",
      -                "message",
      -                "blocks_validity",
      -                "blocks_eligibility"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "message": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "diagnostics"
      -        ],
      -        "type": "object"
      -      },
      -      "execution_mode": {
      -        "const": "caller_supplied_stateless"
      -      },
      -      "ok": {
      -        "const": false
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "all_in": {
      +        "type": "object"
      +      },
      +      "as_of": {
      +        "type": "string"
      +      },
      +      "asking_price_basis": {
      +        "const": "per_unit"
      +      },
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "data_sources": {
      +        "additionalProperties": true,
      +        "type": "object"
      +      },
      +      "decision": {
      +        "enum": [
      +          "buy",
      +          "counter",
      +          "pass",
      +          "insufficient_data"
      +        ]
      +      },
      +      "decision_basis": {
      +        "enum": [
      +          "melt_screen",
      +          "all_in",
      +          "market_cap",
      +          "none"
      +        ]
      +      },
      +      "disclaimer": {
      +        "type": "string"
      +      },
      +      "execution_mode": {
      +        "enum": [
      +          "caller_supplied_stateless",
      +          "bpc_live_and_caller"
      +        ]
      +      },
      +      "freshness": {
      +        "required": [
      +          "stale"
      +        ],
      +        "type": "object"
      +      },
      +      "market_evidence": {
      +        "type": "object"
      +      },
      +      "melt_screen": {
      +        "type": "object"
      +      },
      +      "no_accuracy_guarantee": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true
      +      },
      +      "plausibility": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "pct_below_melt": {
      +            "type": "number"
      +          },
      +          "plausible": {
      +            "type": "boolean"
      +          },
      +          "status": {
      +            "enum": [
      +              "ok",
      +              "warning_below_spot"
      +            ]
      +          },
      +          "warning": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "status",
      +          "plausible",
      +          "pct_below_melt",
      +          "warning"
      +        ],
      +        "type": "object"
      +      },
      +      "policy_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "reason": {
      +        "type": "string"
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "screen_note": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "as_of",
      +      "disclaimer",
      +      "no_accuracy_guarantee",
      +      "decision",
      +      "decision_basis",
      +      "policy_id",
      +      "asking_price_basis",
      +      "melt_screen",
      +      "all_in",
      +      "market_evidence",
      +      "screen_note"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "const": "INVALID_INPUT"
      +          },
      +          "diagnostics": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "blocks_eligibility": {
      +                  "type": "boolean"
      +                },
      +                "blocks_validity": {
      +                  "type": "boolean"
      +                },
      +                "code": {
      +                  "type": "string"
      +                },
      +                "field": {
      +                  "type": "string"
      +                },
      +                "message": {
      +                  "type": "string"
      +                },
      +                "severity": {
      +                  "enum": [
      +                    "error",
      +                    "warning",
      +                    "info"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "code",
      +                "severity",
      +                "field",
      +                "message",
      +                "blocks_validity",
      +                "blocks_eligibility"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "diagnostics"
      +        ],
      +        "type": "object"
      +      },
      +      "execution_mode": {
      +        "const": "caller_supplied_stateless"
      +      },
      +      "ok": {
      +        "const": false
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "all_in": {
      -        "type": "object"
      -      },
      -      "as_of": {
      -        "type": "string"
      -      },
      -      "asking_price_basis": {
      -        "const": "per_unit"
      -      },
      -      "customization": {
      -        "type": "string"
      -      },
      -      "data_sources": {
      -        "additionalProperties": true,
      -        "type": "object"
      -      },
      -      "decision": {
      -        "enum": [
      -          "buy",
      -          "counter",
      -          "pass",
      -          "insufficient_data"
      -        ]
      -      },
      -      "decision_basis": {
      -        "enum": [
      -          "melt_screen",
      -          "all_in",
      -          "market_cap",
      -          "none"
      -        ]
      -      },
      -      "disclaimer": {
      -        "type": "string"
      -      },
      -      "execution_mode": {
      -        "enum": [
      -          "caller_supplied_stateless",
      -          "bpc_live_and_caller"
      -        ]
      -      },
      -      "market_evidence": {
      -        "type": "object"
      -      },
      -      "melt_screen": {
      -        "type": "object"
      -      },
      -      "no_accuracy_guarantee": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true
      -      },
      -      "plausibility": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "pct_below_melt": {
      -            "type": "number"
      -          },
      -          "plausible": {
      -            "type": "boolean"
      -          },
      -          "status": {
      -            "enum": [
      -              "ok",
      -              "warning_below_spot"
      -            ]
      -          },
      -          "warning": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "status",
      -          "plausible",
      -          "pct_below_melt",
      -          "warning"
      -        ],
      -        "type": "object"
      -      },
      -      "policy_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "screen_note": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "as_of",
      -      "disclaimer",
      -      "no_accuracy_guarantee",
      -      "decision",
      -      "decision_basis",
      -      "policy_id",
      -      "asking_price_basis",
      -      "melt_screen",
      -      "all_in",
      -      "market_evidence",
      -      "screen_note"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "customization": {
      -        "type": "string"
      -      },
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "const": "INVALID_INPUT"
      -          },
      -          "diagnostics": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "blocks_eligibility": {
      -                  "type": "boolean"
      -                },
      -                "blocks_validity": {
      -                  "type": "boolean"
      -                },
      -                "code": {
      -                  "type": "string"
      -                },
      -                "field": {
      -                  "type": "string"
      -                },
      -                "message": {
      -                  "type": "string"
      -                },
      -                "severity": {
      -                  "enum": [
      -                    "error",
      -                    "warning",
      -                    "info"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "severity",
      -                "field",
      -                "message",
      -                "blocks_validity",
      -                "blocks_eligibility"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "message": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "diagnostics"
      -        ],
      -        "type": "object"
      -      },
      -      "execution_mode": {
      -        "const": "caller_supplied_stateless"
      -      },
      -      "ok": {
      -        "const": false
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "all_in": {
      +        "type": "object"
      +      },
      +      "as_of": {
      +        "type": "string"
      +      },
      +      "asking_price_basis": {
      +        "const": "per_unit"
      +      },
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_sources": {
      +        "additionalProperties": true,
      +        "type": "object"
      +      },
      +      "decision": {
      +        "enum": [
      +          "buy",
      +          "counter",
      +          "pass",
      +          "insufficient_data"
      +        ]
      +      },
      +      "decision_basis": {
      +        "enum": [
      +          "melt_screen",
      +          "all_in",
      +          "market_cap",
      +          "none"
      +        ]
      +      },
      +      "disclaimer": {
      +        "type": "string"
      +      },
      +      "execution_mode": {
      +        "enum": [
      +          "caller_supplied_stateless",
      +          "bpc_live_and_caller"
      +        ]
      +      },
      +      "freshness": {
      +        "required": [
      +          "stale"
      +        ],
      +        "type": "object"
      +      },
      +      "market_evidence": {
      +        "type": "object"
      +      },
      +      "melt_screen": {
      +        "type": "object"
      +      },
      +      "no_accuracy_guarantee": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true
      +      },
      +      "plausibility": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "pct_below_melt": {
      +            "type": "number"
      +          },
      +          "plausible": {
      +            "type": "boolean"
      +          },
      +          "status": {
      +            "enum": [
      +              "ok",
      +              "warning_below_spot"
      +            ]
      +          },
      +          "warning": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "status",
      +          "plausible",
      +          "pct_below_melt",
      +          "warning"
      +        ],
      +        "type": "object"
      +      },
      +      "policy_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "reason": {
      +        "type": "string"
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "screen_note": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "as_of",
      +      "disclaimer",
      +      "no_accuracy_guarantee",
      +      "decision",
      +      "decision_basis",
      +      "policy_id",
      +      "asking_price_basis",
      +      "melt_screen",
      +      "all_in",
      +      "market_evidence",
      +      "screen_note"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "customization": {
      +        "type": "string"
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "const": "INVALID_INPUT"
      +          },
      +          "diagnostics": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "blocks_eligibility": {
      +                  "type": "boolean"
      +                },
      +                "blocks_validity": {
      +                  "type": "boolean"
      +                },
      +                "code": {
      +                  "type": "string"
      +                },
      +                "field": {
      +                  "type": "string"
      +                },
      +                "message": {
      +                  "type": "string"
      +                },
      +                "severity": {
      +                  "enum": [
      +                    "error",
      +                    "warning",
      +                    "info"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "code",
      +                "severity",
      +                "field",
      +                "message",
      +                "blocks_validity",
      +                "blocks_eligibility"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "diagnostics"
      +        ],
      +        "type": "object"
      +      },
      +      "execution_mode": {
      +        "const": "caller_supplied_stateless"
      +      },
      +      "ok": {
      +        "const": false
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  7. Changed31 schema fields changed
    • addedInput schema / properties / as_of / description
      Added value: +"Evaluation timestamp (ISO-8601). Defaults to live BPC refresh."
    • addedInput schema / properties / as_of / format
      Added value: +"date-time"
    • removedInput schema / properties / as_of / maxLength
      Removed value: -40
    • changedInput schema / properties / asking_price / description
      Previous value: -"Per-unit asking price. Thresholds come from policy, not from built-in dollar amounts."New value: +"Per-unit asking price {amount, currency} or pass price / offer_usd in USD."
    • changedInput schema / properties / costs / description
      Previous value: -"Each cost is status known or status unknown. Unknown stays unknown."New value: +"Optional full costs object. Defaults to known $0.00 shipping/fees/other."
    • addedInput schema / properties / fees_usd
      Added value: +{
      +  "description": "Optional fees in USD (defaults to 0 when costs is omitted).",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • addedInput schema / properties / karat
      Added value: +{
      +  "description": "Gold karat for custom/scrap items.",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • addedInput schema / properties / metal / description
      Added value: +"Metal (inferred automatically when a tracked BPC product is given)."
    • addedInput schema / properties / metal / type
      Added value: +"string"
    • addedInput schema / properties / offer_usd
      Added value: +{
      +  "description": "Alias for price: per-unit asking/offer price in USD.",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • addedInput schema / properties / other_usd
      Added value: +{
      +  "description": "Optional other cost in USD (defaults to 0 when costs is omitted).",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • addedInput schema / properties / policy / description
      Added value: +"Optional policy bands. Defaults to live BPC dealer ask median/range bands."
    • addedInput schema / properties / price
      Added value: +{
      +  "description": "Shorthand per-unit asking price in USD.",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • removedInput schema / properties / product / $ref
      Removed value: -"#/$defs/product"
    • addedInput schema / properties / product / description
      Added value: +"Tracked BPC product slug/name (e.g. \"american-gold-eagle-1oz\") or full product spec object."
    • addedInput schema / properties / product / type
      Added value: +[
      +  "object",
      +  "string"
      +]
    • addedInput schema / properties / purity
      Added value: +{
      +  "description": "Fineness fraction (0-1) for custom/scrap items.",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • removedInput schema / properties / quantity / $ref
      Removed value: -"#/$defs/decimal"
    • addedInput schema / properties / quantity / description
      Added value: +"Quantity of units (defaults to \"1\")."
    • addedInput schema / properties / quantity / type
      Added value: +[
      +  "string",
      +  "number",
      +  "integer"
      +]
    • addedInput schema / properties / shipping_usd
      Added value: +{
      +  "description": "Optional shipping cost in USD (defaults to 0 when costs is omitted).",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • removedInput schema / properties / spot / additionalProperties
      Removed value: -false
    • addedInput schema / properties / spot / description
      Added value: +"Optional spot override (USD/ozt or full spot object). Defaults to live BPC spot."
    • removedInput schema / properties / spot / properties
      Removed value: -{
      -  "as_of": {
      -    "maxLength": 40,
      -    "type": "string"
      -  },
      -  "price_per_fine_ozt": {
      -    "$ref": "#/$defs/money"
      -  },
      -  "source": {
      -    "$ref": "#/$defs/identifier"
      -  }
      -}
    • removedInput schema / properties / spot / required
      Removed value: -[
      -  "price_per_fine_ozt",
      -  "source",
      -  "as_of"
      -]
    • changedInput schema / properties / spot / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "number",
      +  "string"
      +]
    • addedInput schema / properties / spot_asof
      Added value: +{
      +  "description": "Optional ISO timestamp for caller spot override.",
      +  "type": "string"
      +}
    • addedInput schema / properties / unit
      Added value: +{
      +  "description": "Weight unit for custom/scrap items.",
      +  "enum": [
      +    "ozt",
      +    "g",
      +    "dwt"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / weight
      Added value: +{
      +  "description": "Optional gross weight for custom/scrap items.",
      +  "type": [
      +    "number",
      +    "string"
      +  ]
      +}
    • removedInput schema / required
      Removed value: -[
      -  "as_of",
      -  "asking_price",
      -  "quantity",
      -  "metal",
      -  "product",
      -  "spot",
      -  "costs",
      -  "policy"
      -]
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "all_in": {
      -        "type": "object"
      -      },
      -      "as_of": {
      -        "type": "string"
      -      },
      -      "asking_price_basis": {
      -        "const": "per_unit"
      -      },
      -      "decision": {
      -        "enum": [
      -          "buy",
      -          "counter",
      -          "pass",
      -          "insufficient_data"
      -        ]
      -      },
      -      "decision_basis": {
      -        "enum": [
      -          "melt_screen",
      -          "all_in",
      -          "market_cap",
      -          "none"
      -        ]
      -      },
      -      "disclaimer": {
      -        "type": "string"
      -      },
      -      "execution_mode": {
      -        "const": "caller_supplied_stateless"
      -      },
      -      "market_evidence": {
      -        "type": "object"
      -      },
      -      "melt_screen": {
      -        "type": "object"
      -      },
      -      "no_accuracy_guarantee": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true
      -      },
      -      "policy_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "screen_note": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "as_of",
      -      "disclaimer",
      -      "no_accuracy_guarantee",
      -      "decision",
      -      "decision_basis",
      -      "policy_id",
      -      "asking_price_basis",
      -      "melt_screen",
      -      "all_in",
      -      "market_evidence",
      -      "screen_note"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "const": "INVALID_INPUT"
      -          },
      -          "diagnostics": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "blocks_eligibility": {
      -                  "type": "boolean"
      -                },
      -                "blocks_validity": {
      -                  "type": "boolean"
      -                },
      -                "code": {
      -                  "type": "string"
      -                },
      -                "field": {
      -                  "type": "string"
      -                },
      -                "message": {
      -                  "type": "string"
      -                },
      -                "severity": {
      -                  "enum": [
      -                    "error",
      -                    "warning",
      -                    "info"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "severity",
      -                "field",
      -                "message",
      -                "blocks_validity",
      -                "blocks_eligibility"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "message": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "diagnostics"
      -        ],
      -        "type": "object"
      -      },
      -      "execution_mode": {
      -        "const": "caller_supplied_stateless"
      -      },
      -      "ok": {
      -        "const": false
      -      },
      -      "schema_version": {
      -        "const": "1.0.0"
      -      },
      -      "tool": {
      -        "const": "fair_offer_check"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "tool",
      -      "schema_version",
      -      "execution_mode",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "all_in": {
      +        "type": "object"
      +      },
      +      "as_of": {
      +        "type": "string"
      +      },
      +      "asking_price_basis": {
      +        "const": "per_unit"
      +      },
      +      "customization": {
      +        "type": "string"
      +      },
      +      "data_sources": {
      +        "additionalProperties": true,
      +        "type": "object"
      +      },
      +      "decision": {
      +        "enum": [
      +          "buy",
      +          "counter",
      +          "pass",
      +          "insufficient_data"
      +        ]
      +      },
      +      "decision_basis": {
      +        "enum": [
      +          "melt_screen",
      +          "all_in",
      +          "market_cap",
      +          "none"
      +        ]
      +      },
      +      "disclaimer": {
      +        "type": "string"
      +      },
      +      "execution_mode": {
      +        "enum": [
      +          "caller_supplied_stateless",
      +          "bpc_live_and_caller"
      +        ]
      +      },
      +      "market_evidence": {
      +        "type": "object"
      +      },
      +      "melt_screen": {
      +        "type": "object"
      +      },
      +      "no_accuracy_guarantee": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true
      +      },
      +      "plausibility": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "pct_below_melt": {
      +            "type": "number"
      +          },
      +          "plausible": {
      +            "type": "boolean"
      +          },
      +          "status": {
      +            "enum": [
      +              "ok",
      +              "warning_below_spot"
      +            ]
      +          },
      +          "warning": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "status",
      +          "plausible",
      +          "pct_below_melt",
      +          "warning"
      +        ],
      +        "type": "object"
      +      },
      +      "policy_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "reason": {
      +        "type": "string"
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "screen_note": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "as_of",
      +      "disclaimer",
      +      "no_accuracy_guarantee",
      +      "decision",
      +      "decision_basis",
      +      "policy_id",
      +      "asking_price_basis",
      +      "melt_screen",
      +      "all_in",
      +      "market_evidence",
      +      "screen_note"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "customization": {
      +        "type": "string"
      +      },
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "const": "INVALID_INPUT"
      +          },
      +          "diagnostics": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "blocks_eligibility": {
      +                  "type": "boolean"
      +                },
      +                "blocks_validity": {
      +                  "type": "boolean"
      +                },
      +                "code": {
      +                  "type": "string"
      +                },
      +                "field": {
      +                  "type": "string"
      +                },
      +                "message": {
      +                  "type": "string"
      +                },
      +                "severity": {
      +                  "enum": [
      +                    "error",
      +                    "warning",
      +                    "info"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "code",
      +                "severity",
      +                "field",
      +                "message",
      +                "blocks_validity",
      +                "blocks_eligibility"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "diagnostics"
      +        ],
      +        "type": "object"
      +      },
      +      "execution_mode": {
      +        "const": "caller_supplied_stateless"
      +      },
      +      "ok": {
      +        "const": false
      +      },
      +      "schema_version": {
      +        "const": "1.0.0"
      +      },
      +      "tool": {
      +        "const": "fair_offer_check"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "tool",
      +      "schema_version",
      +      "execution_mode",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  8. Added

TDQS

B3/5.0
Behavior3/5

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

Annotations already declare the tool as read-only, idempotent, and non-destructive, lowering the disclosure burden. The description adds useful behavioral context by naming the three decision outcomes and conditional counter/walk-away prices, but it leaves the policy-band logic and handling of missing policy or spot data unexplained.

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?

The description is two sentences plus a short example, front-loaded with the core purpose and outcome. There is no unnecessary wording, and the example earns its place by clarifying input shape.

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

Completeness2/5

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

This is a complex 19-parameter tool with nested policy, cost, and market-evidence objects and no output schema. The description gives the high-level purpose and return decision, but it is far too thin to guide correct invocation across the policy and cost parameters.

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

Parameters2/5

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

Schema description coverage is 0% across 19 parameters, so the description must compensate. It only illustrates 'product' and 'price' via an example and does not explain the many other parameters such as policy, costs, spot, metal, karat, or weight.

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

Purpose4/5

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

The description states a specific verb and resource: 'Screen an asking price against spot, melt and policy bands' and gives the decision outcomes. It is clear what the tool does, but it does not explicitly differentiate itself from siblings like quote or premium_over_spot.

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

Usage Guidelines2/5

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

There is no explicit when-to-use guidance or comparison to alternatives. The phrase 'Screen an asking price' implies the general context, but it does not say when to choose this tool over related pricing or melt tools.

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.

Resources