gold-mcp — MCP server for Claude Code: gold data and trading tools
This MCP server feeds the model live XAUUSD quotes, macro data and correlations, with paid tiers unlocking backtesting, an SMC scanner and risk sizing.
claude mcp add gold-mcp -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcpWhat gold-mcp does
The free tier ships 13 tools pulling gold prices and history from Yahoo Finance, alongside a macro read covering DXY, yields, VIX and oil, a correlation matrix and day-of-week seasonality stats. A separate pair of tools converts USD/VND into a world-parity gold price in dong, useful for checking against local Vietnamese quotes. Realtime PAXG ticks stream over Binance's public WebSocket with no key required, and an optional Windows adapter can attach to your own MT5 terminal.
Pro, Premium and Ultra layer on Bollinger and Ichimoku analysis, four backtestable strategies with walk-forward validation, Smart Money Concepts detection (order blocks, fair value gaps, liquidity sweeps, CHOCH/BOS), Kelly and risk-of-ruin sizing, Monte Carlo VaR, and an Anthropic-powered daily briefing. Those tiers run on a GOLD_MCP_LICENSE_KEY, and the AI Analyst tools additionally need your own ANTHROPIC_API_KEY since neither key is stored server-side.
Building from source calls for Python 3.10+, though the packaged version installs directly through uvx without cloning anything.
What it helps with
- pull live XAUUSD price and history into a chat session
- line up gold against DXY, yields and VIX in one macro read
- check gold seasonality and correlations without a custom script
- run a backtest or walk-forward validation on a gold strategy
- scan for order blocks, fair value gaps and liquidity sweeps
Example prompts for the agent
- Pull the current gold price and compare it with today's DXY, yields and VIX
- Build a gold market snapshot combining price, macro context, correlations and weekday seasonality
- Run a backtest on a gold strategy and show me the walk-forward results
How to install gold-mcp
Platform CLI
claude mcp add gold-mcp -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from gold-mcp <command>
Platform CLI
codex mcp add gold-mcp --env GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from gold-mcp <command>
Config file
{
"mcpServers": {
"gold-mcp": {
"command": "uvx",
"args": [
"gold-mcp"
],
"env": {
"GOLD_MCP_LICENSE_KEY": "<GOLD_MCP_LICENSE_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from gold-mcp <command>
Config file
{
"servers": {
"gold-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"gold-mcp"
],
"env": {
"GOLD_MCP_LICENSE_KEY": "<GOLD_MCP_LICENSE_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from gold-mcp <command>
Platform CLI
gemini mcp add -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> gold-mcp uvx gold-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from gold-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gold-mcp
How do I install gold-mcp in Claude Code?
Run claude mcp add gold-mcp -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcp. The keys only matter for paid tiers and the AI briefing; the free tools run without them.
What does gold-mcp do?
It's an MCP server that pipes public XAUUSD market data into the model: price, history, macro context, correlations and seasonality. Paid tiers add technical analysis, backtesting, an SMC scanner and risk calculations.
Do the base features of gold-mcp need an API key?
No, the free 13-tool tier works without a license. GOLD_MCP_LICENSE_KEY unlocks Pro, Premium and Ultra, while ANTHROPIC_API_KEY is only needed for the Ultra-tier AI Analyst tools.
