Metals MCP Server

FastMCP-based metals market data server backed by a Swissquote poller and local candle store.

Transport

MCP SSE transport mounted at /mcp
SSE stream endpoint: /mcp/sse
message endpoint handled by FastMCP under /mcp/messages/
no legacy /rpc compatibility path

Runtime

source .venv/bin/activate
pip install -r requirements.txt
./run.sh

Default URL base: http://127.0.0.1:8515

HTTP

GET / → health + tool list
GET /health → health + cache/store stats

Tools

get_price
get_candles
get_last_candle
get_capabilities

Notes

Done

MCP surface mirrors crypto-mcp tool names where it makes sense.
get_price fetches live Swissquote quotes for metals like XAU.
An internal background poller keeps the server self-sufficient.
5m candles are clock-aligned and persisted in SQLite.

Planned

Fill out get_indicator, get_market_snapshot, get_top_movers, and get_regime with real regime math.
Add retention cleanup for older candles.
Expand the watched pair set only if it proves useful for market orientation.

Design

The public surface should mirror crypto-mcp where practical.
Local default port is 8515.
Under the hood, the server uses Swissquote polling plus a local candle store.
The repo now contains a working scaffold and the first live price path.

Verification

./tests.sh
./run.sh

Housekeeping

./killserver.sh stops stale listeners on the configured port
./restart.sh chains kill and run