MCP 服务器

goldprice.dev

dev.goldprice/mcp
数据与分析 金融与投资 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Provides spot, futures, historical, physical dealer, karat-based, and forward-view pricing data for gold, silver, and copper, with metadata and documentation search.

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).
只读
输入模式
{'type': 'object', 'properties': {'currency': {'type': 'string', 'default': 'USD'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
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.
只读
输入模式
{'type': 'object', 'required': ['asset'], 'properties': {'asset': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
get_historical
Get Historical Prices
Return OHLCV bar history for a symbol at 1m, 5m, 15m, 30m, 1h, 2h, 4h, or 1d (default). Intraday intervals require Pro. 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; Physical 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, XCU/USD); real for futures (GC, SI, HG) and ETFs (GLD).
只读
输入模式
{'type': 'object', 'required': ['symbol', 'from_date', 'to_date'], 'properties': {'limit': {'type': 'integer', 'default': 100}, 'symbol': {'type': 'string'}, 'to_date': {'type': 'string'}, 'interval': {'enum': ['1m', '5m', '15m', '30m', '1h', '2h', '4h', '1d'], 'type': 'string', 'default': '1d'}, 'from_date': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
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.
只读
输入模式
{'type': 'object', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
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.
只读
输入模式
{'type': 'object', 'required': ['country'], 'properties': {'country': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
get_spot_price
Get Spot Price
Return the latest aggregated spot (or GC futures) price for one symbol. Price is a Decimal-formatted string. Latest USD spot price/bid/ask use nearest half-up rounding: XAU 2 decimal places, XAG 3, HG 4. `is_stale` is true when aggregator detected source divergence or stale FX.
只读
输入模式
{'type': 'object', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
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.
只读
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
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.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 5}, 'query': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': True}
start_checkout
Open a direct billing URL for an explicitly selected eligible plan: a one-hour Stripe Checkout URL for Free accounts or the existing customer's Stripe billing portal. This always asks the human to confirm the same plan first; a cancellation creates nothing.
输入模式
{'type': 'object', 'required': ['plan'], 'properties': {'plan': {'enum': ['physical', 'pro', 'realtime', 'basic_2026', 'plus_2026', 'pro_2026'], 'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'additionalProperties': {'type': 'string'}}
已更改
start_checkout
2026年10月1日 02:43
已添加
get_physical_price
2026年9月17日 12:39
已添加
get_forward_view
2026年9月17日 12:39
已添加
search_docs
2026年9月17日 12:39
已添加
get_historical
2026年9月17日 12:39
已添加
get_carat
2026年9月17日 12:39
已添加
get_metadata
2026年9月17日 12:39
已添加
list_commodities
2026年9月17日 12:39
已添加
get_spot_price
2026年9月17日 12:39
已添加
start_checkout
2026年9月17日 12:39