Gold MCP server
io.github.ThaiTrevor/gold-mcp·v4.1.2·8 starsMCP server for XAUUSD gold market data + 4-tier trading toolkit (TA, backtest, SMC, risk).
8 stars27 downloads/wk
Reviews
Write oneNobody has reviewed Gold yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Gold tools (50, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
ai_daily_briefingLLM-driven daily briefing with structured JSON output. Ultra tier.
ai_setup_explanationCheaper Haiku-based plain-English read of current setup. Ultra tier.
analyze_gold_advancedBollinger + Ichimoku + Fibonacci levels on XAUUSD. Pro tier.
backtest_gold_strategyVectorized backtest on XAUUSD daily bars. Premium tier.
cache_purgeSweep expired entries from the on-disk cache.
classify_regimeComposite regime tag: Hurst + Lo-MacKinlay variance ratio. Ultra tier.
create_gold_alertwrite actionCreate a gold alert rule. Pro tier.
delete_gold_alertwrite actionDelete a gold alert by id. Pro tier.
detect_fair_value_gapsDetect unfilled Fair Value Gaps (3-candle imbalances). Ultra tier.
detect_liquidity_sweepsDetect stop-hunt liquidity sweeps (breach + reverse). Ultra tier.
detect_market_structureLabel market structure: CHOCH (reversal) / BOS (continuation). Ultra tier.
detect_order_blockswrite actionDetect bullish/bearish order blocks. Ultra tier.
diagnosticShow server license tier and available tools.
estimate_vn_gold_premiumCompare a user-supplied local VN gold price to world parity.
fixed_fractional_sizeClassic fixed-fractional position size. Ultra tier.
generate_html_tearsheetBuild a polished HTML tearsheet (writes to disk, returns path). Ultra tier.
generate_markdown_briefingBuild a Markdown daily briefing (writes to disk, returns path + content). Ultra tier.
get_gold_correlationsCorrelation of gold daily returns vs the macro basket.
get_gold_ohlcvHistorical OHLCV bars for gold from Yahoo Finance.
get_gold_priceLatest gold (XAUUSD / GC=F) price and 24h change from Yahoo Finance.
get_gold_seasonalityHistorical seasonality stats for gold returns.
get_gold_setupsScan for confluence setups (RSI + Bollinger + Ichimoku). Pro tier.
get_macro_contextMacro snapshot relevant to gold: DXY, US10Y/02Y, SPX, VIX, BTC, silver, oil.
get_paxg_ohlcv_realtimeBuild OHLCV bars from PAXG tick stream on the fly.
get_paxg_tickMost recent PAXG trade — free real-time gold proxy via Binance.
get_vn_macroUSD/VND + cross rates + implied world-parity gold price in VND.
gold_correlation_regimeDetect regime shifts in gold ↔ macro correlations. Pro tier.
gold_intraday_seasonalityIntraday seasonality of gold returns. Premium tier.
gold_market_snapshotOne-call structured snapshot of gold's current market state.
gold_walk_forwardWalk-forward backtest on XAUUSD: rolling out-of-sample. Premium tier.
kelly_fractionKelly criterion sizing (half-Kelly default for safety). Ultra tier.
list_gold_alertsList all stored gold alert rules. Pro tier.
monte_carlo_pathsBootstrap or parametric MC simulation of gold's path. Ultra tier.
mt5_account_infoBalance, equity, margin, leverage — used for position sizing.
mt5_attachAttach to a running MT5 terminal you have already logged into.
mt5_detachDisconnect from the MT5 terminal.
mt5_find_symbolList MT5 symbols whose name contains `query` (case-insensitive).
mt5_get_ohlcvBroker OHLCV bars.
mt5_get_tickLatest bid/ask/last from the attached MT5 terminal.
mt5_get_ticksRaw tick history for the last `seconds_back` seconds.
mt5_statusConnection status of the attached MT5 terminal.
mtf_alignmentComposite confluence D1/H4/H1 with alignment score 0-100. Ultra tier.
multi_timeframe_snapshotPull gold OHLCV + RSI across several timeframes in one call. Pro tier.
optimal_fRalph Vince Optimal-f geometric-mean-maximizing fraction. Ultra tier.
optimize_gold_strategyGrid-search optimizer on XAUUSD. Premium tier.
paxg_worker_statusHealth of the local PAXG tick-capture worker.
prob_hit_target_or_stopMonte Carlo: probability target hits before stop in horizon. Ultra tier.
risk_of_ruinMonte Carlo probability of drawing down past ruin threshold. Ultra tier.
smc_full_scanComposite SMC scan: structure + order blocks + FVG + sweeps + bias. Ultra tier.
value_at_riskHistorical VaR + CVaR on gold daily returns. Ultra tier.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan29 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 27 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Gold compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 60% of 48,255 servers
- Tools
- 50
- the typical server has 7
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 8
- more than 86% of 28,688 servers
- Downloads a week
- 27
- more than 14% of 12,191 servers with a package
What its tools let an agent do: 45 read · 3 create · 1 change · 1 delete
Install Gold in Claude Code, Cursor or VS Code
claude mcp add gold-mcp -- uvx gold-mcp
What the publisher says
From the Gold repository's README, as published. We do not edit it. Read it on GitHub
gold-mcp
<!-- mcp-name: io.github.ThaiTrevor/gold-mcp -->
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.
Tiers
Free — public gold data + realtime PAXG + MT5 BYOK (13 + 8 tools)
Public gold data (Yahoo Finance):
- getgoldprice — latest gold close + 24h change
- getgoldohlcv — historical bars (1m → 1mo)
- getmacrocontext — DXY, US10Y/02Y, SPX, VIX, BTC, silver, oil
- getgoldcorrelations — gold-vs-macro correlation matrix
- getgoldseasonality — day-of-week / monthly return stats
- getvnmacro — USD/VND + implied world-parity gold price in VND
- estimatevngold_premium — compare local VN quote to world parity
- goldmarketsnapshot — one-call aggregator + bulleted summary
- diagnostic — show license tier + available tools
- cache_purge — sweep expired cache entries
Realtime PAXG via Binance public WebSocket (NEW v4.1, no API key):
- paxgworkerstatus — WS worker health + tick count
- getpaxgtick — last PAXG tick (tracks XAU/USD within 0.1-0.3%)
- getpaxgohlcv_realtime — aggregated PAXG bars from local tick log
MT5 BYOK adapter (NEW v4.1, optional via pip install 'gold-mcp[mt5]', Windows):
- mt5attach / mt5detach / mt5_status — manage attached terminal
- mt5findsymbol — broker-specific XAUUSD symbol resolution
- mt5gettick / mt5getohlcv / mt5getticks — read from your terminal
- mt5accountinfo — balance / equity / leverage
- No credentials cross the server. You run your own MT5 terminal.
Pro — advanced TA + multi-timeframe + alerts
- analyzegoldadvanced — Bollinger + Ichimoku + Fibonacci
- multitimeframesnapshot — 5m / 1h / 4h / 1d in one call
- goldcorrelationregime — detects DXY decoupling, etc.
- getgoldsetups — multi-indicator confluence scanner
- creategoldalert / listgoldalerts / deletegoldalert
Premium — backtest + research
- backtestgoldstrategy — 4 strategies, vectorized
- goldwalkforward — rolling out-of-sample validation
- optimizegoldstrategy — grid search by Sharpe / PF / return
- goldintradayseasonality — hourly / session bucketing
Ultra — institutional analyst toolkit (18 exclusive tools)
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Gold: common questions
- Is Gold MCP server safe?
- Mostly: it is graded B (80/100). Read the Gold safety report
- How do I install Gold?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Gold need an API key?
- Yes. The registry entry asks for
GOLD_MCP_LICENSE_KEY,ANTHROPIC_API_KEY. - Is Gold maintained?
- The last commit was 65 days ago (2026-08-31). The latest release is v4.1.2.
- What can I use instead of Gold?
- Servers from other publishers that do the same job: CCXT MCP server and TradingMCP MCP server.
- How does Gold compare with other MCP servers?
- safety score 80/100 (higher than 60% of 48,255 servers); tools 50 (the typical server has 7); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Gold
Same job from other publishers: the closest match first, then the best rated.
- CCXTOfficial CCXT MCP server - Market data and trading across 100+ exchanges and prediction marketsnot reviewedWidely usedA
- TradingMCPMarket analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.not reviewedEstablishedA