# goldprice.dev MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/dev-goldprice-mcp
- Website: https://goldprice.dev

## Install
- Endpoint: https://api.goldprice.dev/v1/mcp/
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.goldprice.dev/v1/mcp/

## Tools
- get_spot_price (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. Endpoint: https://api.goldprice.dev/v1/mcp/
- list_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. Endpoint: https://api.goldprice.dev/v1/mcp/
- get_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. Endpoint: https://api.goldprice.dev/v1/mcp/
- get_carat (Get Karat-Gram Gold Prices) - 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). Endpoint: https://api.goldprice.dev/v1/mcp/
- get_historical (Get Historical Prices) - 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). Endpoint: https://api.goldprice.dev/v1/mcp/
- search_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. Endpoint: https://api.goldprice.dev/v1/mcp/
- get_forward_view (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. Endpoint: https://api.goldprice.dev/v1/mcp/
- get_physical_price (Get Physical Dealer Gold Prices) - 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. Endpoint: https://api.goldprice.dev/v1/mcp/

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: dev.goldprice
- Version: 1.0.3
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 7, 2026
- Source: https://registry.modelcontextprotocol.io