GoldAPI.io MCP Server

Connectez ChatGPT, Claude, Codex et d’autres clients IA compatibles avec MCP aux cours au comptant et taux de change de l’or, de l’argent, du platine et du palladium en temps réel et historiques à 100 %, ainsi qu’aux indices de référence LBMA.

Serveur MCP hébergé

npx add-mcp 'https://mcp.goldapi.io/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Use GoldAPI with Any AI-Agent

Run Your Precious Metal Business from ChatGPT or Claude

Ask any gold & silver real-time and historical questions and get GoldAPI.io data backed answers. Right in your AI Agent.

Example prompt

“What is the current gold price in Australian dollars?”

Tool get_current_metal_price

Example response

Gold is A$5,564 per troy ounce (about A$179 per gram). That’s up 0.96% today.

Example prompt

“What is the melt value of 125 grams of 22k gold in AUD?”

Tool calculate_metal_value

Example response

About A$20,499. That’s 125 g at A$163.99 per gram for 22k gold, at today’s spot price.

Example prompt

“Compare 14k, 18k, 22k, and 24k gold values per gram in USD.”

Tool compare_karat_values

Example response

Melt value per gram at today’s spot (US$3,907/oz):

KaratPurityUSD per gram
24k99.9%$125.63
22k91.7%$115.16
18k75.0%$94.22
14k58.3%$73.28

Example prompt

“Value 10 oz of gold, 250 oz of silver, and 5 oz of platinum in USD.”

Tool value_metal_holdings

Example response

At spot:

MetalSpot (US$/oz)Value
Gold, 10 oz$3,907.44$39,074.40
Silver, 250 oz$50.06$12,515.00
Platinum, 5 oz$1,441.26$7,206.30
Total$58,795.70

GoldAPI.io AI Agent Tools

12 Powerful MCP Tools for Live Gold Prices, Precious Metals Data & AI Agents

Connect AI assistants and agents to real-time and historical gold, silver, platinum, and palladium prices. Access live market data, perform accurate calculations, analyse price trends, and value precious metals portfolios using GoldAPI.io's 12 purpose-built MCP tools.

get_current_metal_price

Return the current GoldAPI price for a supported metal and currency.

1 price request

get_historical_metal_price

Return the GoldAPI price for one historical calendar date.

1 price request

get_metal_price_history

Return ordered daily prices for an inclusive range of up to 90 days.

1 history request

get_currency_rate

Return a current currency conversion rate with bid and ask values.

1 rates request

convert_currency

Convert an amount using the current GoldAPI currency rate.

1 rates request

get_lbma_benchmark

Return an LBMA benchmark for a supported metal and date.

1 LBMA request

convert_metal_weight

Convert precious-metal weight between nine supported units.

No price request

calculate_metal_value

Calculate live or historical melt value by weight and purity.

1 price request

calculate_dealer_quote

Create a nonbinding dealer buy or sell estimate from melt value.

1 price request

compare_karat_values

Compare common karat values using one GoldAPI price.

1 price request

analyze_metal_performance

Calculate descriptive statistics for a history range without forecasting.

1 history request

value_metal_holdings

Value up to 50 holdings using up to eight deduplicated price requests.

1–8 price requestsConnect ANy AI-agent to GoldAPI.io MCP

Use secure OAuth or GoldAPI.io API key connection

Choose the authentication method supported by your AI-agent and deployment environment. GoldAPI.io supports ChatGPT, Claude, Codex, Cursor and Grok out of the box. No code is required.

OAuth

Configure only the MCP endpoint. A compatible interactive client discovers authorization, opens the GoldAPI login and consent flow, and manages access and refresh tokens.

{
  "mcpServers": {
    "goldapi": {
      "url": "https://mcp.goldapi.io/mcp"
    }
  }
}

Protected-resource metadata →

API key header

Send your existing GoldAPI credential in the x-access-token header. Keep the key in an environment variable or secret manager, never in a URL or committed file.

{
  "mcpServers": {
    "goldapi": {
      "url": "https://mcp.goldapi.io/mcp",
      "headers": {
        "x-access-token": "${GOLDAPI_API_KEY}"
      }
    }
  }
}

Credential priority: if both credentials are supplied, OAuth Bearer authentication takes priority. Every request verifies the current GoldAPI user and active Business-plan access.

Simple, Worry-free, Flat Pricing With No Surprises

Start Today and Test for Free

No card required. Upgrade to Pro for unlimited REST or Business for unlimited REST, WebSockets, and MCP Server access. 30-day money-back guarantee.

Real-Time Gold & Silver Prices JSON API

Get Started

Free Plan

Free

API RequestsUp to 150/month

MetalsXAU, XAG, XPT, XPD

