MCP Metal Price

🚀 Metal Price MCP Server

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

🚀 Quick Start

This is a MCP server that offers current and historical prices of gold and other precious metals via the GoldAPI.io service.

✨ Features

• Retrieve current prices of gold (XAU), silver (XAG), platinum (XPT), and palladium (XPD).
• Support multiple currencies (e.g., USD, EUR, etc.).
• Optional historical price query function to search by date.

📦 Installation

Configuration Requirements

• Python 3.7 or higher.
• Package dependencies:
  • mcp>=1.0.0
  • requests>=2.31.0

Installation Steps

1. Clone this repository.
2. Install the dependencies:

   pip install -r requirements.txt
   

3. Set the GoldAPI.io API key as an environment variable:

   export GOLDAPI_API_KEY="your_api_key_here"
   

   (Windows users should use set instead of export).

💻 Usage Examples

Server Usage

The server provides an MCP tool:

get_gold_price

Retrieve the 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 the format YYYYMMDD.

Example Usage:

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

Starting the Server

Use the following command to start the server:

python src/server.py

Connecting with an MCP Client

Once the server is running, you can connect to it via an MCP client such as Cline or Claude.

Connecting to the Server

The server runs on stdio by default. In your MCP client, you can use the following command to connect:

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 the following format:

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

📄 License

This project is licensed under the terms of the MIT License. For more details, please refer to the LICENSE file.