Skip to main content
Glama

Dealer buy/sell quote from spot

quote
Read-onlyIdempotent

Price a dealer buy or sell ticket from the latest BPC spot (or caller-supplied spot override). Supports bullion (tracked products) and scrap (weight + unit + karat or purity; purity applied once). Includes default buy offer tiers (% of melt), sell margin rules, market ask percentiles, and published buyback bid benchmarks when available. Standard tool free; for a version fine-tuned or customized to your business, email for pricing via https://bullionpricecheck.com/contact/.

Example tool call

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

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "side": "sell",
      "product": "american-silver-eagle-1oz",
      "margin_pct": 5
    },
    "name": "quote"
  }
}

Input Schema

NameRequiredDescriptionDefault
sideNosell = you sell to a customer; buy = you buy from a customer. Default: buy for scrap or when tier/offer_pct is given, else sell.
spotNoOptional spot price in USD per troy oz to use instead of Bullion Price Check's latest reading (gold-api.com). The answer labels it spot_source=caller.
tierNoBuy offer default tier (% of melt). Buy quotes without tier, offer_pct or margins use target.
unitNoScrap weight unit: g = gram, dwt = pennyweight, ozt = troy ounce, kg = kilogram.g
classNobullion = a tracked coin or bar (default when product is given); scrap = metal by weight and karat or purity.
karatNoScrap gold karat: 24=.999, 22=.9167, 18=.75, 14=.5833, 10=.4167 (others karat/24).
metalNoScrap metal.gold
purityNoScrap fineness as a fraction (use instead of karat; required for silver or platinum scrap).
weightNoScrap gross weight.
productNoTracked product slug from list_products (for example american-silver-eagle-1oz) or a name with its weight. A name only matches a product of the same weight.
quantityNoNumber of units (bullion) or identical scrap lots.
offer_pctNoYour own buy offer as % of melt; overrides the tier default.
spot_asofNoOptional ISO time of the spot you passed in, echoed back as spot_asof.
margin_pctNoMargin rule: percent over melt (sell) or under melt (buy). Not combined with tier/offer_pct.
margin_usdNoFlat USD per unit over melt (sell) or deducted (buy).
valid_secondsNoHow long the quote is good for; sets expires_at.

Output Schema