Currencies72 incl. USD, EUR, INR, AED, KWD, QAR, IDRsee all 🇦🇪 AED, 🇦🇷 ARS, 🇦🇺 AUD, 🇧🇩 BDT, 🇧🇬 BGN, 🇧🇭 BHD, 🇧🇴 BOB, 🇧🇷 BRL, ₿ BTC, 🇨🇦 CAD, 🇨🇭 CHF, 🇨🇱 CLP, 🇨🇳 CNY, 🇨🇴 COP, 🇨🇿 CZK, 🇩🇰 DKK, 🇩🇴 DOP, 🇩🇿 DZD, 🇪🇬 EGP, 🇪🇺 EUR, 🇫🇯 FJD, 🇬🇧 GBP, 🇬🇭 GHS, 🇬🇹 GTQ, 🇭🇰 HKD, 🇮🇩 IDR, 🇮🇱 ILS, 🇮🇳 INR, 🇮🇶 IQD, 🇮🇷 IRR, 🇮🇸 ISK, 🇯🇴 JOD, 🇯🇵 JPY, 🇰🇪 KES, 🇰🇭 KHR, 🇰🇷 KRW, 🇰🇼 KWD, 🇱🇦 LAK, 🇱🇧 LBP, 🇱🇰 LKR, 🇲🇦 MAD, 🇲🇲 MMK, 🇲🇽 MXN, 🇲🇾 MYR, 🇳🇬 NGN, 🇳🇴 NOK, 🇳🇵 NPR, 🇳🇿 NZD, 🇴🇲 OMR, 🇵🇪 PEN, 🇵🇭 PHP, 🇵🇰 PKR, 🇵🇱 PLN, 🇵🇾 PYG, 🇶🇦 QAR, 🇷🇴 RON, 🇷🇺 RUB, 🇸🇦 SAR, 🇸🇪 SEK, 🇸🇬 SGD, 🇸🇾 SYP, 🇹🇭 THB, 🇹🇷 TRY, 🇹🇼 TWD, 🇺🇦 UAH, 🇺🇸 USD, 🇺🇾 UYU, 🇺🇿 UZS, 🇻🇳 VND, Ag XAG, 🇾🇪 YER, 🇿🇦 ZAR

Karats24k, 22k, 21k, 20k, 18k, 16k, 14k, 10k

HistoricalDaily prices

Updates2 sec interval

WebSockets1 connection, 10 channels

MCP ServerOAuth + API key

SupportLimited

Historical & Real-Time Gold & Silver Prices RESTful API

Unlimited REST

Pro Plan

$ 99USD / month

API RequestsUnlimited/month

MetalsXAU, XAG, XPT, XPD

Currencies72 incl. USD, EUR, INR, AED, KWD, QAR, IDRsee all 🇦🇪 AED, 🇦🇷 ARS, 🇦🇺 AUD, 🇧🇩 BDT, 🇧🇬 BGN, 🇧🇭 BHD, 🇧🇴 BOB, 🇧🇷 BRL, ₿ BTC, 🇨🇦 CAD, 🇨🇭 CHF, 🇨🇱 CLP, 🇨🇳 CNY, 🇨🇴 COP, 🇨🇿 CZK, 🇩🇰 DKK, 🇩🇴 DOP, 🇩🇿 DZD, 🇪🇬 EGP, 🇪🇺 EUR, 🇫🇯 FJD, 🇬🇧 GBP, 🇬🇭 GHS, 🇬🇹 GTQ, 🇭🇰 HKD, 🇮🇩 IDR, 🇮🇱 ILS, 🇮🇳 INR, 🇮🇶 IQD, 🇮🇷 IRR, 🇮🇸 ISK, 🇯🇴 JOD, 🇯🇵 JPY, 🇰🇪 KES, 🇰🇭 KHR, 🇰🇷 KRW, 🇰🇼 KWD, 🇱🇦 LAK, 🇱🇧 LBP, 🇱🇰 LKR, 🇲🇦 MAD, 🇲🇲 MMK, 🇲🇽 MXN, 🇲🇾 MYR, 🇳🇬 NGN, 🇳🇴 NOK, 🇳🇵 NPR, 🇳🇿 NZD, 🇴🇲 OMR, 🇵🇪 PEN, 🇵🇭 PHP, 🇵🇰 PKR, 🇵🇱 PLN, 🇵🇾 PYG, 🇶🇦 QAR, 🇷🇴 RON, 🇷🇺 RUB, 🇸🇦 SAR, 🇸🇪 SEK, 🇸🇬 SGD, 🇸🇾 SYP, 🇹🇭 THB, 🇹🇷 TRY, 🇹🇼 TWD, 🇺🇦 UAH, 🇺🇸 USD, 🇺🇾 UYU, 🇺🇿 UZS, 🇻🇳 VND, Ag XAG, 🇾🇪 YER, 🇿🇦 ZAR

