에이전트 강화
게시자의 자체 명령입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
uvx gold-mcp==4.1.2Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
GOLD_MCP_LICENSE_KEY=<secret> ANTHROPIC_API_KEY=<secret> claude mcp add io.github.thaitrevor-gold-mcp -- uvx gold-mcp==4.1.2터미널에서 실행합니다.
{ "mcpServers": { "io.github.thaitrevor-gold-mcp": { "command": "uvx", "args": [ "gold-mcp==4.1.2" ], "env": { "GOLD_MCP_LICENSE_KEY": "<secret>", "ANTHROPIC_API_KEY": "<secret>" } } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행An MCP server that brings public gold (XAUUSD) market data into Claude, ChatGPT, Cursor, Windsurf, Cline, Zed, and any other Model Context Protocol client.
Free tier (13 tools + optional 8-tool MT5 BYOK adapter) is fully functional and stays free forever. Pro, Premium, and Ultra tiers add advanced TA, backtest, SMC suite, risk management, and AI analyst via an offline Ed25519 license key — no SaaS, no phone-home.
Educational and research use only — not financial advice.
Public gold data (Yahoo Finance):
get_gold_price — latest gold close + 24h changeget_gold_ohlcv — historical bars (1m → 1mo)get_macro_context — DXY, US10Y/02Y, SPX, VIX, BTC, silver, oilget_gold_correlations — gold-vs-macro correlation matrixget_gold_seasonality — day-of-week / monthly return statsget_vn_macro — USD/VND + implied world-parity gold price in VNDestimate_vn_gold_premium — compare local VN quote to world paritygold_market_snapshot — one-call aggregator + bulleted summarydiagnostic — show license tier + available toolscache_purge — sweep expired cache entriesRealtime PAXG via Binance public WebSocket (NEW v4.1, no API key):
paxg_worker_status — WS worker health + tick countget_paxg_tick — last PAXG tick (tracks XAU/USD within 0.1-0.3%)get_paxg_ohlcv_realtime — aggregated PAXG bars from local tick logMT5 BYOK adapter (NEW v4.1, optional via pip install 'gold-mcp[mt5]', Windows):
mt5_attach / mt5_detach / mt5_status — manage attached terminalmt5_find_symbol — broker-specific XAUUSD symbol resolutionmt5_get_tick / mt5_get_ohlcv / mt5_get_ticks — read from your terminalmt5_account_info — balance / equity / leverageanalyze_gold_advanced — Bollinger + Ichimoku + Fibonaccimulti_timeframe_snapshot — 5m / 1h / 4h / 1d in one callgold_correlation_regime — detects DXY decoupling, etc.get_gold_setups — multi-indicator confluence scannercreate_gold_alert / list_gold_alerts / delete_gold_alertbacktest_gold_strategy — 4 strategies, vectorizedgold_walk_forward — rolling out-of-sample validationoptimize_gold_strategy — grid search by Sharpe / PF / returngold_intraday_seasonality — hourly / session bucketingSmart Money Concepts (SMC)
smc_full_scan — composite SMC bias (structure + OB + FVG + sweeps)detect_order_blocks — bullish/bearish OB with impulse ATR filteringdetect_fair_value_gaps — 3-candle imbalances + fill trackingdetect_liquidity_sweeps — stop-hunt detection (breach + reverse)detect_market_structure — CHOCH/BOS labeling on swing fractalsRegime + Multi-Timeframe
classify_regime — composite Hurst exponent + Lo-MacKinlay variance ratiomtf_alignment — D1/H4/H1 confluence with alignment score 0-100Position sizing + risk
kelly_fraction — half-Kelly default for safetyfixed_fractional_size — classic R% sizingoptimal_f — Ralph Vince geometric-mean-maximizing frisk_of_ruin — Monte Carlo ruin probabilityMonte Carlo + VaR
monte_carlo_paths — bootstrap or parametric path simulationvalue_at_risk — historical VaR + Conditional VaRprob_hit_target_or_stop — MC trade probability with EV in R-multiplesAI Analyst (BYOK Anthropic)
ai_daily_briefing — structured JSON read from Claude Sonnet 4.6ai_setup_explanation — cheaper Haiku 4.5 plain-English readReport generation
generate_html_tearsheet — polished standalone HTML reportgenerate_markdown_briefing — portable Markdown daily summarygit clone https://github.com/ThaiTrevor/gold-mcp.git
cd gold-mcp
pip install -e .
Python 3.10+. No other setup, no env vars, no data files.
Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or
~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"gold-mcp": {
"command": "python",
"args": ["-m", "gold_mcp.server"]
}
}
}
Restart Claude Desktop. The tools appear under the plug icon.
claude mcp add --scope user gold-mcp -- python -m gold_mcp.server
~/.cursor/mcp.json (or the equivalent file for your client):
{
"mcpServers": {
"gold-mcp": {
"command": "python",
"args": ["-m", "gold_mcp.server"]
}
}
}
Settings → Connectors → Add MCP server:
Command: python
Args: -m gold_mcp.server
Ask the model in plain English. Examples:
"What is gold doing right now and how does it compare to today's macro tape (DXY, yields, VIX)?"
"Show me the last 24 hourly bars of gold and the 60-day correlation with silver and DXY."
"Give me a market snapshot for gold — combine price, macro context, correlations, and the day-of-week seasonality."
"USD/VND right now and the implied world-parity gold price in VND per tael. If SJC is quoting 145 million, what's the premium?"
LLMs reason well about gold but they don't see live market data, the macro tape that moves gold, or a clean correlation matrix on demand. This server is a tiny, free bridge between an MCP client and the public Yahoo Finance data that any researcher already has access to — exposed as well-typed tools so the model picks the right one automatically.
It started as a study project to learn MCP architecture and turned into something useful enough to publish for the community.
Add GOLD_MCP_LICENSE_KEY to the env block of your MCP config:
"env": {
"GOLD_MCP_LICENSE_KEY": "eyJ0aWVy...Ijoi.MEUCI..."
}
Restart your MCP client. Call diagnostic — tier_active should
report pro or premium. New tools become available immediately.
See examples/claude_desktop_config_pro.json for the full template.
gold_mcp/
server.py FastMCP wiring with 3-tier gating (21 tools max)
gold_data.py yfinance price + OHLCV
macro_data.py DXY/yields/SPX/VIX/BTC + correlations
analytics.py seasonality
analyst.py one-call aggregator (gold_market_snapshot)
cache.py TTL filesystem cache (60s → 24h)
license.py Ed25519 offline license verification
issue_license.py CLI: init-keys, issue, verify
pro_tools.py Pro tier: advanced TA, alerts, multi-timeframe
premium_tools.py Premium tier: backtest, walk-forward, optimizer
adapters/
vn_macro.py USD/VND + world-parity gold
For vendors selling licenses, see the CLI:
python -m gold_mcp.issue_license init-keys
# Paste printed PUBLIC_KEY_B64 into gold_mcp/license.py
python -m gold_mcp.issue_license issue --tier pro --email [email protected] --days 30
Or run the Lemon Squeezy webhook handler (port from
mcp-byok-template —
swap the env-var name from MCP_BYOK_LICENSE_KEY to GOLD_MCP_LICENSE_KEY).
This project is small on purpose. We welcome contributions that fit the same pattern:
See CONTRIBUTING.md for details and SECURITY.md for how to report security issues.
pip install -e ".[dev]"
pytest
CI runs the suite on Linux, macOS, and Windows across Python 3.10/3.11/3.12 on every push and pull request.
gold-mcp is a data and analysis tool for educational and research
purposes only. Nothing returned by any tool constitutes investment
advice, a recommendation, or a solicitation. Markets carry risk; you
are responsible for your own decisions.
MIT — see LICENSE.
MCP server for XAUUSD gold market data + 4-tier trading toolkit (TA, backtest, SMC, risk).
{ "mcpServers": { "io.github.thaitrevor-gold-mcp": { "command": "uvx", "args": [ "gold-mcp==4.1.2" ], "env": { "GOLD_MCP_LICENSE_KEY": "<secret>", "ANTHROPIC_API_KEY": "<secret>" } } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
게시자가 등록한 환경 변수: GOLD_MCP_LICENSE_KEY, ANTHROPIC_API_KEY.
Gold은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-09. MCP server for XAUUSD gold market data + 4-tier trading toolkit (TA, backtest, SMC, risk).