NameRequiredDescriptionDefault
okNo
skuNo
ruleNo
sideNo
spotNo
toolNo
classNo
errorNo
scrapNo
staleNo
termsNo
creditNo
productNo
quantityNo
roundingNo
unit_usdNo
freshnessNo
quoted_atNo
spot_asofNo
total_usdNo
data_as_ofNo
deprecatedNo
disclaimerNo
expires_atNo
source_urlNo
attributionNo
offer_tiersNo
pct_of_meltNo
premium_pctNo
spot_sourceNo
customizationNo
valid_secondsNo
canonical_toolNo
market_contextNo
melt_total_usdNo
deprecation_noteNo
buyback_benchmarkNo
melt_per_unit_usdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "margin_pct": 5,
      +    "product": "american-silver-eagle-1oz",
      +    "side": "sell"
      +  }
      +]
  2. Changed8 schema fields changed
    • changedInput schema / properties / unit / description
      Previous value: -"Scrap weight unit: g = gram, dwt = pennyweight, ozt = troy ounce."New value: +"Scrap weight unit: g = gram, dwt = pennyweight, ozt = troy ounce, kg = kilogram."
    • changedInput schema / properties / unit / enum
      Previous value: -[
      -  "g",
      -  "dwt",
      -  "ozt"
      -]New value: +[
      +  "g",
      +  "dwt",
      +  "ozt",
      +  "kg"
      +]
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "required": [
      +      "class",
      +      "quantity",
      +      "side",
      +      "rule",
      +      "spot",
      +      "spot_source",
      +      "spot_asof",
      +      "melt_per_unit_usd",
      +      "unit_usd",
      +      "total_usd",
      +      "melt_total_usd",
      +      "pct_of_melt",
      +      "premium_pct",
      +      "rounding",
      +      "quoted_at",
      +      "expires_at",
      +      "valid_seconds",
      +      "disclaimer",
      +      "attribution",
      +      "source_url",
      +      "data_as_of",
      +      "credit",
      +      "terms",
      +      "customization"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "ok",
      +      "tool",
      +      "error"
      +    ]
      +  }
      +]
    • addedOutput schema / properties / error
      Added value: +{
      +  "required": [
      +    "code",
      +    "message"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / freshness
      Added value: +{
      +  "required": [
      +    "stale"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / ok
      Added value: +{
      +  "const": false
      +}
    • addedOutput schema / properties / tool
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / required
      Removed value: -[
      -  "class",
      -  "quantity",
      -  "side",
      -  "rule",
      -  "spot",
      -  "spot_source",
      -  "spot_asof",
      -  "melt_per_unit_usd",
      -  "unit_usd",
      -  "total_usd",
      -  "melt_total_usd",
      -  "pct_of_melt",
      -  "premium_pct",
      -  "rounding",
      -  "quoted_at",
      -  "expires_at",
      -  "valid_seconds",
      -  "disclaimer",
      -  "attribution",
      -  "source_url",
      -  "data_as_of",
      -  "credit",
      -  "terms",
      -  "customization"
      -]
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "attribution": {
      +      "type": "string"
      +    },
      +    "buyback_benchmark": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "canonical_tool": {
      +      "type": "string"
      +    },
      +    "class": {
      +      "enum": [
      +        "bullion",
      +        "scrap"
      +      ]
      +    },
      +    "credit": {
      +      "type": "string"
      +    },
      +    "customization": {
      +      "type": "string"
      +    },
      +    "data_as_of": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "deprecated": {
      +      "type": "boolean"
      +    },
      +    "deprecation_note": {
      +      "type": "string"
      +    },
      +    "disclaimer": {
      +      "type": "string"
      +    },
      +    "expires_at": {
      +      "type": "string"
      +    },
      +    "market_context": {
      +      "additionalProperties": true,
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "melt_per_unit_usd": {
      +      "type": "number"
      +    },
      +    "melt_total_usd": {
      +      "type": "number"
      +    },
      +    "offer_tiers": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "pct_of_melt": {
      +      "type": "number"
      +    },
      +    "premium_pct": {
      +      "type": "number"
      +    },
      +    "product": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "metal": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "slug": {
      +          "type": "string"
      +        },
      +        "troy_oz": {
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "slug",
      +        "name",
      +        "metal",
      +        "troy_oz"
      +      ],
      +      "type": "object"
      +    },
      +    "quantity": {
      +      "type": "integer"
      +    },
      +    "quoted_at": {
      +      "type": "string"
      +    },
      +    "rounding": {
      +      "type": "string"
      +    },
      +    "rule": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "scrap": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "side": {
      +      "enum": [
      +        "buy",
      +        "sell"
      +      ]
      +    },
      +    "sku": {
      +      "type": "string"
      +    },
      +    "source_url": {
      +      "type": "string"
      +    },
      +    "spot": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "spot_asof": {
      +      "type": [
      +        "string",
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "spot_source": {
      +      "type": "string"
      +    },
      +    "stale": {
      +      "type": "string"
      +    },
      +    "terms": {
      +      "type": "string"
      +    },
      +    "total_usd": {
      +      "type": "number"
      +    },
      +    "unit_usd": {
      +      "type": "number"
      +    },
      +    "valid_seconds": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "class",
      +    "quantity",
      +    "side",
      +    "rule",
      +    "spot",
      +    "spot_source",
      +    "spot_asof",
      +    "melt_per_unit_usd",
      +    "unit_usd",
      +    "total_usd",
      +    "melt_total_usd",
      +    "pct_of_melt",
      +    "premium_pct",
      +    "rounding",
      +    "quoted_at",
      +    "expires_at",
      +    "valid_seconds",
      +    "disclaimer",
      +    "attribution",
      +    "source_url",
      +    "data_as_of",
      +    "credit",
      +    "terms",
      +    "customization"
      +  ],
      +  "type": "object"
      +}
  4. Added

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already establish the read-only, idempotent, non-destructive, closed-world profile, so the description is not carrying the safety burden. It adds genuine context beyond that: what the quote embeds (default buy offer tiers as % of melt, sell margin rules, market ask percentiles, published buyback bid benchmarks), the nuance that purity is applied once, and the distinct spot_source=caller path. The remaining gap is expiry/validation behavior, which only surfaces indirectly via the valid_seconds parameter.

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

Conciseness3/5

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

The purpose is front-loaded in the first clause and the feature enumeration is dense but on-task. The closing sales sentence about a customized paid version is promotional and only loosely earns its place, adding noise an agent must filter when deciding to call the tool.

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 a 16-parameter tool with zero required parameters, a full output schema, and complete annotation coverage, the description does enough: it names both operating modes, the default posture, the override path, and what benchmarks appear in the result. What it lacks is sibling routing guidance, which matters given the crowded dealer_* tool family.

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% with five enums and per-field defaults, so the schema already explains most parameters and the baseline is 3. The description adds only marginal semantics on top — the caller-supplied spot override and the "purity applied once" rule — while interactions like tier vs offer_pct vs margin_pct precedence are documented in the schema, not here.

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 opens with a precise verb+resource ("Price a dealer buy or sell ticket from the latest BPC spot") and clarifies the two supported modes, bullion (tracked products) and scrap (weight + unit + karat/purity). It does not, however, distinguish itself from near siblings such as dealer_scrap_intake_quote or dealer_quote_scenarios, so an agent cannot route on this text alone.

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

Usage Guidelines3/5

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

Usage is implied rather than stated: the reader infers this is the general pricing tool that accepts an optional caller spot override. There is no explicit when-to-use/when-not-to-use guidance and no named alternative for scenario analysis or scrap intake, both of which appear as siblings.

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