Skip to main content
Glama

StackerScan

Historical price series

get_price_history
Read-only

Daily historical series for charting — one metal or the Goldback.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "metal": "<metal>"
    },
    "name": "get_price_history"
  }
}

Input Schema

NameRequiredDescriptionDefault
baseNoA currency code from the live catalog at /api/currencies (ISO 4217 fiat plus BTC and the metal codes). Defaults to USD.USD
daysNoHow many trailing days of history to return.
limitNo
metalYesThe metal (or Goldback) whose history to return.
cursorNoOpaque continuation token returned by the same tool with exactly the same filters.
formatNoohlc returns open/high/low/close rows; line returns closes.line

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / result / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "endDate": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "format": {
      -        "const": "line",
      -        "type": "string"
      -      },
      -      "nextCursor": {
      -        "anyOf": [
      -          {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "points": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "date": {
      -              "format": "date",
      -              "type": "string"
      -            },
      -            "price": {
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "date",
      -            "price"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 100,
      -        "type": "array"
      -      },
      -      "requestedDays": {
      -        "maximum": 3650,
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "series": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "const": "metal",
      -            "type": "string"
      -          },
      -          "metal": {
      -            "enum": [
      -              "gold",
      -              "silver",
      -              "platinum",
      -              "palladium",
      -              "copper",
      -              "nickel",
      -              "goldback"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "metal"
      -        ],
      -        "type": "object"
      -      },
      -      "startDate": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "unit": {
      -        "enum": [
      -          "troy_oz",
      -          "goldback"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "series",
      -      "base",
      -      "unit",
      -      "requestedDays",
      -      "startDate",
      -      "endDate",
      -      "nextCursor",
      -      "format",
      -      "points"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "endDate": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "format": {
      -        "const": "ohlc",
      -        "type": "string"
      -      },
      -      "nextCursor": {
      -        "anyOf": [
      -          {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "points": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "close": {
      -              "description": "Latest or session-close price in the result's shared base and unit.",
      -              "type": "number"
      -            },
      -            "date": {
      -              "format": "date",
      -              "type": "string"
      -            },
      -            "high": {
      -              "description": "Session high in the result's shared base and unit.",
      -              "type": "number"
      -            },
      -            "low": {
      -              "description": "Session low in the result's shared base and unit.",
      -              "type": "number"
      -            },
      -            "open": {
      -              "description": "Opening price in the result's shared base and unit.",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "open",
      -            "high",
      -            "low",
      -            "close",
      -            "date"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 100,
      -        "type": "array"
      -      },
      -      "requestedDays": {
      -        "maximum": 3650,
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "series": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "kind": {
      -            "const": "metal",
      -            "type": "string"
      -          },
      -          "metal": {
      -            "enum": [
      -              "gold",
      -              "silver",
      -              "platinum",
      -              "palladium",
      -              "copper",
      -              "nickel",
      -              "goldback"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "kind",
      -          "metal"
      -        ],
      -        "type": "object"
      -      },
      -      "startDate": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "unit": {
      -        "enum": [
      -          "troy_oz",
      -          "goldback"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "series",
      -      "base",
      -      "unit",
      -      "requestedDays",
      -      "startDate",
      -      "endDate",
      -      "nextCursor",
      -      "format",
      -      "points"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "endDate": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "format": {
      +        "const": "line",
      +        "type": "string"
      +      },
      +      "nextCursor": {
      +        "anyOf": [
      +          {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "points": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "date": {
      +              "format": "date",
      +              "type": "string"
      +            },
      +            "price": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "date",
      +            "price"
      +          ],
      +          "title": "LinePoint",
      +          "type": "object"
      +        },
      +        "maxItems": 100,
      +        "type": "array"
      +      },
      +      "requestedDays": {
      +        "maximum": 3650,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "series": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "const": "metal",
      +            "type": "string"
      +          },
      +          "metal": {
      +            "enum": [
      +              "gold",
      +              "silver",
      +              "platinum",
      +              "palladium",
      +              "copper",
      +              "nickel",
      +              "goldback"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "metal"
      +        ],
      +        "title": "MetalSeries",
      +        "type": "object"
      +      },
      +      "startDate": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "unit": {
      +        "enum": [
      +          "troy_oz",
      +          "goldback"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "series",
      +      "base",
      +      "unit",
      +      "requestedDays",
      +      "startDate",
      +      "endDate",
      +      "nextCursor",
      +      "format",
      +      "points"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "endDate": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "format": {
      +        "const": "ohlc",
      +        "type": "string"
      +      },
      +      "nextCursor": {
      +        "anyOf": [
      +          {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "points": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "close": {
      +              "description": "Latest or session-close price in the result's shared base and unit.",
      +              "type": "number"
      +            },
      +            "date": {
      +              "format": "date",
      +              "type": "string"
      +            },
      +            "high": {
      +              "description": "Session high in the result's shared base and unit.",
      +              "type": "number"
      +            },
      +            "low": {
      +              "description": "Session low in the result's shared base and unit.",
      +              "type": "number"
      +            },
      +            "open": {
      +              "description": "Opening price in the result's shared base and unit.",
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "open",
      +            "high",
      +            "low",
      +            "close",
      +            "date"
      +          ],
      +          "title": "OhlcPoint",
      +          "type": "object"
      +        },
      +        "maxItems": 100,
      +        "type": "array"
      +      },
      +      "requestedDays": {
      +        "maximum": 3650,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "series": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "kind": {
      +            "const": "metal",
      +            "type": "string"
      +          },
      +          "metal": {
      +            "enum": [
      +              "gold",
      +              "silver",
      +              "platinum",
      +              "palladium",
      +              "copper",
      +              "nickel",
      +              "goldback"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "kind",
      +          "metal"
      +        ],
      +        "title": "MetalSeries",
      +        "type": "object"
      +      },
      +      "startDate": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "unit": {
      +        "enum": [
      +          "troy_oz",
      +          "goldback"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "series",
      +      "base",
      +      "unit",
      +      "requestedDays",
      +      "startDate",
      +      "endDate",
      +      "nextCursor",
      +      "format",
      +      "points"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already declare readOnlyHint=true, openWorldHint=true and destructiveHint=false, so the safety profile is covered. The description adds the useful constraint that only one metal is returned per call, but omits behavior an agent needs: that days can reach 3650 while limit caps at 100, meaning long ranges require cursor pagination. That gap matters more than the terseness.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single short clause, front-loaded with the resource and format ('daily historical series') and followed by the scope constraint. Nothing wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With six parameters, a cursor token, a limit ceiling of 100 against a 3650-day range, and an output schema already handling return values, the definition is adequate but incomplete on the one non-obvious mechanic: pagination. An agent can call it correctly for short ranges but may not realize long ranges need cursor following.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 83%, so the baseline is 3. The description reinforces the single-metal scope of the metal enum, but adds nothing about how days and limit interact or when to supply cursor — the two parameters most likely to be misused.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States the resource and shape clearly: "Daily historical series for charting — one metal or the Goldback." The word "historical" implicitly separates it from get_spot_prices and get_goldback_rate, but those siblings are never named, so the differentiation is left to inference rather than made explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"For charting" implies a use case but gives no explicit when-to-use or when-not guidance, and does not mention get_spot_prices as the alternative for current values. An agent must deduce the boundary between this and the spot/rate siblings from their names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources