mcpbeat

goldprice.dev MCP Server

dev.goldprice/mcp
answering

goldprice.dev is answering right now. Last checked 2 min ago. It exposes 8 tools.

Gold/silver/copper spot & futures, per-country dealer prices, options-implied probability surface.

Uptime history 41 hours of history
41 hours agonow
100.0%
Uptime 24h
92 of 92 checks
8
Tools
read from the server
683 ms
Response time
average over 24h
open, no key
Access
streamable-http

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 2 min ago.

run in your terminal
claude mcp add mcp --transport http https://api.goldprice.dev/v1/mcp/
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.goldprice.dev/v1/mcp/"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp]
url = "https://api.goldprice.dev/v1/mcp/"
.cursor/mcp.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.goldprice.dev/v1/mcp/"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.goldprice.dev/v1/mcp/"
    }
  }
}

Available tools 8

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

carat
get_carat
Return per-gram gold (XAU) prices by karat purity — 24k, 22k, 21k, 20k, 18k, 16k, 14k, 10k — in a requested currency (default USD; the same 31 currencies get_spot_price serves). Jewelry-grade pricing computed from live XAU spot + ECB FX. FREE on every tier — no plan gate. Values are Decimal-formatted strings, quantized to the currency's ISO 4217 minor unit (JPY → whole numbers, USD → 2dp).
commodities
list_commodities
Return the full list of symbols served by this API. Use before get_spot_price / get_historical / get_metadata when you don't know which symbols are supported.
docs
search_docs
Search the goldprice.dev FAQ corpus via BM25. Returns top-K matching questions + answers with relevance scores. Use before answering how-to / billing / auth questions so you cite the canonical text instead of guessing from training data.
forward
get_forward_view
Returns the multi-horizon futures settlement curve for a commodity (XAU, XAG, HG). Every populated horizon up to one year forward. Useful for bot builders and traders seeing the futures-implied path. See https://goldprice.dev/methodology#forward-view-layers for per-layer math.
historical
get_historical
Return daily OHLCV bar history for a symbol. History depth is set automatically by your API key's plan — do NOT pass a tier argument (there is none): Free sees the last 30 days; Basic sees the last year; Pro unlocks full history back to 1996 (XAU/USD). Dates must be ISO 8601 (YYYY-MM-DD). Returns bars in date-descending order. volume is null for spot instruments (XAU/USD, XAG/USD); real for futures (GC, SI, HG) and ETFs (GLD).
metadata
get_metadata
Return provenance metadata for a symbol: aggregated sources, unit, methodology URL, staleness rules. Use for attribution and to document data lineage in downstream reports.
physical
get_physical_price
Return the latest per-country physical dealer/retail gold prices — real quotes from dealers, mints, and bullion benchmarks, NOT spot-derived arithmetic — with nullable premium_over_spot_bps per quote (null when live reference inputs are unavailable). `country` is an ISO 3166-1 alpha-2 code (e.g. ID, IN, AE, JP). Requires the Physical tier or higher; static sample responses for evaluation are in the docs at https://goldprice.dev/docs/physical.
spot
get_spot_price
Return the latest aggregated spot (or GC futures) price for one symbol. Price is a Decimal-formatted string; `is_stale` is true when aggregator detected source divergence or stale FX.

Endpoints

URLTransportStateLatencyChecked
https://api.goldprice.dev/v1/mcp/ streamable-http answering 316 ms 2 min ago

goldprice.dev — questions

Answers built from our own checks of this server.

What can goldprice.dev do?
It exposes 8 tools, read directly from the server on our last check. Among them: get_carat, get_forward_view, get_historical, get_metadata, get_physical_price, get_spot_price and 2 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is goldprice.dev working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 683 ms. The bar chart above shows every period we have measured.
How do I connect goldprice.dev?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does goldprice.dev need an API key?
No. goldprice.dev completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 8 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is goldprice.dev?
It answers our handshake in 683 ms on average, which is faster than 12% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.