MIT · 13 free tools · Pro $9 / Premium $29 / Ultra $99
MCP server for XAUUSD. Free tier: 13 tools incl. realtime PAXG tick stream (Binance public WS) + MT5 BYOK adapter. Paid tiers unlock Bollinger/Ichimoku/Fibonacci, vectorized backtest + walk-forward, SMC suite, regime classifier, Kelly sizing, Monte Carlo risk, and a BYOK Claude analyst chain.
No broker account, no tick stream, no environment variables, no local data files. Clone, pip install, restart your client. Done.
Works the same on Claude Desktop, Claude Code, ChatGPT Desktop, Cursor, Windsurf, Cline, Continue, and Zed. One config snippet per client.
About 600 lines of Python in five files. Read it end-to-end in 15 minutes. A clean example of what an MCP server can look like.
Tools wrap public data sources (Yahoo, Binance WS, BYOK MT5) (and a little computation) into a structured JSON response the LLM can read.
get_gold_price — latest gold close + 24h changeget_gold_ohlcv — historical bars (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1wk, 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 statsget_vn_macro — USD/VND + implied world-parity gold (VND)estimate_vn_gold_premium — compare a local quote to world paritygold_market_snapshot — combines all of the above into a single structured read with a concise bulleted summarypaxg_worker_status — health of local Binance WS workerget_paxg_tick — most recent PAXG trade, free gold proxy (tracks XAU within ~0.1-0.3%)get_paxg_ohlcv_realtime — build N-second OHLCV bars on the fly from tick streammt5_attach / mt5_detach / mt5_status — lifecyclemt5_find_symbol — resolve broker XAUUSD variants (XAUUSD.r, GOLD#, etc.)mt5_get_tick / mt5_get_ohlcv / mt5_get_ticks — broker-grade datamt5_account_info — balance / equity / margin (read-only)
User runs own MT5 terminal locally. No credentials cross the server.
Install: pip install "gold-mcp[mt5]"
analyze_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 Sharpegold_intraday_seasonality — hourly / session statssmc_full_scan — composite SMC biasdetect_order_blocks / detect_fair_value_gapsdetect_liquidity_sweeps / detect_market_structureclassify_regime — Hurst + Lo-MacKinlay VRmtf_alignment — D1/H4/H1 confluence scoringkelly_fraction / fixed_fractional_size / optimal_frisk_of_ruin — Monte Carlo ruin probabilitymonte_carlo_paths — bootstrap path simulationvalue_at_risk — VaR + CVaR (Expected Shortfall)prob_hit_target_or_stop — MC trade probabilityai_daily_briefing — BYOK Claude analyst chainai_setup_explanation — cheaper Haiku readgenerate_html_tearsheet — auto weekly reportgenerate_markdown_briefing — portable summaryFree tier is real and useful — 13 tools (incl. realtime PAXG +
MT5 BYOK), no limits.
Pro / Premium / Ultra unlock through a single env var
(GOLD_MCP_LICENSE_KEY) with offline Ed25519
verification — no SaaS, no phone-home, no user accounts.
$0 / forever
Real tooling for gold research. No upgrade pressure.
$9 / month
Advanced TA + multi-timeframe + alerts for active traders.
$29 / month
Quant research toolkit for strategy development.
$99 / month
The institutional analyst toolkit. Everything in Premium PLUS Smart Money Concepts, regime classification, multi-timeframe confluence, position-sizing math, Monte Carlo risk, BYOK AI analyst chain (Claude), and auto-generated HTML tearsheets.
Pick your client. Paste the snippet. Restart. Ask your model anything about gold.
pip install gold-mcp
claude mcp add --scope user gold-mcp -- python -m gold_mcp.serverEdit %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"]
}
}
}Cursor: ~/.cursor/mcp.json · Windsurf: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gold-mcp": {
"command": "python",
"args": ["-m", "gold_mcp.server"]
}
}
}Settings → Connectors → Add MCP server.
Command: python
Args: -m gold_mcp.server“What is gold doing right now and how does the macro tape look?”
model Pulls the latest gold price, the DXY / yields / VIX snapshot, and reports both in one read.
“What's gold's 60-day correlation with silver and DXY?”
model
Calls get_gold_correlations and tells you which
cross-asset is the cleanest read.
“Day-of-week seasonality on gold over 5 years?”
model
Calls get_gold_seasonality and surfaces the
mean return and win rate per weekday.
“USD/VND now plus the implied world-parity gold in VND.”
model
Calls get_vn_macro, returns the cross rates and
the per-tael parity figure you can compare against SJC.
gold-mcp is small on purpose. PRs that add similar small, public-data tools are very welcome. We do not accept tools that need paid API keys, scraped private data, or that function as financial advice.