# Bullion API

> Bullion API is an MCP server for finance and payments. Read-only gold and precious-metal prices, central-bank gold and macro data over OAuth. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $5 a month
- **Platforms:** API
- **Website:** https://bullionapi.dev/docs/mcp
- **MCP Registry name:** dev.bullionapi/bullion-api
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

The server exposes cached spot prices for gold, silver, platinum, palladium and copper, plus derived gold metrics and country-level monetary data. Besides latest price, history and period change, it has per-gram prices by karat from 24k down to 6k, the gold-to-silver ratio, 50 or 200 close moving averages, 30-day annualised volatility, drawdown from the running peak, a CPI-rebased real price and a rolling correlation with real Treasury yields. On the macro side it returns central-bank reserves and gold holdings, inflation, policy rates and bond yields by tenor.

Prices are stored and refreshed hourly, so each answer is one dated observation, cached and not real-time. Access uses OAuth 2.1: the agent registers itself, you sign in and approve scopes for market data, macro data and optionally your private portfolio, all read-only. Access tokens last five minutes, and an optional offline_access scope keeps a connection alive for up to 30 days.

Connecting and listing tools is free, but data calls use account credits. The API has a 14-day trial of 1,000 requests with no card, then paid plans from $5 a month for 50,000 requests with no overage fees.

## Features

- **Metal prices and history:** Spot, weekday closes and period change for five metals.
- **Gold analytics:** Karat prices, gold-silver ratio, moving averages, volatility and drawdown.
- **Real and correlated gold:** CPI-rebased price and rolling correlation with real Treasury yields.
- **Central-bank data:** Reserves, gold holdings, inflation, policy rates and bond yields by country.
- **Scoped read-only access:** Separate market, macro and portfolio permissions; nothing can be changed.

## Good for

- Ask whether a central bank is still adding gold
- Chart gold's drawdown over a date range
- Convert the gold price to per-gram karat values in another currency
- Compare policy rates and inflation across countries

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bullion-api https://api.bullionapi.dev/mcp
```

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

```sh
https://api.bullionapi.dev/mcp
```

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

```json
{
  "mcpServers": {
    "bullion-api": {
      "url": "https://api.bullionapi.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "bullion-api": {
      "type": "http",
      "url": "https://api.bullionapi.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bullion-api": {
      "serverUrl": "https://api.bullionapi.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bullion-api": {
      "type": "http",
      "url": "https://api.bullionapi.dev/mcp"
    }
  }
}
```

## Tools

- `get_metal_price`: Latest cached spot price for one metal.
- `get_metal_price_history`: Cached weekday closing prices for one metal as a time series.
- `get_metal_change`: Price change for one metal over a period or date range.
- `get_gold_carat`: Gold price per gram for each karat.
- `get_gold_silver_ratio`: Gold-to-silver price ratio as a dated series.
- `get_gold_moving_average`: Simple moving average of gold closes.
- `get_gold_volatility`: Annualised volatility of 30 daily gold returns.
- `get_gold_drawdown`: Gold drawdown from its running peak.
- `get_gold_real_price`: USD gold rebased with CPI-U index levels.
- `get_gold_yield_correlation`: Rolling correlation of gold returns with 10-year real Treasury yield changes.
- `get_central_bank_reserves`: Central-bank reserves by country.
- `get_central_bank_gold`: Central-bank gold holdings by country.
- `get_inflation`: Inflation by country and basis.
- `get_policy_rates`: Central-bank policy rates.
- `get_bond_yields`: Government bond yields by tenor.

## FAQ

### Can the agent change anything?

No. The server is read-only and can only look things up.

### How fresh are prices?

Prices are cached and refreshed hourly, so each is a dated observation rather than a real-time quote.

### What does it cost?

A 14-day trial with 1,000 requests and no card, then Starter $5, Pro $15, Business $39 or Scale $99 a month.

### What do I approve when connecting?

market:read, macro:read, portfolio:read and optionally offline_access.

### Is Bullion API free?

Bullion API is a paid product with a free trial. Paid plans start at $5 a month.

### How do I add Bullion API to Claude Code?

Run this command in your terminal: claude mcp add --transport http bullion-api https://api.bullionapi.dev/mcp

### What are the best alternatives to Bullion API?

The closest alternatives to Bullion API 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/bullion-api
