Skip to main content
Glama
seungdori

tickscope-mcp

by seungdori

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TICKSCOPE_EXCHANGESNoEnabled exchanges (comma-separated)binance,bybit,okx
TICKSCOPE_LOG_LEVELNoLog levelINFO
TICKSCOPE_TRANSPORTNoTransport type: stdio or httpstdio
TICKSCOPE_REST_RETRIESNoRetry attempts for transient REST errors3
TICKSCOPE_DEFAULT_EXCHANGENoDefault exchange when not specifiedbinance
TICKSCOPE_OHLCV_CACHE_PATHNoDuckDB cache file path~/.tickscope/ohlcv.duckdb
TICKSCOPE_RING_BUFFER_SIZENoPer-symbol trade buffer size1000
TICKSCOPE_OHLCV_CACHE_TTL_SNoFreshness window for the newest candle in seconds60
TICKSCOPE_SCREEN_CONCURRENCYNoMax concurrent symbols during screening/aggregation5
TICKSCOPE_MAX_WATCHED_SYMBOLSNoMax concurrent WebSocket subscriptions (LRU evicted)25

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_exchangesA

List the exchanges this server is configured to use.

Returns the configured exchange ids and the default one used when a tool call omits the exchange argument.

list_symbolsA

List tradable symbols on an exchange, optionally filtered.

Use to discover valid symbols before other calls. quote filters by quote currency (e.g. USDT); search is a case-insensitive substring match (e.g. BTC).

server_statusB

Health and diagnostics: uptime, exchanges, watch count, cache rows, ccxt version, and WebSocket reconnect count.

get_tickerA

Get the current price snapshot for a symbol (the primary quote tool).

Returns last/bid/ask, 24h high/low/volume, 24h change %, plus freshness fields source (websocket|rest), age_ms and timestamp. The first (cold) call answers via REST and starts a live WebSocket watch, so subsequent calls return fresher websocket-sourced data.

get_recent_tradesA

Get the most recent executed trades (ticks) from the live buffer.

Falls back to a REST snapshot (and starts watching) when the buffer is cold. limit is capped at 1000.

get_ohlcvA

Get historical OHLCV candles (basis for charts and indicators).

Served from a DuckDB cache first, topping up only the missing tail via REST. timeframe accepts values like 1m,5m,15m,1h,4h,1d; since accepts ISO-8601 or epoch-ms. limit is capped at 1000.

get_orderbookA

Get the current order book snapshot with computed spread.

Returns top-depth bids/asks (capped at 100), spread and spread_pct, plus freshness fields. Uses the live WebSocket buffer when warm, otherwise REST.

get_funding_rateA

Get the current (and predicted) funding rate for a perpetual future.

Symbol should be a perpetual (e.g. BTC/USDT:USDT). Returns a structured error if the exchange does not support funding rates.

compute_indicatorsA

Compute technical indicators for a symbol/timeframe.

indicators is a list of specs "name:param1,param2", e.g. ["rsi:14", "macd:12,26,9", "ema:20", "bbands:20,2", "supertrend:10,3", "stochrsi", "ichimoku"]. Pine-style aliases like "ta.rsi(14)" and "ta.ema(20)" are also accepted.

Supported (73):

  • MAs/overlays: sma, ema, wma, smma, dema, tema, hma, vwma, zlema, alma, kama, trima, lsma, vidya, t3, vwap, vwapbands, bbands, donchian, keltner, supertrend, ichimoku, psar

  • Momentum: rsi, stochrsi, macd, ppo, stoch, cci, willr, roc, mom, tsi, ao, cmo, uo, dpo, trix, coppock, kst, fisher, rvi, mfi, wavetrend, squeeze, qqe, crsi, stc, elderray, zscore, linregslope

  • Volatility: atr, natr, stdev, hv, chop, ulcer, massindex

  • Volume: obv, adl, cmf, chaikinosc, eom, fi, pvt, vo, klinger

  • Trend: adx, dmi, aroon, vortex

  • Structure: heikinashi, pivots

Returns each indicator's latest value(s) plus derived signals: RSI/MFI/ StochRSI/UO/CRSI/STC overbought-oversold state; MACD/PPO/WaveTrend/ QQE cross; zero-line cross for oscillators (ao/tsi/cmo/trix/ roc/mom/zscore); supertrend/psar direction & flip; squeeze on/off; dmi/heikinashi trend; ichimoku cloud signal. Set include_series=true for each indicator's primary time series. Pine aliases include ta.wt, ta.sqz, ta.ha.

screen_marketA

Screen many symbols by indicator and price conditions.

