Metal Price MCP Server
About
An MCP server that provides current and historical gold/precious metal prices via the GoldAPI.io service.
Details
- Author
- isdaniel
- GitHub stars
- 1
- Downloads
- 221
- Categories
- Other
Jump to
- Get current prices for XAU (gold), XAG (silver), XPT (platinum), XPD (palladium)
- Support for multiple currencies (e.g., USD, EUR)
- Optional historical price lookup by date (YYYYMMDD format)
- Requires Python 3.7+ and packages mcp>=1.0.0, requests>=2.31.0
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Metal Price MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies, set the GOLDAPI_API_KEY environment variable, and configure the server in cline_mcp_settings.json. Start the server with python src/server.py. Use the get_gold_price tool with parameters currency, metal, and optional date.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"metal price mcp server": {
"mcp-metal-price": {
"command": "python",
"args": [
"src/server.py"
]
}
}
}
}McpServers
{
"mcp-metal-price": {
"command": "python",
"args": [
"src/server.py"
]
}
}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
1. Clone this repository
2. Install dependencies:
pip install -r requirements.txt
3. 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.
1. 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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
