API and MCP changelog

Entries

• 2026-11-11: MCP server version 2.1.0. 24k gold is priced at a purity of 1.0 (24/24) in melt and scrap tools, and the public scrap gold price page matches that figure. Quote tools use the same karat purity rule as melt_value. The Google Trends warning no longer names an unofficial library. dealer_scrap_intake_quote requires payout_pct (there is no default; Bullion Price Check does not buy metal and does not set a payout rate). A 1 kg bar is valued with the exact troy-ounce factor 1,000 / 31.1034768 (shown as 32.1507) in every melt and dealer tool, including quote and fair_offer_check; spot is used at full precision and dollar amounts are rounded once, at output. In get_dealer_prices, dealers_unavailable status text no longer names a price feed and states the time limit that applies to that source. When an index row lacks any of its 7-day premium fields, get_premium_index takes the median, minimum and count together from stored hourly price history and labels the row low_pct_7d_basis: hourly_history_fallback; those can differ slightly from the index's own figures. fair_offer_check returns insufficient_data, never buy, counter or pass, when the spot is older than 120 minutes, is dated more than 5 minutes ahead, or is a caller-supplied spot with no time of its own; as_of defaults to the request time, and spot_max_age_seconds can tighten the 120-minute limit but not loosen it. bullion_sales_tax returns the New York $1,000 single-invoice threshold and a covered_states list. get_dealer_prices and list_products list tracked dealers that have no live price. dealer_competitor_position includes the rank basis (counts always; dealer names only when requested). dealer_market_report puts the snapshot timestamp in the headline. dealer_price_opportunity states the date the rolling 30-day history rule is met (history is not backfilled). inventory_aging_exposure documents that carry rate defaults to 0 under the lots shorthand.
• 2026-11-11: Follow-up fixes on the public MCP server and docs: the developers page, Dealer Price Intelligence page, llms.txt and OpenAPI now list all 27 live MCP tools, and the eight dealer_* tools are marked MCP-only (no REST endpoint). get_premium_index populates 7-day median and minimum premiums the same way as premium_over_spot. restock_plan documents the sales_observations shape {status:'recorded', entries:[{date, quantity}]}. Quote scrap melt uses the same exact karat fraction as melt_value. buyback_compare keeps the default 120-minute quote age as 7200 seconds and dates as_of at request time. Public tool text uses “Google Trends” and “one short price feed” (120- and 60-minute ranking limits). One rounding and purity rule is documented on developers and data quality: exact karat fractions, full-precision arithmetic, half-up to the cent only at display. This changelog page is the dated public record. Spot still refreshes about hourly and every spot answer carries its timestamp. BPC market figures are as of request time.
• 2026-11-11: Five dealer intelligence tools added on the MCP server (no REST endpoint): dealer_price_opportunity, dealer_bid_spread, dealer_product_demand, dealer_quote_scenarios and dealer_market_report. They are free standard tools, read-only, and use live Bullion Price Check data.
• 2026-11-10: Three dealer intelligence tools added on the MCP server (no REST endpoint): dealer_competitor_position, dealer_market_movers and dealer_scrap_intake_quote. They are free standard tools, read-only, and use live Bullion Price Check data.
• 2026-11-10: Freshness: get_premium_index is marked stale after 70 minutes (the next hourly refresh is late or was missed). Every price, calculator and dealer tool carries data_as_of. GET /mcp info answers are no longer cached by the CDN. Docs: field definitions and the versioning policy.
• 2026-11-09: Freshness labels on every price answer (freshness object: spot_asof, prices_asof, ages in minutes, stale, thresholds, 120-minute limits) and structured error codes. Per-client rate limits (HTTP 429 with Retry-After).
• 2026-11-09: MCP v2 (server 2.0.0): duplicate v1 tools merged; the four old names stay as deprecated aliases that return deprecated: true and a deprecation_note. Dealer tools read live Bullion Price Check data; stored hourly and daily price history (get_price_history).
• 2026-11-08: Six stateless dealer valuation and operations tools. Google Trends snapshot tool (bullion_trends_snapshot, GET /api/v1/trends-snapshot). Security headers and request size limits on /api/v1 and /mcp.
• 2026-11-01: State sales tax on bullion: GET /api/v1/sales-tax and bullion_sales_tax (server 1.1.0).
• 2026-10-31: Product matching never substitutes a different weight; an untracked product returns the closest tracked products instead.
• 2026-10-30: First release: public REST API (/api/v1), remote MCP server (/mcp) and the developers page.

Internal test results

Internal automated suites for this release passed. These are this repository's own tests, not a third-party audit.