Metal Price MCP Server

An MCP server that provides current and historical gold/precious metal prices via the GoldAPI.io service.

Features

Get current prices for gold (XAU), silver (XAG), platinum (XPT), and palladium (XPD)
Support for multiple currencies (USD, EUR, etc.)
Optional historical price lookup by date

Requirements

Python 3.7+
Packages:
- mcp>=1.0.0
- requests>=2.31.0

Setup

Clone this repository
Install dependencies:
pip install -r requirements.txt
Set your GoldAPI.io API key as an environment variable:
export GOLDAPI_API_KEY="your_api_key_here"
(Windows users: use set instead of export)

Usage

The server provides one MCP tool:

Installation

This server is designed to be installed manually by adding its configuration to the cline_mcp_settings.json file.

Add the following entry to the mcpServers object in your cline_mcp_settings.json file:

"mcp_metal_price": {
  "args": [
    "/c",
    "python",
    "-m",
    "mcp_metal_price"
  ],
  "env": {
    "GOLDAPI_API_KEY": "Your GOLDAPI_API_KEY"
  }
}

get_gold_price

Get current or historical metal prices.

Parameters:

currency (string, default: "USD"): Currency code (ISO 4217 format)
metal (string, default: "XAU"): Metal symbol (XAU, XAG, XPT, XPD)
date (string, optional): Historical date in YYYYMMDD format

Example Usage:

{
  "currency": "EUR",
  "metal": "XAU"
}

Running the Server

Start the server with:

python src/server.py

Using with MCP Clients

Once the server is running, you can connect to it from MCP clients like Cline or Claude.

Connecting to the Server

The server runs on stdio by default. In your MCP client, you can connect using:

cmd /c python src/server.py

Using the get_gold_price Tool

Example tool usage in Cline/Claude:

<use_mcp_tool>
<server_name>gold-price</server_name>
<tool_name>get_gold_price</tool_name>
<arguments>
{
  "currency": "USD",
  "metal": "XAU"
}
</arguments>
</use_mcp_tool>

Response Format

The server returns price data in JSON format:

{
  "timestamp": 1713600000,
  "metal": "XAU",
  "currency": "USD",
  "price": 2345.67,
  "unit": "per troy ounce"
}

License

This project is licensed under the terms of the MIT license. See LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that provides current and historical gold/precious metal prices (gold, silver, platinum, and palladium) via the GoldAPI.io service with support for multiple currencies.

Related MCP Servers

Crypto Price & Market Analysis MCP Server
truss44
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.
Last updated -
3
86
29
TypeScript
MIT License
mcp-coincap-jj
wazzan
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface. Updated to use Coin Cap API v3
Last updated -
3
109
TypeScript
MIT License
crypto-indicators-mcp
kukapay
-
security
A
license
-
quality
An MCP server providing a range of cryptocurrency technical analysis indicators and strategies.
Last updated -
64
JavaScript
MIT License
Alpha Vantage MCP Server
deepsuthar496
A
security
F
license
A
quality
An MCP server that provides real-time financial data integration with Alpha Vantage's API, enabling access to stock market data, cryptocurrency prices, forex rates, and technical indicators.
Last updated -
7
2
JavaScript

View all related MCP servers

Metal Price MCP Server