Verified

Goldapi MCP Server

Retrieve real-time spot prices and calculate precious metal values via GoldAPI.

Data last scanned today · Reviewed today

325 tools3TypeScriptMIT

Overview

Goldapi MCP Server allows AI agents to interface directly with GoldAPI.io, providing access to real-time and historical price data for precious metals such as gold, silver, platinum, and palladium. It translates natural language queries into specific price lookups across multiple currencies and provides automated bullion and jewelry value calculations based on weight, unit, and purity. The server requires a valid GoldAPI.io API key provided as an environment variable to function. It is designed to work with any standard MCP-compliant client, supporting various units including grams, kilograms, and troy ounces, alongside custom purity inputs.

Our verdict

This server carries a high-risk rating of 27/100, primarily due to it being a community-maintained project rather than an official vendor release. With no editorially reviewed security protocols, unverified authentication methods, and a single contributor base, users should exercise caution before implementing it in production environments. It is better suited for experimental local workflows than sensitive financial analysis.

  • Supports historical price retrieval for gold, silver, and other metals
  • Calculates metal value based on weight, unit, and purity
  • Limited supply-chain footprint with only three direct dependencies
  • High security risk due to lack of editorial review
  • Community-maintained project with no official vendor status
  • Authentication and read-only mode security remain unverified

Setup

Claude Desktop
{
  "mcpServers": {
    "goldapi-mcp-server": {
      "args": [
        "-y",
        "@goldapi/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

  • No read-only mode — running this grants full read/write access.
  • No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

ToolDescriptionRisk
get_metal_priceGet latest precious metal spot price.low
get_historical_metal_priceRetrieve historical metal price.low
calculate_metal_valueCalculate value of metal using weight and purity.low
get_supported_metalsReturns a list of supported metals.low
get_supported_currenciesReturns all supported currencies.low

Compatibility

ClientLocalDockerRemoteRead-only
Claude Desktop
Cursor
VS Code
Windsurf
ChatGPT

Frequently asked questions

What is required to run the GoldAPI MCP server?

You must obtain an API key from the GoldAPI dashboard and provide it as the GOLDAPI_KEY environment variable.

What happens if I forget to provide the GOLDAPI_KEY?

The server will fail to start and exit with the error message: Missing GOLDAPI_KEY environment variable.

Which units are supported for metal value calculations?

The server supports gram, kg, oz, and troy_oz.

Can I use this server without installing it globally?

Yes, you can run the server directly using npx -y @goldapi/mcp-server.

Which precious metals are supported by this server?

The supported metals are gold (XAU), silver (XAG), platinum (XPT), and palladium (XPD).

Alternatives

Badge

Goldapi MCP Server security score, rated on RepoAI

Maintain this server? Add the live badge to your README.