# CommodityPriceAPI

> CommodityPriceAPI is an MCP server for finance and payments. Live and historical gold, silver, oil and other commodity prices for your assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $34.99 a month
- **Platforms:** CLI, API
- **Website:** https://commoditypriceapi.com
- **Repository:** https://github.com/commodity-price-api/commoditypriceapi-mcp
- **MCP Registry name:** io.github.Commodity-Price-API/commoditypriceapi-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

Behind the nine tools is CommodityPriceAPI, a service that quotes mid-market prices, the midpoint of bid and ask, tracking LBMA and LPPM for precious metals, COMEX, NYMEX, ICE, CBOT and CME for futures, with World Bank and IMF monthly reference series for agriculture, fertilisers and minor metals. The site is explicit that these are reference prices, not exchange settlement prices or executable quotes.

Gold, silver, platinum, palladium, copper and WTI and Brent crude refresh every second on every plan; other symbols update as often as their market publishes. The website cites 520+ symbols across 10 categories and 150+ currencies, while the registry description and README mention 130+ and 140+ commodities, so check the catalogue for the exact symbol you need.

The local stdio server needs Node.js 18 or newer and a CommodityPriceAPI key in COMMODITYPRICEAPI_KEY. The README says a free 7-day trial gives 2,000 requests with no card. Paid plans start at $34.99 per month for 8,000 calls, with history back to 1990.

## Features

- **Real-time prices:** Latest quotes for metals, energy and agricultural commodities.
- **Historical data:** Basic plan history reaches back to 1990.
- **Intraday and time series:** Time-series and intraday endpoints on higher plans.
- **Currency conversion:** Quote prices in 150+ currencies on higher plans.
- **Named underlying markets:** Each symbol maps to a stated exchange or reference source.
- **One-click Cursor install:** Plus config for Claude Desktop, Claude Code, VS Code and Windsurf.

## Good for

- Ask the current gold price
- Compare oil prices over a period
- Pull historical copper prices
- Convert a commodity price to another currency
- Build market summaries in a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add commoditypriceapi-mcp --env COMMODITYPRICEAPI_KEY='<COMMODITYPRICEAPI_KEY>' -- npx -y @commoditypriceapi/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "commoditypriceapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@commoditypriceapi/mcp"
      ],
      "env": {
        "COMMODITYPRICEAPI_KEY": "<COMMODITYPRICEAPI_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "commoditypriceapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@commoditypriceapi/mcp"
      ],
      "env": {
        "COMMODITYPRICEAPI_KEY": "<COMMODITYPRICEAPI_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "commoditypriceapi-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@commoditypriceapi/mcp"
      ],
      "env": {
        "COMMODITYPRICEAPI_KEY": "<COMMODITYPRICEAPI_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "commoditypriceapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@commoditypriceapi/mcp"
      ],
      "env": {
        "COMMODITYPRICEAPI_KEY": "<COMMODITYPRICEAPI_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "commoditypriceapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@commoditypriceapi/mcp"
      ],
      "env": {
        "COMMODITYPRICEAPI_KEY": "<COMMODITYPRICEAPI_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need an API key?

Yes, set COMMODITYPRICEAPI_KEY.

### Is there a free trial?

The README says a free 7-day trial with 2,000 requests and no card.

### Are these exchange prices?

No. They are mid-market reference prices, not settlement prices or executable quotes.

### What does it cost after the trial?

Plans start at $34.99 per month for 8,000 calls.

### Is CommodityPriceAPI free?

CommodityPriceAPI is a paid product with a free trial. Paid plans start at $34.99 a month.

### How do I add CommodityPriceAPI to Claude Code?

Run this command in your terminal: claude mcp add commoditypriceapi-mcp --env COMMODITYPRICEAPI_KEY='<COMMODITYPRICEAPI_KEY>' -- npx -y @commoditypriceapi/mcp

### What are the best alternatives to CommodityPriceAPI?

The closest alternatives to CommodityPriceAPI 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/commoditypriceapi
