StackerScan

Five read-only tools: spot prices, observed premiums, price history, Goldback rate, and currencies.

Should I use this

Quality & Safety

A
Description quality
90%
Schema completeness
92%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'get_price_history' description lacks action verbin get_price_history

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,435Tokens (tool definitions)
~7.6 KBTypical response size
Significant attention impact (2.68% of 128k context)

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-http

What it can do

Tool inventory

Tools (5)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded5 tools
verifiedversion not recorded5 tools
verifiedversion not recorded5 tools
failed observationversion not recorded—
failed observationversion not recorded—