filters is a list of conditions, each either indicator- or metric-based, e.g. [{"indicator":"rsi:14","op":"<","value":30}, {"metric":"change_24h_pct","op":">","value":5}]. op is one of < <= > >= == !=.

When symbols is omitted, the top top_n symbols by 24h volume for the given quote currency are screened. Runs with bounded concurrency to respect rate limits; per-symbol failures are returned in errors.

watch_symbolA

Pre-warm a live WebSocket subscription for a symbol (optional).

Most tools auto-watch on first use, so this is only needed to warm a buffer ahead of time. channels defaults to ["ticker","trades"]; valid channels are ticker, trades, orderbook, and ohlcv. For ohlcv, suffix the timeframe so the forming candle overlays your get_ohlcv queries on that timeframe — e.g. "ohlcv:1h" to enrich 1h candles (a bare "ohlcv" defaults to 1m and only overlays 1m queries). When the watch cap is exceeded, the least-recently-used symbol is released.

get_watched_symbolsA

List currently active WebSocket subscriptions and their buffer state (diagnostic): channels, buffer size, last update and staleness.

detect_divergenceA

Detect regular/hidden bullish & bearish divergence between price and an oscillator.

Compares the two most recent confirmed pivot highs (for bearish) and pivot lows (for bullish). oscillator is any indicator spec (rsi:14, macd:12,26,9, cci:20, mfi:14, …). left and right set the pivot confirmation window. Returns the detected divergences with their pivot price/oscillator values and bar offsets.

detect_crossA

Pine-style crossover analysis (ta.crossover/ta.crossunder).

series_a and series_b are each an indicator spec (ema:20, ta.sma(50)), a price source (close, hl2, …) or a numeric constant ("30"). Example: a golden cross is series_a="ema:50", series_b="ema:200". Returns the latest values, their relation, whether a cross happened on the last bar, and how many bars since the last cross.

detect_patternsA

Detect candlestick patterns on the most recent lookback candles.

Recognizes doji (incl. dragonfly/gravestone), hammer/hanging man, inverted hammer/shooting star, marubozu, spinning top, bullish/bearish engulfing & harami, piercing line, dark cloud cover, tweezers, morning/ evening star, and three white soldiers/black crows. Each result carries its conventional bias (bullish/bearish/neutral) and bars_ago.

analyze_structureA

Analyze market structure: swing highs/lows, trend, BOS / CHoCH.

Builds an alternating swing sequence from confirmed pivots, labels each as HH/HL/LH/LL, infers trend (uptrend/downtrend/range), and reports whether the latest bar broke the most recent swing as a Break of Structure (continuation) or Change of Character (reversal). left/ right set the pivot confirmation window.

find_support_resistanceA

Find clustered support/resistance zones from swing pivots.

Groups pivot highs/lows that lie within tolerance_pct of each other into zones; each zone's touches is its strength. Returns the nearest support (below price) and resistance (above price) zones with their distance from the current price.

get_aggregated_priceA

Aggregate a symbol's price across multiple exchanges (arbitrage view).

Fetches the ticker on each configured (or given) exchange concurrently and returns the 24h-volume-weighted average price, the simple mean, the cheapest/most-expensive venue, and the cross-exchange spread (arb_spread / arb_spread_pct) — the foundation for spotting arbitrage. Venues that fail or lack the symbol are skipped.

deep_analyzeA

Thorough, evidence-backed read of one symbol across multiple timeframes.

Returns, in a single call:

  • per-timeframe trend (HH/HL structure, BOS/CHoCH) and momentum,

  • statistical & market-state context (price percentile, ADX/efficiency trend state, ATR volatility state) so each value is interpretable,

  • the historical forward-return distribution of the current divergence signal on this symbol/timeframe — a strictly causal event study,

  • a synthesized verdict: bias, confidence, multi-timeframe agreement and explicit caveats.

Prefer this over the lighter compute_indicators / analyze_structure / detect_divergence when the user wants a thorough judgement, asks whether a setup is worth taking, or says "analyze X deeply". It is heavier (reads several timeframes + runs an event study), so use the single-shot tools for quick one-value questions.

timeframes defaults to a 1d/4h/1h ladder (highest -> execution). Read-only public market data; not financial advice.

Prompts

Interactive templates invoked by user choice

NameDescription
deep_analyzeGuided deep multi-timeframe analysis of a crypto symbol.

Resources

Contextual data attached and managed by the client

NameDescription
server_statusTickscope health and diagnostics snapshot.
watched_symbolsCurrently watched symbols with buffer state and staleness.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/seungdori/tickscope-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server