mcp

ONE named instrument, in full. Returns the Martingale Score (0-5), the current Startingale reading, the score breakdown, the sequence structure (spacing, rounds, quantity multipliers) and exchange availability for a single crypto or US stock. Use this when you already know the symbol; use search_instruments to find symbols. Answers in formatted text, not JSON. Costs 1 unit of the monthly quota: the cheapest call, so walking a handful of known symbols one by one is fine.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 10,
      "description": "Ticker symbol, not a name: BTC (not Bitcoin), ETH, SOL for crypto; AAPL, NVDA, MELI for US stocks. Case-insensitive. Use search_instruments if you only know the name."
    },
    "type": {
      "type": "string",
      "enum": [
        "crypto",
        "stock"
      ],
      "description": "Which catalogue to look in first. Default: crypto. Only an optimisation: if the symbol is not there, the other catalogue is searched automatically, so omitting this is safe."
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

THE QUERY TOOL: find instruments matching criteria across an asset class. Filter by minimum Martingale score, minimum Startingale, exchange and more; returns a ranked list. Use it when a filter OTHER than count or Startingale floor is needed: exchange, round count, or a minimum Martingale Score. If the only conditions are how many and a Startingale floor, list_top_crypto or list_top_stocks do the same in one step; for no conditions at all, use an overview. Answers in formatted text. Costs 3 units of the monthly quota.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "crypto",
        "stock"
      ],
      "description": "Which catalogue to search. One at a time, not both. Default: crypto."
    },
    "min_martingale": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "Keep only instruments at or above this Martingale Score. Scale 0-5, higher means the price behaviour fits the sequence structure better. Above 4 is the usual starting point for a shortlist. Default: 0 (no filter)."
    },
    "min_startingale": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "Keep only instruments at or above this Startingale reading: how well the CURRENT price sits versus the structure, unlike the Martingale Score which is about behaviour over time. Scale 0-5: above 4.5 reads Strong, above 3.75 Favorable, above 3.25 Moderate, below that Misaligned. Default: 0 (no filter)."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "kraken_pro",
        "hyperliquid"
      ],
      "description": "Keep only instruments that venue lists. Exactly one of: binance, kraken_pro (note the underscore), hyperliquid. This is a listing fact about the market, reported for callers who run their own execution; Tradingale places no orders on any venue, so it says nothing about where you can or should trade. Crypto only, stocks ignore it. Omit to search every venue."
    },
    "rounds": {
      "type": "string",
      "enum": [
        "4",
        "5"
      ],
      "description": "Keep only instruments whose sequence structure has this many rounds, a round being one rung of the ladder. Only 4 and 5 exist. Omit for both."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many to return, highest Martingale Score first. 1-20, default 10."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A RANKED LIST OF CRYPTOS, sized by you: choose how many (1-20) and an optional minimum Startingale. Use this when those two are the ONLY conditions; anything else (a venue, a round count, a minimum Martingale Score) needs search_instruments. For a fixed top 5 with no arguments, use crypto_overview. Answers in formatted text. Costs 3 units of the monthly quota.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many to return, highest Martingale Score first. 1-20, default 10."
    },
    "min_startingale": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "Keep only entries at or above this Startingale reading: how well the CURRENT price sits versus the structure, unlike the Martingale Score which ranks them. Scale 0-5: above 4.5 reads Strong, above 3.75 Favorable, above 3.25 Moderate, below that Misaligned. Default: 0 (no filter)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A RANKED LIST OF US STOCKS, sized by you: choose how many (1-20) and an optional minimum Startingale. Use this when those two are the ONLY conditions; anything else (a round count or a minimum Martingale Score) needs search_instruments. For a fixed top 5 with no arguments, use stock_overview. Answers in formatted text. Costs 3 units of the monthly quota.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many to return, highest Martingale Score first. 1-20, default 10."
    },
    "min_startingale": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "Keep only entries at or above this Startingale reading: how well the CURRENT price sits versus the structure, unlike the Martingale Score which ranks them. Scale 0-5: above 4.5 reads Strong, above 3.75 Favorable, above 3.25 Moderate, below that Misaligned. Default: 0 (no filter)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ONE SNAPSHOT OF BOTH MARKETS, no arguments. Top instruments across crypto AND US stocks together, ranked by Martingale Score (0-5), with their Startingale readings. Use this to open a conversation or answer "how do things look right now". For a single asset class use crypto_overview or stock_overview; to choose the count or filter, use search_instruments. Answers in formatted text. Costs 10 units of the monthly quota: the most expensive call, since it reads both catalogues; the single-class overviews cost half, so do not call this in a loop.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ONE SNAPSHOT OF CRYPTO ONLY, no arguments: the top 5 cryptos by Martingale Score (0-5) with their Startingale readings. Use this for a quick picture of crypto alone. To choose how many or apply a Startingale floor, use list_top_crypto; to cover stocks as well, use market_overview. Answers in formatted text. Costs 5 units of the monthly quota.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ONE SNAPSHOT OF US STOCKS ONLY, no arguments: the top 5 stocks by Martingale Score (0-5) with their Startingale readings. Use this for a quick picture of stocks alone. To choose how many or apply a Startingale floor, use list_top_stocks; to cover crypto as well, use market_overview. Answers in formatted text. Costs 5 units of the monthly quota.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}