GoldAPI Precious Metals Quotes

GoldAPI MCP — AI アシスタント向け貴金属相場

GoldAPI MCP は、AI アシスタント（Claude、Cursor、WorkBuddy、Cline など）がリアルタイムおよび過去の貴金属相場（金、銀、プラチナ、パラジウム）を照会できる MCP サーバーです。上海黄金交易所、NYMEX／COMEX、ロンドン市場の現物および先物に対応しています。

• エンドポイント（Streamable HTTP）： https://www.gold-api.cn/mcp
• 認証： Authorization: Bearer YOUR_APPKEY（https://www.gold-api.cn/ で無料キーを取得すると、5,000 回まで無料で利用できます）
• ドキュメント： https://www.gold-api.cn/docs.php（「MCP 接入」セクションを参照）
• サービスステータス： https://www.gold-api.cn/status.php

ツール

ツール	説明	課金
list_varieties	上場しているすべての銘柄を、goldId、名称、市場、カテゴリーとともに一覧表示します	無料
get_realtime	リアルタイム相場（最終価格、変動、売値／買値、高値／安値）を取得します。カンマ区切りの goldid に対応し、1 回の呼び出しで最大 50 銘柄を指定できます	1 回分
get_history	2026-05-27 からの時間足 OHLCV 履歴を昇順で取得します。リクエストあたり最大 92 日分です	1 回分
get_kline	直近 N 日分の日足 OHLC ローソク足を取得します（デフォルト 30 日、最大 60 日）	無料

課金には、REST API と同じ 3 つのチャネル（銘柄ごと／メンバーシップ／無料付与）を使用します。 有料ツールの結果には、チャネルと残りの利用枠を含む billing オブジェクトが含まれるため、 アシスタントはユーザーに利用状況を報告できます。

インストール

Claude Code

claude mcp add --transport http goldapi https://www.gold-api.cn/mcp \
  --header "Authorization: Bearer YOUR_APPKEY"

Claude Desktop / Cursor / WorkBuddy（mcpServers JSON）

{
  "mcpServers": {
    "goldapi": {
      "url": "https://www.gold-api.cn/mcp",
      "headers": { "Authorization": "Bearer YOUR_APPKEY" }
    }
  }
}

プロンプトの例

• 「GoldAPI で金の現物と銀 T+D の最新価格を調べてください」
• 「金の現物（goldId 1061）について、直近 30 日分の日足ローソク足を表示してください。」

注意事項

• 対応するプロトコルのバージョン：2025-06-18、2025-03-26、2024-11-05（ステートレスな Streamable HTTP）。
• 有料ツールの利用には有効な appkey が必要です。get_realtime では 1 回の呼び出しで最大 50 銘柄を照会できます（1 回分としてカウントされます）。
• 無料プランのアカウントには、登録時に 5,000 回分の無料利用枠が付与されます：https://www.gold-api.cn/pricing.php