Server definition

Hash: sha256:8ec76e33c3ff00e822dab7ee05f1853e63f7df357afec74161a6278dd3584c90
What it is: What a remote MCP server returned when asked what it offers: 9 tools

The blob, as servednamed by its sha256

{
  "instructions": "Gold, silver, and copper pricing via aggregated public reference data. Multi-currency XAU spot, XAG and HG spot, XAU + XAG + HG futures, per-karat jewelry gram prices (get_carat — free), 10+ year daily XAU history, FAQ search, per-country physical dealer prices (get_physical_price — Physical tier). Methodology at https://goldprice.dev/methodology. All tools share the per-minute rate limit + monthly quota tied to your API key's tier. If a tool reports a rate limit, wait for its retry time. If it reports a monthly quota, surface its reset date and upgrade URL; do not retry it automatically.",
  "tools": [
    {
      "description": "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).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "default": "USD",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_carat",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "asset": {
            "type": "string"
          }
        },
        "required": [
          "asset"
        ],
        "type": "object"
      },
      "name": "get_forward_view",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "from_date": {
            "type": "string"
          },
          "interval": {
            "default": "1d",
            "enum": [
              "1m",
              "5m",
              "15m",
              "30m",
              "1h",
              "2h",
              "4h",
              "1d"
            ],
            "type": "string"
          },
          "limit": {
            "default": 100,
            "type": "integer"
          },
          "symbol": {
            "type": "string"
          },
          "to_date": {
            "type": "string"
          }
        },
        "required": [
          "symbol",
          "from_date",
          "to_date"
        ],
        "type": "object"
      },
      "name": "get_historical",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "Return provenance metadata for a symbol: aggregated sources, unit, methodology URL, staleness rules. Use for attribution and to document data lineage in downstream reports.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "symbol": {
            "type": "string"
          }
        },
        "required": [
          "symbol"
        ],
        "type": "object"
      },
      "name": "get_metadata",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "country": {
            "type": "string"
          }
        },
        "required": [
          "country"
        ],
        "type": "object"
      },
      "name": "get_physical_price",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "symbol": {
            "type": "string"
          }
        },
        "required": [
          "symbol"
        ],
        "type": "object"
      },
      "name": "get_spot_price",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_commodities",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 5,
            "type": "integer"
          },
          "query": {
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_docs",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "plan": {
            "enum": [
              "physical",
              "pro",
              "realtime",
              "basic_2026",
              "plus_2026",
              "pro_2026"
            ],
            "type": "string"
          }
        },
        "required": [
          "plan"
        ],
        "type": "object"
      },
      "name": "start_checkout",
      "outputSchema": {
        "additionalProperties": {
          "type": "string"
        },
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:8ec76e33c3ff00e822dab7ee05f1853e63f7df357afec74161a6278dd3584c90 | sha256sum