MCP.Market

Gold MCP server

by ThaiTrevor·io.github.ThaiTrevor/gold-mcp·v4.1.2·8 stars

MCP server for XAUUSD gold market data + 4-tier trading toolkit (TA, backtest, SMC, risk).

B80/100grade B
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
Growing

8 stars27 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • ai_daily_briefing

    LLM-driven daily briefing with structured JSON output. Ultra tier.

  • ai_setup_explanation

    Cheaper Haiku-based plain-English read of current setup. Ultra tier.

  • analyze_gold_advanced

    Bollinger + Ichimoku + Fibonacci levels on XAUUSD. Pro tier.

  • backtest_gold_strategy

    Vectorized backtest on XAUUSD daily bars. Premium tier.

  • cache_purge

    Sweep expired entries from the on-disk cache.

  • classify_regime

    Composite regime tag: Hurst + Lo-MacKinlay variance ratio. Ultra tier.

  • create_gold_alertwrite action

    Create a gold alert rule. Pro tier.

  • delete_gold_alertwrite action

    Delete a gold alert by id. Pro tier.

  • detect_fair_value_gaps

    Detect unfilled Fair Value Gaps (3-candle imbalances). Ultra tier.

  • detect_liquidity_sweeps

    Detect stop-hunt liquidity sweeps (breach + reverse). Ultra tier.

  • detect_market_structure

    Label market structure: CHOCH (reversal) / BOS (continuation). Ultra tier.

  • detect_order_blockswrite action

    Detect bullish/bearish order blocks. Ultra tier.

  • diagnostic

    Show server license tier and available tools.

  • estimate_vn_gold_premium

    Compare a user-supplied local VN gold price to world parity.

  • fixed_fractional_size

    Classic fixed-fractional position size. Ultra tier.

  • generate_html_tearsheet

    Build a polished HTML tearsheet (writes to disk, returns path). Ultra tier.

  • generate_markdown_briefing

    Build a Markdown daily briefing (writes to disk, returns path + content). Ultra tier.

  • get_gold_correlations

    Correlation of gold daily returns vs the macro basket.

  • get_gold_ohlcv

    Historical OHLCV bars for gold from Yahoo Finance.

  • get_gold_price

    Latest gold (XAUUSD / GC=F) price and 24h change from Yahoo Finance.

  • get_gold_seasonality

    Historical seasonality stats for gold returns.

  • get_gold_setups

    Scan for confluence setups (RSI + Bollinger + Ichimoku). Pro tier.

  • get_macro_context

    Macro snapshot relevant to gold: DXY, US10Y/02Y, SPX, VIX, BTC, silver, oil.

  • get_paxg_ohlcv_realtime

    Build OHLCV bars from PAXG tick stream on the fly.

  • get_paxg_tick

    Most recent PAXG trade — free real-time gold proxy via Binance.

  • get_vn_macro

    USD/VND + cross rates + implied world-parity gold price in VND.

  • gold_correlation_regime

    Detect regime shifts in gold ↔ macro correlations. Pro tier.

  • gold_intraday_seasonality

    Intraday seasonality of gold returns. Premium tier.

  • gold_market_snapshot

    One-call structured snapshot of gold's current market state.

  • gold_walk_forward

    Walk-forward backtest on XAUUSD: rolling out-of-sample. Premium tier.

  • kelly_fraction

    Kelly criterion sizing (half-Kelly default for safety). Ultra tier.

  • list_gold_alerts

    List all stored gold alert rules. Pro tier.

  • monte_carlo_paths

    Bootstrap or parametric MC simulation of gold's path. Ultra tier.

  • mt5_account_info

    Balance, equity, margin, leverage — used for position sizing.

  • mt5_attach

    Attach to a running MT5 terminal you have already logged into.

  • mt5_detach

    Disconnect from the MT5 terminal.

  • mt5_find_symbol

    List MT5 symbols whose name contains `query` (case-insensitive).

  • mt5_get_ohlcv

    Broker OHLCV bars.

  • mt5_get_tick

    Latest bid/ask/last from the attached MT5 terminal.

  • mt5_get_ticks

    Raw tick history for the last `seconds_back` seconds.

  • mt5_status

    Connection status of the attached MT5 terminal.

  • mtf_alignment

    Composite confluence D1/H4/H1 with alignment score 0-100. Ultra tier.

  • multi_timeframe_snapshot

    Pull gold OHLCV + RSI across several timeframes in one call. Pro tier.

  • optimal_f

    Ralph Vince Optimal-f geometric-mean-maximizing fraction. Ultra tier.

  • optimize_gold_strategy

    Grid-search optimizer on XAUUSD. Premium tier.

  • paxg_worker_status

    Health of the local PAXG tick-capture worker.

  • prob_hit_target_or_stop

    Monte Carlo: probability target hits before stop in horizon. Ultra tier.

  • risk_of_ruin

    Monte Carlo probability of drawing down past ruin threshold. Ultra tier.

  • smc_full_scan

    Composite SMC scan: structure + order blocks + FVG + sweeps + bias. Ultra tier.

  • value_at_risk

    Historical 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

no findings
  • 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
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.

  • CCXT
    Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
    A
  • TradingMCP
    Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.
    A