goldprice.dev
Gold/silver/copper spot & futures, per-country dealer prices, options-implied probability surface.
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainget_forward_view에서
- MEDIUMTool description contains URL to non-standard domainget_physical_price에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"mcp": {
"url": "https://api.goldprice.dev/v1/mcp"
}
}
}원격 엔드포인트
https://api.goldprice.dev/v1/mcpstreamable-httphttps://api.goldprice.dev/v1/mcp/streamable-http할 수 있는 일
도구 목록
도구 (9)
⚪start_checkout(plan)
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",
"properties": {
"plan": {
"enum": [
"physical",
"pro",
"realtime"
],
"type": "string"
}
},
"required": [
"plan"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}🟢get_spot_price(symbol)
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",
"properties": {
"symbol": {
"type": "string"
}
},
"required": [
"symbol"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}🟢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
}🟢get_metadata(symbol)
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",
"properties": {
"symbol": {
"type": "string"
}
},
"required": [
"symbol"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}🟢get_carat(currency)
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": {
"default": "USD",
"type": "string"
}
},
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}🟢get_historical(symbol, from_date, to_date, limit, interval)
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",
"properties": {
"symbol": {
"type": "string"
},
"from_date": {
"type": "string"
},
"to_date": {
"type": "string"
},
"limit": {
"default": 100,
"type": "integer"
},
"interval": {
"default": "1d",
"enum": [
"1m",
"5m",
"15m",
"30m",
"1h",
"2h",
"4h",
"1d"
],
"type": "string"
}
},
"required": [
"symbol",
"from_date",
"to_date"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}🟢search_docs(query, limit)
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",
"properties": {
"query": {
"type": "string"
},
"limit": {
"default": 5,
"type": "integer"
}
},
"required": [
"query"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}🟢get_forward_view(asset)
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",
"properties": {
"asset": {
"type": "string"
}
},
"required": [
"asset"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}🟢get_physical_price(country)
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",
"properties": {
"country": {
"type": "string"
}
},
"required": [
"country"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}커뮤니티
증거