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):
| Karat | Purity | USD per gram |
|---|---|---|
| 24k | 99.9% | $125.63 |
| 22k | 91.7% | $115.16 |
| 18k | 75.0% | $94.22 |
| 14k | 58.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:
| Metal | Spot (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"
}
}
}
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.
![]()
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
![]()
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
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.