Skip to main content
Glama
MCP Gold Price Server

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 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

Related MCP server: VNStock MCP Server

Setup

uv sync
python main.py

Claude Desktop Config

{
  "mcpServers": {
    "gold": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-gold", "run", "main.py"]
    }
  }
}

Available Tools

3 tools
get_gold_priceA

Get the current price for a specific gold type by its code. Common codes: XAUUSD (World Gold), SJL1L10 (SJC 9999), DOJINHTV (DOJI Jewelry), PQHNVM (PNJ Hanoi), BT9999NTT (Bao Tin 9999).

Inputs: code (required).

get_gold_price_historyA

Get historical gold prices for a specific gold type over a number of days. Returns daily buy/sell prices and day-over-day changes. Common codes: XAUUSD (World Gold), SJL1L10 (SJC 9999), DOJINHTV (DOJI Jewelry), PQHNVM (PNJ Hanoi), BT9999NTT (Bao Tin 9999).

Inputs: code (required), days.

get_gold_pricesA

Get current gold prices from Vietnamese and international markets. Returns buy/sell prices and price changes. By default returns: SJC 9999, SJC Ring, PNJ Hanoi, PNJ 24K, VN Gold SJC. Optionally filter by currency (VND or USD) or specific codes.

Inputs: codes, currency.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      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.
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides access to Vietnam stock market data including real-time quotes, historical prices, company financials, trading statistics, mutual fund information, and exchange rates through the vnstock library.
      33
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides seamless access to Vietnamese stock market data, enabling real-time prices, historical data, company fundamentals, and market analysis through natural language queries.
      17 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides read-only access to Iranian market data from tgju.org, including live gold, coin, currency, and crypto prices, category tables, symbol search, and daily price history. Exposes six MCP tools for market summaries, live quotes, category browsing, and historical data with Jalali date filtering.
      6
      336 PyPI
      PolyForm Noncommercial 1.0.0