# gold-mcp

This MCP server feeds the model live XAUUSD quotes, macro data and correlations, with paid tiers unlocking backtesting, an SMC scanner and risk sizing.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: ThaiTrevor
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ThaiTrevor/gold-mcp
- Updated: 2026-08-31
- HTML: https://affpapa.org/en/nevibecode/mcp/gold-mcp

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `GOLD_MCP_LICENSE_KEY`, `ANTHROPIC_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add gold-mcp -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcp
```
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>

### Codex

**Platform CLI**
```bash
codex mcp add gold-mcp --env GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcp
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> gold-mcp uvx gold-mcp
```
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>

## When to use it
- 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
- 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

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md