Karats24k, 22k, 21k, 20k, 18k, 16k, 14k, 10k

HistoricalDaily prices

UpdatesReal-time

WebSocketsNot included

MCP ServerNot included

SupportStandard

Precious Metals REST and WebSocket API

Unlimited REST + WS

Business Plan

$ 169USD / month

API RequestsUnlimited/month

MetalsXAU, XAG, XPT, XPD

Currencies72 incl. USD, EUR, INR, AED, KWD, QAR, IDRsee all 🇦🇪 AED, 🇦🇷 ARS, 🇦🇺 AUD, 🇧🇩 BDT, 🇧🇬 BGN, 🇧🇭 BHD, 🇧🇴 BOB, 🇧🇷 BRL, ₿ BTC, 🇨🇦 CAD, 🇨🇭 CHF, 🇨🇱 CLP, 🇨🇳 CNY, 🇨🇴 COP, 🇨🇿 CZK, 🇩🇰 DKK, 🇩🇴 DOP, 🇩🇿 DZD, 🇪🇬 EGP, 🇪🇺 EUR, 🇫🇯 FJD, 🇬🇧 GBP, 🇬🇭 GHS, 🇬🇹 GTQ, 🇭🇰 HKD, 🇮🇩 IDR, 🇮🇱 ILS, 🇮🇳 INR, 🇮🇶 IQD, 🇮🇷 IRR, 🇮🇸 ISK, 🇯🇴 JOD, 🇯🇵 JPY, 🇰🇪 KES, 🇰🇭 KHR, 🇰🇷 KRW, 🇰🇼 KWD, 🇱🇦 LAK, 🇱🇧 LBP, 🇱🇰 LKR, 🇲🇦 MAD, 🇲🇲 MMK, 🇲🇽 MXN, 🇲🇾 MYR, 🇳🇬 NGN, 🇳🇴 NOK, 🇳🇵 NPR, 🇳🇿 NZD, 🇴🇲 OMR, 🇵🇪 PEN, 🇵🇭 PHP, 🇵🇰 PKR, 🇵🇱 PLN, 🇵🇾 PYG, 🇶🇦 QAR, 🇷🇴 RON, 🇷🇺 RUB, 🇸🇦 SAR, 🇸🇪 SEK, 🇸🇬 SGD, 🇸🇾 SYP, 🇹🇭 THB, 🇹🇷 TRY, 🇹🇼 TWD, 🇺🇦 UAH, 🇺🇸 USD, 🇺🇾 UYU, 🇺🇿 UZS, 🇻🇳 VND, Ag XAG, 🇾🇪 YER, 🇿🇦 ZAR

Karats24k, 22k, 21k, 20k, 18k, 16k, 14k, 10k

HistoricalDaily prices

UpdatesReal-time

WebSockets5 connections, 20 channels

MCP ServerOAuth + API key

SupportPriority

GoldAPI.io MCP Server FAQ

Plans, authentication, client compatibility, capabilities, and responsible usage.

What is the GoldAPI MCP Server?

The GoldAPI MCP Server is a remote Model Context Protocol server that gives ChatGPT, Claude, Codex, and other MCP-compatible AI clients structured tools for precious-metals market data, calculations, valuations, and analysis.

Which AI clients can use the GoldAPI MCP Server?

Any AI client that supports remote Streamable HTTP MCP servers can connect, including ChatGPT, Claude, Codex, and other MCP-compatible clients. Available authentication options depend on the client.

Which GoldAPI plan includes MCP access?

Free accounts can evaluate the GoldAPI MCP Server using their shared 150 monthly GoldAPI requests. Business includes unlimited MCP Server usage. Pro does not include MCP access.

Can I use my existing GoldAPI API key?

Yes. Controlled server-side clients can send an existing GoldAPI key in the x-access-token header. Keep the key in an environment variable or secret manager.

Does the GoldAPI MCP Server support OAuth?

Yes. OAuth is recommended for interactive clients. Compatible clients discover the authorization service and manage access and refresh tokens through the GoldAPI login and consent flow.

Which precious metals are supported?

GoldAPI supports gold (XAU), silver (XAG), platinum (XPT), and palladium (XPD) across supported currencies and market-data endpoints.

Can the MCP Server calculate melt values and dealer quotes?

Yes. MCP tools can calculate live or historical melt value by weight and purity, compare karat values, and create nonbinding dealer buy or sell estimates.

Are dealer quotes and performance results financial advice?

No. Dealer quotes are nonbinding and exclude tax, assay, refining, shipping, and insurance. Performance analysis is descriptive and is not investment advice.