StackerScan
Five read-only tools: spot prices, observed premiums, price history, Goldback rate, and currencies.
Should I use this
Quality & Safety
Findings (1)
- LOWin get_price_history
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"stackerscan": {
"url": "https://www.stackerscan.com/mcp"
}
}
}Remote endpoints
https://www.stackerscan.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢get_spot_prices(base, unit, metals)
Current and previous-session spot prices for gold, silver, platinum, palladium, copper and nickel, in any supported currency and per troy ounce or gram.
Input Schema
{
"type": "object",
"properties": {
"base": {
"description": "A currency code from the live catalog at /api/currencies (ISO 4217 fiat plus BTC and the metal codes). Defaults to USD.",
"type": "string",
"minLength": 1
},
"unit": {
"description": "Price per troy ounce or per gram. Defaults to troy_oz.",
"type": "string",
"enum": [
"troy_oz",
"gram"
]
},
"metals": {
"description": "Metal symbols to include (xau gold, xag silver, xpt platinum, xpd palladium, xcu copper, ni nickel). Omit for all six; Goldback is not a spot metal.",
"minItems": 1,
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"xau",
"xag",
"xpt",
"xpd",
"xcu",
"ni"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"base": {
"type": "string",
"minLength": 1,
"description": "Resolved uppercase currency code."
},
"unit": {
"type": "string",
"enum": [
"troy_oz",
"gram"
],
"description": "Shared price denominator for every returned metal."
},
"asOf": {
"type": "string",
"format": "date-time",
"description": "UTC source update instant."
},
"date": {
"type": "string",
"format": "date",
"description": "Market or session date."
},
"metals": {
"type": "object",
"properties": {
"xau": {
"type": "object",
"properties": {
"open": {
"type": "number",
"description": "Opening price in the result's shared base and unit."
},
"high": {
"type": "number",
"description": "Session high in the result's shared base and unit."
},
"low": {
"type": "number",
"description": "Session low in the result's shared base and unit."
},
"close": {
"type": "number",
"description": "Latest or session-close price in the result's shared base and unit."
}
},
"required": [
"open",
"high",
"low",
"close"
],
"additionalProperties": false
},
"xag": {
"type": "object",
"properties": {
"open": {
"type": "number",
"description": "Opening price in the result's shared base and unit."
},
"high": {
"type": "number",
"description": "Session high in the result's shared base and unit."
},
"low": {
"type": "number",
"description": "Session low in the result's shared base and unit."
},
"close": {
"type": "number",
"description": "Latest or session-close price in the result's shared base and unit."
}
},
"required": [
"open",
"high",
"low",
"close"
],
"additionalProperties": false
},
"xpt": {
"type": "object",
"properties": {
"open": {
"type": "number",
"description": "Opening price in the result's shared base and unit."
},
"high": {
"type": "number",
"description": "Session high in the result's shared base and unit."
},
"low": {
"type": "number",
"description": "Session low in the result's shared base and unit."
},
"close": {
"type": "number",
"description": "Latest or session-close price in the result's shared base and unit."
}
},
"required": [
"open",
"high",
"low",
"close"
],
"additionalProperties": false
},
"xpd": {
"type": "object",
"properties": {
"open": {
"type": "number",
"description": "Opening price in the result's shared base and unit."
},
"high": {
"type": "number",
"description": "Session high in the result's shared base and unit."
},
"low": {
"type": "number",
"description": "Session low in the result's shared base and unit."
},
"close": {
"type": "number",
"description": "Latest or session-close price in the result's shared base and unit."
}
},
"required": [
"open",
"high",
"low",
"close"
],
"additionalProperties": false
},
"xcu": {
"type": "object",
"properties": {
"open": {
"type": "number",
"description": "Opening price in the result's shared base and unit."
},
"high": {
"type": "number",
"description": "Session high in the result's shared base and unit."
},
"low": {
"type": "number",
"description": "Session low in the result's shared base and unit."
},
"close": {
"type": "number",
"description": "Latest or session-close price in the result's shared base and unit."
}
},
"required": [
"open",
"high",
"low",
"close"
],
"additionalProperties": false
},
"ni": {
"type": "object",
"properties": {
"open": {
"type": "number",
"description": "Opening price in the result's shared base and unit."
},
"high": {
"type": "number",
"description": "Session high in the result's shared base and unit."
},
"low": {
"type": "number",
"description": "Session low in the result's shared base and unit."
},
"close": {
"type": "number",
"description": "Latest or session-close price in the result's shared base and unit."
}
},
"required": [
"open",
"high",
"low",
"close"
],
"additionalProperties": false
}
},
"additionalProperties": false,
"description": "Requested spot symbols only; Goldback is not a spot metal."
}
},
"required": [
"base",
"unit",
"asOf",
"date",
"metals"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_observed_premiums(metal, query, limit, cursor)
Rolling fine-metal-weighted median asking premiums for silver, gold, platinum, palladium, copper, nickel and Goldback, observed from marketplace listings.
Input Schema
{
"type": "object",
"properties": {
"metal": {
"type": "string",
"enum": [
"silver",
"gold",
"platinum",
"palladium",
"copper",
"nickel",
"goldback"
],
"description": "Which metal's observed premiums to return."
},
"query": {
"description": "Case-insensitive product label/canonical-key search.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"limit": {
"default": 10,
"description": "Product page size. Without a query, pages browse the most-listed products.",
"type": "integer",
"minimum": 1,
"maximum": 10
},
"cursor": {
"description": "Opaque continuation token returned by the same tool with exactly the same filters.",
"type": "string",
"minLength": 1,
"maxLength": 2048
}
},
"required": [
"metal"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"metal": {
"type": "string",
"enum": [
"silver",
"gold",
"platinum",
"palladium",
"copper",
"nickel",
"goldback"
]
},
"asOf": {
"type": "string",
"format": "date-time",
"description": "UTC latest observation instant."
},
"windowDays": {
"type": "integer",
"exclusiveMinimum": 0
},
"minimumListings": {
"type": "integer",
"exclusiveMinimum": 0
},
"productQuery": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"productOrder": {
"type": "string",
"enum": [
"search",
"listing_count"
],
"description": "How product rows were selected: search (query match, catalog order) or listing_count (browse, most-listed first). Empty products means no data."
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"overall": {
"anyOf": [
{
"type": "object",
"properties": {
"medianPercent": {
"type": "number"
},
"listingCount": {
"type": "integer",
"minimum": 0
}
},
"required": [
"medianPercent",
"listingCount"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"medianPercent": {
"type": "number"
},
"listingCount": {
"type": "integer",
"minimum": 0
},
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"medianPercent",
"listingCount",
"key",
"label"
],
"additionalProperties": false
}
},
"products": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"medianPercent": {
"type": "number"
},
"listingCount": {
"type": "integer",
"minimum": 0
},
"key": {
"type": "string",
"maxLength": 160
},
"label": {
"type": "string",
"maxLength": 200
},
"fineTroyOz": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"numistaUrl": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "null"
}
]
},
"listingsUrl": {
"type": "string",
"maxLength": 2048,
"format": "uri"
}
},
"required": [
"medianPercent",
"listingCount",
"key",
"label",
"fineTroyOz",
"numistaUrl",
"listingsUrl"
],
"additionalProperties": false
}
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"metal",
"asOf",
"windowDays",
"minimumListings",
"productQuery",
"productOrder",
"sourceUrl",
"overall",
"categories",
"products",
"nextCursor"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_price_history(metal, days, base, format, limit, ...)
Daily historical series for charting — one metal or the Goldback.
Input Schema
{
"type": "object",
"properties": {
"metal": {
"type": "string",
"enum": [
"gold",
"silver",
"platinum",
"palladium",
"copper",
"nickel",
"goldback"
],
"description": "The metal (or Goldback) whose history to return."
},
"days": {
"default": 90,
"description": "How many trailing days of history to return.",
"type": "integer",
"minimum": 1,
"maximum": 3650
},
"base": {
"default": "USD",
"description": "A currency code from the live catalog at /api/currencies (ISO 4217 fiat plus BTC and the metal codes). Defaults to USD.",
"type": "string",
"minLength": 1
},
"format": {
"default": "line",
"description": "ohlc returns open/high/low/close rows; line returns closes.",
"type": "string",
"enum": [
"line",
"ohlc"
]
},
"limit": {
"default": 90,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Opaque continuation token returned by the same tool with exactly the same filters.",
"type": "string",
"minLength": 1,
"maxLength": 2048
}
},
"required": [
"metal"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"result": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"series": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "metal"
},
"metal": {
"type": "string",
"enum": [
"gold",
"silver",
"platinum",
"palladium",
"copper",
"nickel",
"goldback"
]
}
},
"required": [
"kind",
"metal"
],
"additionalProperties": false
},
"base": {
"type": "string",
"minLength": 1
},
"unit": {
"type": "string",
"enum": [
"troy_oz",
"goldback"
]
},
"requestedDays": {
"type": "integer",
"minimum": 1,
"maximum": 3650
},
"startDate": {
"type": "string",
"format": "date"
},
"endDate": {
"type": "string",
"format": "date"
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"format": {
"type": "string",
"const": "line"
},
"points": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date"
},
"price": {
"type": "number"
}
},
"required": [
"date",
"price"
],
"additionalProperties": false
}
}
},
"required": [
"series",
"base",
"unit",
"requestedDays",
"startDate",
"endDate",
"nextCursor",
"format",
"points"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"series": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "metal"
},
"metal": {
"type": "string",
"enum": [
"gold",
"silver",
"platinum",
"palladium",
"copper",
"nickel",
"goldback"
]
}
},
"required": [
"kind",
"metal"
],
"additionalProperties": false
},
"base": {
"type": "string",
"minLength": 1
},
"unit": {
"type": "string",
"enum": [
"troy_oz",
"goldback"
]
},
"requestedDays": {
"type": "integer",
"minimum": 1,
"maximum": 3650
},
"startDate": {
"type": "string",
"format": "date"
},
"endDate": {
"type": "string",
"format": "date"
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"format": {
"type": "string",
"const": "ohlc"
},
"points": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "number",
"description": "Opening price in the result's shared base and unit."
},
"high": {
"type": "number",
"description": "Session high in the result's shared base and unit."
},
"low": {
"type": "number",
"description": "Session low in the result's shared base and unit."
},
"close": {
"type": "number",
"description": "Latest or session-close price in the result's shared base and unit."
},
"date": {
"type": "string",
"format": "date"
}
},
"required": [
"open",
"high",
"low",
"close",
"date"
],
"additionalProperties": false
}
}
},
"required": [
"series",
"base",
"unit",
"requestedDays",
"startDate",
"endDate",
"nextCursor",
"format",
"points"
],
"additionalProperties": false
}
]
}
},
"required": [
"result"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_goldback_rate(base)
The latest Goldback premium multiple over its gold content, and the exchange rate that follows from it.
Input Schema
{
"type": "object",
"properties": {
"base": {
"description": "A currency code from the live catalog at /api/currencies (ISO 4217 fiat plus BTC and the metal codes). Defaults to USD.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"base": {
"type": "string",
"minLength": 1,
"description": "Resolved uppercase currency code."
},
"ratePerGoldback": {
"type": "number",
"description": "Price of one Goldback: goldSpotPerTroyOz × goldContentTroyOz × premiumMultiple."
},
"goldContentTroyOz": {
"type": "number",
"const": 0.001,
"description": "Fine-gold content of one Goldback note."
},
"goldSpotPerTroyOz": {
"type": "number",
"description": "Underlying gold spot price per troy ounce in the base currency."
},
"premiumMultiple": {
"type": "number",
"minimum": 0,
"description": "Multiple applied to the note's contained-gold spot value."
},
"rateDate": {
"type": "string",
"format": "date",
"description": "Effective date of the premium multiple."
},
"spotAsOf": {
"type": "string",
"format": "date-time",
"description": "UTC update instant of the gold spot input."
}
},
"required": [
"base",
"ratePerGoldback",
"goldContentTroyOz",
"goldSpotPerTroyOz",
"premiumMultiple",
"rateDate",
"spotAsOf"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_supported_currencies(query, limit, cursor)
The live list of codes every `currency`/`base` parameter accepts — ISO 4217 fiat plus the metal codes.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Case-insensitive substring match against code or name.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 25
},
"cursor": {
"description": "Opaque continuation token returned by the same tool with exactly the same filters.",
"type": "string",
"minLength": 1,
"maxLength": 2048
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"currencies": {
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"maxLength": 16,
"pattern": "^[A-Z0-9]+$"
},
"name": {
"type": "string",
"maxLength": 200
}
},
"required": [
"code",
"name"
],
"additionalProperties": false
}
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"query",
"currencies",
"nextCursor"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence