MCP servermetals data inside your AI assistant
The MetalCharts MCP server gives Claude, Cursor, VS Code and other MCP clients 13 tools: live and historical prices in any currency, unit or karat, conversions, and the exchange data the API is known for. It runs at https://api.metalcharts.org/mcp. Clients such as claude.ai and ChatGPT sign in with your MetalCharts account; the rest use an API key.
Connect
Add it to your client
https://api.metalcharts.org/mcpclaude mcp add --transport http metalcharts https://api.metalcharts.org/mcp \
--header "Authorization: Bearer mc_live_YOUR_KEY"{
"mcpServers": {
"metalcharts": {
"url": "https://api.metalcharts.org/mcp",
"headers": {
"Authorization": "Bearer mc_live_YOUR_KEY"
}
}
}
}{
"servers": {
"metalcharts": {
"type": "http",
"url": "https://api.metalcharts.org/mcp",
"headers": {
"Authorization": "Bearer mc_live_YOUR_KEY"
}
}
}
}{
"mcpServers": {
"metalcharts": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.metalcharts.org/mcp",
"--header",
"Authorization: Bearer mc_live_YOUR_KEY"
]
}
}
}Tools
The 13 tools
get_spot_pricesLive spot prices for metals (XAU, XAG, XPT, XPD, HG, ALI, NI, ZN, PB, JBP, CO, LC, UXA) with 24-hour change, high, low and an indicative bid and ask. Quote in another currency, per gram/kilo/tola, or a gold karat with currency, unit and karat. Each quote states its currency and unit.
get_price_historyDaily, weekly, monthly or intraday OHLC history for one metal, oldest first. Gold and silver daily history goes back to 1966. Converts each point at that day's ECB rate when currency is set. Returns at most `limit` of the most recent points.
convertConvert an amount between a metal, a currency and a mass unit: 10 g of gold in euros (from XAU to EUR, unit g, amount 10), how much silver 1000 INR buys (from INR to XAG, unit g), EUR to JPY, or grams to troy ounces. Live, or as of a past date.
get_exchange_ratesECB reference exchange rates for 32 currencies against a base, live or on a past date.
get_comex_inventoryCOMEX registered and eligible warehouse stocks for a metal (gold and silver back to 1992), as a daily series, the latest report, or the latest per-depository breakdown. Pro plan.
get_comex_depository_flowsEach COMEX depository's daily metal movements as CME reports them: previous stock, received, withdrawn, adjustment and today's stock, registered and eligible. Filter by depository name. Pro plan.
get_cot_positioningWeekly CFTC Commitments of Traders positioning for a metal: managed money, producers, swap dealers and open interest. type=overview gives the latest week for every metal. Pro plan.
get_shanghai_premiumShanghai Gold Exchange prices against Western spot: the Shanghai premium for gold and silver, with VAT-inclusive and ex-VAT values. Pro plan.
get_india_premiumMCX India gold and silver prices against Western spot, as a premium. Pro plan.
get_sge_fixingsSGE AM and PM benchmark fixings (gold in CNY per gram from 2016, silver in CNY per kg from 2019), as a series or the latest. Pro plan.
get_lbma_fixesThe LBMA Gold Price (AM and PM), Silver Price, and Platinum and Palladium Prices (AM and PM), in US dollars per troy ounce or converted to another currency at each day's ECB rate. type=latest gives the newest fix for every metal. Pro plan.
search_instrumentsSearch the catalogue of about 1,100 instruments (metals, commodities, crypto, ETFs, indices) to find the symbol another tool needs. Symbol spaces differ by endpoint: gold is XAU for prices and history.
get_usageThe API plan behind this key, its limits (per minute, per month, history depth) and usage so far this month. Free to call.
FAQ