Home › Developers
Free Bullion Price API and MCP Server
Bullion Price Check has a free, read-only API and MCP server. It gives live gold, silver and platinum spot prices, the lowest current dealer prices for the 17 coins and bars we track, and the same calculators this site uses: melt value, junk silver, scrap gold, premium over spot, true cost and the gold-silver ratio. There is no key and no sign-up. Use the REST endpoints under /api/v1/ or add the MCP server https://bullionpricecheck.com/mcp to Claude, ChatGPT or Cursor.
MCP server URL
https://bullionpricecheck.com/mcp
Streamable HTTP transport, no sign-in, 10 read-only tools. Each tool only reads data; none can buy, sell, change or delete anything.
Add it to Claude
- In Claude, open Customize › Connectors (or Settings › Connectors).
- Choose Add custom connector.
- Name it Bullion Price Check and paste
https://bullionpricecheck.com/mcpas the URL. - Under Authentication pick No sign in, then Add.
Claude Code users can run:
claude mcp add --transport http bullion-price-check https://bullionpricecheck.com/mcpAdd it to ChatGPT
- On ChatGPT on the web, open Plugins, select +, then Add custom MCP server.
- Name it Bullion Price Check and enter
https://bullionpricecheck.com/mcpas the server URL. - Choose No authentication, accept the warning, and select Create as a plugin. Install it, then type @ in a chat to use it.
Custom MCP servers depend on your ChatGPT plan and workspace settings.
Add it to Cursor
Put this in ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"bullion-price-check": {
"url": "https://bullionpricecheck.com/mcp"
}
}
}Other MCP apps: use the same URL with the Streamable HTTP transport.
Tools and endpoints
Every MCP tool has a matching GET endpoint. The full schema is at /api/v1/openapi.json.
| Tool | REST endpoint | What it returns | Same as |
|---|---|---|---|
get_spot_prices | GET /api/v1/spot | Live gold, silver and platinum spot prices in USD per troy ounce, with the time each was read and the gold-silver ratio. | Spot price today |
list_products | GET /api/v1/products | List the bullion products Bullion Price Check tracks (slug, name, metal, troy oz) with today's lowest listed dealer price for each. | Cheapest bullion |
get_dealer_prices | GET /api/v1/prices | Current listed dealer prices for one tracked product, lowest first. | Cheapest pages |
melt_value | GET /api/v1/melt-value | Melt (metal) value of any gold, silver or platinum item at live spot: weight x purity x spot. | Melt value calculator |
junk_silver_melt | GET /api/v1/junk-silver | Silver content and melt value of US junk silver coins by face value: 90% (pre-1965 dimes, quarters, halves), 40% (1965-1970 Kennedy halves or Eisenhower dollars) or 35% (1942-1945 war nickels). | Junk silver calculator |
premium_over_spot | GET /api/v1/premium | Premium over spot for a price you were quoted. | Premium checker |
true_cost | GET /api/v1/true-cost | Delivered cost of a bullion order. | True cost calculator |
gold_silver_ratio | GET /api/v1/gold-silver-ratio | Live gold-silver ratio (ounces of silver one ounce of gold buys at spot), with an optional ounce converter. | Gold-silver ratio |
scrap_gold_value | GET /api/v1/scrap-gold | Full melt value of scrap gold or jewelry by karat and weight at live gold spot (karat/24, with 24k at 99.9%). | Scrap gold calculator |
get_premium_index | GET /api/v1/premium-index | Current Bullion Premium Index: for each tracked product, the lowest premium over spot today, the dealer median premium and the 7-day median and minimum of the lowest premium. | Premium index |
Examples
# Spot prices
curl https://bullionpricecheck.com/api/v1/spot
# Lowest dealer prices for one product (slugs: /api/v1/products)
curl https://bullionpricecheck.com/api/v1/prices/american-silver-eagle-1oz
# Melt value of 1 troy oz of 90% silver
curl "https://bullionpricecheck.com/api/v1/melt-value?metal=silver&weight=1&unit=ozt&purity=0.9"
# $10 face of 90% junk silver
curl "https://bullionpricecheck.com/api/v1/junk-silver?face_value=10&coin_type=90"
# 5 grams of 14k scrap gold
curl "https://bullionpricecheck.com/api/v1/scrap-gold?karat=14&weight=5&unit=g"
# Is $58 a good price for a Silver Eagle?
curl "https://bullionpricecheck.com/api/v1/premium?price=58&product=american-silver-eagle-1oz"
# Delivered cost of 10 Silver Eagles, ranked by dealer
curl "https://bullionpricecheck.com/api/v1/true-cost?product=american-silver-eagle-1oz&quantity=10&payment=bank"The MCP server with curl
curl -s https://bullionpricecheck.com/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -s https://bullionpricecheck.com/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"melt_value","arguments":{"metal":"gold","weight":1,"unit":"ozt","purity":0.9167}}}'What a response looks like
Field layout of /api/v1/prices/american-silver-eagle-1oz (numbers left out):
{
"product": {
"slug": "american-silver-eagle-1oz",
"name": "1 oz American Silver Eagle",
"metal": "silver",
"troy_oz": 1
},
"dealers": [
{
"dealer": "Dealer name",
"price_usd": 0,
"premium_usd": 0,
"premium_pct": 0,
"checked": "ISO time",
"rank": 1
},
{
"dealer": "Dealer name",
"label": "Partner",
"price_usd": 0,
"premium_usd": 0,
"premium_pct": 0,
"checked": "ISO time",
"rank": 2
}
],
"attribution": "Bullion Price Check — https://bullionpricecheck.com/cheapest/american-silver-eagle-1oz",
"source_url": "https://bullionpricecheck.com/cheapest/american-silver-eagle-1oz",
"data_as_of": "ISO time of the price refresh",
"credit": "Data by Bullion Price Check",
"terms": "https://bullionpricecheck.com/developers/#terms"
}Every response carries attribution, source_url (the matching page on this site) and data_as_of. Errors come back as JSON with a plain message that says what to fix, for example {"error":{"code":"bad_request","message":"weight must be greater than 0."}}.
Where the data comes from
- Spot prices come from gold-api.com, read at each price refresh.
- Dealer prices are the single-unit prices our collector reads from each dealer's own product page, about every hour from 6 AM to midnight ET. Only prices checked in the last 24 hours are returned. The methodology page has the rules for dropping bad prices.
- Shipping and payment fees for the true cost tool are hand-read from each dealer's published policy page (see the fee table).
- Coin silver content (0.7234 oz per $1 face for 90% coins) is from US law and the US Mint, as on our melt value pages.
- Ranking: dealer lists are sorted by price only. A dealer labeled Partner pays to list, never to rank. The API returns no affiliate or dealer links; each answer links to the matching page on this site.
Source: the API reads the same data file this site is built from. Latest refresh at the time this page was built: Oct 31, 2026 12:45 AM ET.
Want the whole table instead of one tool at a time? Bulk files: /api/prices.json, /api/prices.csv and the Bullion Premium Index downloads.
Limits
- Please keep to about 120 requests a minute from one IP address. Heavier use can get HTTP 429 with a
Retry-Afterheader. - Prices change about once an hour, so cache answers for a few minutes. REST answers are sent with a 60-second cache header.
- CORS is open, so you can call the API from a web page.
- The API asks for no personal data and has no accounts. Requests pass through Cloudflare as described in our privacy policy.
Free-use terms
- Free for any use, including in commercial apps, sites and AI tools. No key, no fee.
- Credit is required when you display our data. Show a visible credit that reads Data by Bullion Price Check and links to bullionpricecheck.com. How you mark that link (for example
nofollow) is up to you. - Prices are information only, not advice and not an offer. Confirm price, shipping and terms on the dealer's own site before you buy.
- Don't present the data as your own or suggest that Bullion Price Check endorses your product.
- We may change or limit the API. Breaking changes will get a new version path (
/api/v2/) rather than changing/api/v1/answers.
Credit you can copy:
<p>Data by <a href="https://bullionpricecheck.com/">Bullion Price Check</a></p>Questions, a bug, or a tool you want added? Email hello@bullionpricecheck.com. Bullion Price Check compares prices; it does not sell metal. See our terms of use.