# GoldAPI Precious Metals Quotes

> GoldAPI Precious Metals Quotes is a freemium MCP server for finance and payments. Real-time and historical gold, silver, platinum and palladium quotes via GoldAPI. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://www.gold-api.cn/docs.php
- **Repository:** https://github.com/hujuncheng-ddd/goldapi-mcp
- **MCP Registry name:** io.github.hujuncheng-ddd/goldapi-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

GoldAPI is a Chinese-language quote service, and this server exposes it to assistants. Quotes cover spot and futures across the Shanghai Gold Exchange, NYMEX/COMEX and London markets, with prices at five-decimal precision and timestamps in Beijing time.

Four tools are listed. list_varieties and get_kline (daily candles for the last 30 to 60 days) are free. get_realtime returns last price, change, bid and ask, and high and low for up to 50 varieties in one call, and get_history returns hourly OHLCV candles from 27 May 2026 in ranges of up to 92 days. Each paid result carries a billing object showing which channel was used and the remaining quota.

An AppKey is required, sent as a Bearer header; the README says registering gives 5,000 free calls. The docs describe three metering channels (per-variety, membership and the sign-up grant) with daily, monthly and per-second limits, and a trial key of 100 calls a day for 30 days. Membership prices are not shown.

## Features

- **Batch real-time quotes:** Fetches up to 50 varieties in a single counted call.
- **Hourly history:** Returns OHLCV candles from 2026-05-27, up to 92 days per request.
- **Daily candles:** get_kline returns daily OHLC for up to 60 days at no charge.
- **Variety directory:** Lists all varieties with id, name, market and category.
- **Usage reporting:** Paid results include the billing channel and remaining quota.
- **Multiple markets:** Spans Shanghai Gold Exchange, NYMEX/COMEX and London.

## Good for

- Ask for the latest gold spot and silver T+D prices
- Chart 30 days of daily candles for gold spot
- Pull a month of hourly prices for analysis
- Compare quotes across exchanges in one request

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http goldapi-mcp https://www.gold-api.cn/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.gold-api.cn/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "goldapi-mcp": {
      "url": "https://www.gold-api.cn/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "goldapi-mcp": {
      "type": "http",
      "url": "https://www.gold-api.cn/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "goldapi-mcp": {
      "serverUrl": "https://www.gold-api.cn/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "goldapi-mcp": {
      "type": "http",
      "url": "https://www.gold-api.cn/mcp"
    }
  }
}
```

## Tools

- `list_varieties`: Lists all varieties with goldId, name, market and category.
- `get_realtime`: Real-time quotes for up to 50 varieties.
- `get_history`: Hourly OHLCV history from 2026-05-27, max 92 days per request.
- `get_kline`: Daily OHLC candles for the last N days, default 30, max 60.

## FAQ

### Do I need a key?

Yes. Send an AppKey as a Bearer token; the README says registration gives 5,000 free calls.

### Which tools cost a call?

get_realtime and get_history cost one call each; list_varieties and get_kline are free.

### How far back does history go?

Hourly data starts on 2026-05-27, with up to 92 days per request.

### How many varieties per request?

Up to 50 in get_realtime.

### Is GoldAPI Precious Metals Quotes free?

GoldAPI Precious Metals Quotes has a free plan, with paid plans for more usage or features.

### How do I add GoldAPI Precious Metals Quotes to Claude Code?

Run this command in your terminal: claude mcp add --transport http goldapi-mcp https://www.gold-api.cn/mcp

### What are the best alternatives to GoldAPI Precious Metals Quotes?

The closest alternatives to GoldAPI Precious Metals Quotes are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/goldapi-precious-metals-quotes
