goldprice.dev

dev.goldprice由 goldprice.dev 發布官方發布者v1.0.4更新於 Oct 24, 2026

Gold, silver and copper spot, 31 currencies, per-country dealer prices and nine MCP tools.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

一個遠端 MCP 伺服器,讓助理取得黃金、白銀與銅的現貨價格、歷史 K 線、依純度計價的金價以及經銷商報價。

可以做什麼
它透過遠端 HTTP 端點提供九個工具。get_spot_price 回傳某個品種的最新現貨或期貨價格,list_commodities 列出支援的品種,get_historical 回傳從一分鐘到一天間隔的 OHLCV K 線。get_carat 依純度給出多種貨幣的每公克金價,get_physical_price 回傳依國家劃分的經銷商報價,get_forward_view 回傳期貨結算曲線,get_metadata 提供來源與方法說明,search_docs 檢索常見問題語料,start_checkout 開啟某個方案的 Stripe 帳單連結。
適用情境
當助理需要目前或歷史貴金屬與銅價、首飾級依純度金價、實體經銷商報價或期貨隱含曲線時使用,例如用於市場摘要或需要記錄資料來源的報告。
執行需求
透過 streamable HTTP 存取 api.goldprice.dev 遠端端點;未宣告任何套件、環境變數或請求標頭。未宣告身分驗證,因此可以無金鑰呼叫,但 API 金鑰所屬方案決定歷史深度與資料延遲。需要能存取該端點的網路。
安裝前請注意
免費與無金鑰呼叫者取得的價格延遲 15 分鐘,歷史深度取決於 API 金鑰綁定的方案。start_checkout 會開啟 Stripe Checkout 或帳單入口連結,並一定先請使用者確認方案;它可能導致付費訂閱。價格僅供參考的市場資料,不構成建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 goldprice.dev,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/dev.goldprice%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "goldprice-dev": {
      "type": "http",
      "url": "https://api.goldprice.dev/v1/mcp"
    }
  }
}

工具

9

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.

輸入參數plan必填

get_spot_price

Get Spot Price

Return the latest 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. Free and keyless callers get the price 15 minutes late; bid/ask are null when no quote is available. `is_stale` is true when aggregator detected source divergence or stale FX.

輸入參數symbol必填

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.

無需輸入參數。

get_metadata

Get Metadata

Return provenance metadata for a symbol: the serving source, unit, methodology URL, staleness rules. Use for attribution and to document data lineage in downstream reports.

輸入參數symbol必填

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 plus EGP, NPR, PKR and VND). Jewelry-grade pricing computed from XAU spot and exchangerate.dev 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).

輸入參數currency

get_historical

Get Historical Prices

Return OHLCV bar history for a symbol at 1m, 5m, 15m, 30m, 1h, 2h, 4h, or 1d (default). Plus includes 1h and 4h bars for the last 30 days; Pro includes 1m to 4h bars. 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; Plus and Pro unlock 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).

輸入參數limitsymbol必填to_date必填intervalfrom_date必填

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.

輸入參數limitquery必填

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.

輸入參數asset必填

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, MY, AE, JP). Uncovered countries return unknown_country on every plan. Requires Basic or higher; static sample responses for evaluation are in the docs at https://goldprice.dev/docs/physical.

輸入參數country必填

版本歷史

2
  1. v1.0.4最新Oct 10, 2026
  2. v1.0.3Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。