Gold API

endpoint

https://api.goldprice.dev/v1/mcp/

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is Gold API live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is Gold API free to use?

Yes — the hub reached it with no key and no payment.

What tools does Gold API have?

9 tools: start_checkout, search_docs, get_spot_price, get_forward_view, get_historical, get_physical_price, get_metadata, get_carat, ….

Is Gold API safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• get_carat reads open 9h ago

  Return per-gram gold (XAU) prices by karat purity — 24k, 22k, 21k, 20k, 18k, 16k, 14k, 10k — in a requested currency (default USD; the same 31 currencies get_spot_price serves plus EGP, NPR, PKR and VND). Jewelry-grade pricing computed from XAU spot and exchangerate.dev FX. FREE on every tier — no plan gate. Values are Decimal-formatted strings, quantized to the currency's ISO 4217 minor unit (JPY → whole numbers, USD → 2dp).

  mcp-tool

  12345678910

  {
    "type": "object",
    "properties": {
      "currency": {
        "type": "string",
        "default": "USD"
      }
    },
    "additionalProperties": false
  }

  arguments 10 lines copy
• list_commodities reads open 9h ago

  Return the full list of symbols served by this API. Use before get_spot_price / get_historical / get_metadata when you don't know which symbols are supported.

  mcp-tool

  12345

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  arguments 5 lines copy
• start_checkout changes data unknown never probed

  Open a direct billing URL for an explicitly selected eligible plan: a one-hour Stripe Checkout URL for Free accounts or the existing customer's Stripe billing portal. This always asks the human to confirm the same plan first; a cancellation creates nothing.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "required": [
      "plan"
    ],
    "properties": {
      "plan": {
        "enum": [
          "basic_2026",
          "plus_2026",
          "pro_2026"
        ],
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 17 lines copy
• search_docs reads unknown 16h ago

  Search the goldprice.dev FAQ corpus via BM25. Returns top-K matching questions + answers with relevance scores. Use before answering how-to / billing / auth questions so you cite the canonical text instead of guessing from training data.

  mcp-tool

  12345678910111213141516

  {
    "type": "object",
    "required": [
      "query"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "default": 5
      },
      "query": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 16 lines copy
• get_spot_price reads unknown 16h ago

  Return the latest spot (or GC futures) price for one symbol. Price is a Decimal-formatted string. Latest USD spot price/bid/ask use nearest half-up rounding: XAU 2 decimal places, XAG 3, HG 4. Free and keyless callers get the price 15 minutes late; bid/ask are null when no quote is available. `is_stale` is true when aggregator detected source divergence or stale FX.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "symbol"
    ],
    "properties": {
      "symbol": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 12 lines copy
• get_forward_view reads unknown 9h ago

  Returns the multi-horizon futures settlement curve for a commodity (XAU, XAG, HG). Every populated horizon up to one year forward. Useful for bot builders and traders seeing the futures-implied path. See https://goldprice.dev/methodology#forward-view-layers for per-layer math.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "asset"
    ],
    "properties": {
      "asset": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 12 lines copy
• get_historical reads unknown 24h ago

  Return OHLCV bar history for a symbol at 1m, 5m, 15m, 30m, 1h, 2h, 4h, or 1d (default). Plus includes 1h and 4h bars for the last 30 days; Pro includes 1m to 4h bars. History depth is set automatically by your API key's plan — do NOT pass a tier argument (there is none): Free sees the last 30 days; Basic sees the last year; Plus and Pro unlock full history back to 1996 (XAU/USD). Dates must be ISO 8601 (YYYY-MM-DD). Returns bars in date-descending order. volume is null for spot instruments (XAU/USD, XAG/USD, XCU/USD); real for futures (GC, SI, HG) and ETFs (GLD).

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738

  {
    "type": "object",
    "required": [
      "symbol",
      "from_date",
      "to_date"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "default": 100
      },
      "symbol": {
        "type": "string"
      },
      "to_date": {
        "type": "string"
      },
      "interval": {
        "enum": [
          "1m",
          "5m",
          "15m",
          "30m",
          "1h",
          "2h",
          "4h",
          "1d"
        ],
        "type": "string",
        "default": "1d"
      },
      "from_date": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 38 lines copy
• get_physical_price reads unknown 24h ago

  Return the latest per-country physical dealer/retail gold prices — real quotes from dealers, mints, and bullion benchmarks, NOT spot-derived arithmetic — with nullable premium_over_spot_bps per quote (null when live reference inputs are unavailable). `country` is an ISO 3166-1 alpha-2 code (e.g. ID, MY, AE, JP). Uncovered countries return unknown_country on every plan. Requires Basic or higher; static sample responses for evaluation are in the docs at https://goldprice.dev/docs/physical.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "country"
    ],
    "properties": {
      "country": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 12 lines copy
• get_metadata reads unknown 24h ago

  Return provenance metadata for a symbol: the serving source, unit, methodology URL, staleness rules. Use for attribution and to document data lineage in downstream reports.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "symbol"
    ],
    "properties": {
      "symbol": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 12 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.