Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "goldprice": {
      "type": "http",
      "url": "https://api.goldprice.dev/v1/mcp"
    }
  }
}

claude mcp add --transport http goldprice https://api.goldprice.dev/v1/mcp

[mcp_servers.goldprice]
url = "https://api.goldprice.dev/v1/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "goldprice": {
      "type": "remote",
      "url": "https://api.goldprice.dev/v1/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "goldprice": {
      "type": "http",
      "url": "https://api.goldprice.dev/v1/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=goldprice&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmdvbGRwcmljZS5kZXYvdjEvbWNwIn0%3D"
}

{
  "servers": {
    "goldprice": {
      "type": "http",
      "url": "https://api.goldprice.dev/v1/mcp"
    }
  }
}

{
  "mcpServers": {
    "goldprice": {
      "httpUrl": "https://api.goldprice.dev/v1/mcp"
    }
  }
}

extensions:
  "goldprice":
    enabled: true
    name: "goldprice"
    type: streamable_http
    uri: "https://api.goldprice.dev/v1/mcp"
    timeout: 300

Quality 80 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations8 of 9 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_historical (destructiveHint, idempotentHint, openWorldHint); get_forward_view (destructiveHint, idempotentHint, openWorldHint); get_physical_price (destructiveHint, idempotentHint, openWorldHint); …
pass
tools.token_costabout 1,122 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability75 · weight 15

warn
stability.changes11 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

9 tools, about 1,122 tokens to load them all · tool set 1028692fc822 · tools last changed 2026-10-19 · checked 2026-10-20 13:49 UTC

Tool changes

2026-10-19get_physical_pricechangeddescription
before
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 the Physical tier or higher; static sample responses for evaluation are in the docs at https://goldprice.dev/docs/physical.
after · 97% of words in common
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.
2026-10-19get_historicalchangeddescription
before
Return OHLCV bar history for a symbol at 1m, 5m, 15m, 30m, 1h, 2h, 4h, or 1d (default). Intraday intervals require Pro. 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; Physical sees the last year; Pro unlocks 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).
after · 90% of words in common
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).
2026-10-19get_caratchangeddescription
before
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). 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).
after · 93% of words in common
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).
2026-10-16get_metadatachangeddescription
before
Return provenance metadata for a symbol: aggregated sources, unit, methodology URL, staleness rules. Use for attribution and to document data lineage in downstream reports.
after · 81% of words in common
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.
2026-10-16get_spot_pricechangeddescription
before
Return the latest aggregated 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.
after · 98% of words in common
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.
2026-10-12start_checkoutchangedinput schema
2026-10-12get_spot_pricechangeddescription
before
Return the latest aggregated 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. `is_stale` is true when aggregator detected source divergence or stale FX.
after · 76% of words in common
Return the latest aggregated 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.
2026-10-12start_checkoutchangedinput schema
2026-10-08get_physical_pricechangeddescription
before
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, IN, AE, JP). Requires the Physical tier or higher; static sample responses for evaluation are in the docs at https://goldprice.dev/docs/physical.
after · 90% of words in common
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 the Physical tier or higher; static sample responses for evaluation are in the docs at https://goldprice.dev/docs/physical.
2026-10-08get_caratchangeddescription
before
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). Jewelry-grade pricing computed from live XAU spot + ECB 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).
after · 92% of words in common
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). 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).

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 82 / 100

no-repository

provenance55

liveness98

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-95% +updated-11d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://api.goldprice.dev/v1/mcp` streamable-http	none	yes	95%	916 ms	2025-11-25	2026-10-20

Tools (9)

`get_carat`read-only	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).
`get_forward_view`read-only	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.
`get_historical`read-only	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).
`get_metadata`read-only	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.
`get_physical_price`read-only	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.
`get_spot_price`read-only	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.
`list_commodities`read-only	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.
`search_docs`read-only	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.
`start_checkout`	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "dev.goldprice/mcp",
  "title": "goldprice.dev",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.goldprice.dev/v1/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.4",
  "websiteUrl": "https://goldprice.dev",
  "description": "Gold, silver and copper spot, 31 currencies, per-country dealer prices and nine MCP tools."
}