MCP Gold Price Server
# MCP Gold Price Server
A Model Context Protocol (MCP) server that provides real-time gold prices from Vietnamese and international markets via the [vang.today](https://www.vang.today) API.
## Tools
| Tool | Parameters | Description |
|------|-----------|-------------|
| `get_gold_prices` | `currency` (optional: VND/USD) | Get all current gold prices |
| `get_gold_price` | `code` (required) | Get a specific gold price by code |
### Available Gold Codes
| Code | Name |
|------|------|
| XAUUSD | World Gold (XAU/USD) |
| SJL1L10 | SJC 9999 |
| BT9999NTT | Bao Tin 9999 |
| BTSJC | Bao Tin SJC |
| VNGSJC | VN Gold SJC |
| VIETTINMSJC | Viettin SJC |
| PQHNVM | PNJ Hanoi |
| PQHN24NTT | PNJ 24K |
| SJ9999 | SJC Ring |
| DOJINHTV | DOJI Jewelry |
| DOHNL | DOJI Hanoi |
| DOHCML | DOJI HCM |
## Setup
```bash
uv sync
python main.py
```
## Claude Desktop Config
```json
{
"mcpServers": {
"gold": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-gold", "run", "main.py"]
}
}
}
```
TDQS
Scored across 3 tools
The three tools are clearly distinct: get_gold_prices provides multiple market prices, get_gold_price targets a single code, and get_gold_price_history covers historical data. While the plural vs. singular names are close, the descriptions make the purpose of each unambiguous.
All tool names follow the get_gold_* prefix with a consistent pattern: plural for bulk, singular for single, and 'history' for historical. The naming is logical and predictable across the set.
With 3 tools, the server is well-scoped for its purpose. Each tool covers a core need (current bulk, current single, historical), and the count is within the ideal range for a focused domain.
The server covers the essential gold price queries: current prices for multiple types, individual prices, and historical data. The only minor gap is the lack of a tool to discover all available gold codes, but common codes are listed in the descriptions, so agents can work around this.