Skip to main content
Glama
Tickerbot MCP Server

Tickerbot MCP Server

Official
by tickerbot

tickerbot_get_ticker

Retrieve all signals for one ticker or up to 50 comma-separated symbols, live or as of a past date, with results keyed by symbol and missing symbols reported.

Instructions

Returns everything about one ticker or a comma list of up to 50 in the path (a screen's matches, say): every signal each one carries, live or on any past date with asof. A comma list returns data keyed by symbol plus not_found. Crypto is the X-prefixed pair (X:BTCUSD); bare BTC/ETH are US-listed ETFs.

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": {
      "ticker": "<ticker>"
    },
    "name": "tickerbot_get_ticker"
  }
}

Input Schema

NameRequiredDescriptionDefault
asofNoTarget moment as `YYYY-MM-DD` (that day's close) or an ISO timestamp (that intraday moment; daily-only signals then carry the previous session's close, never that day's): the same read as it stood then, unlimited depth. Full contract under As of a past date.
grainNoOnly with `asof`. Grain the past state is read at: `1m`, `1h`, `1d` or `auto` (default). `auto` blends: each signal comes from its freshest grain at or before the instant (minute, then hourly, then the last closed daily session), so nothing is refused for grain and no ticker is dropped; `_meta.blended` and `_meta.grains_present` say what contributed. Pin a grain for the fastest response: one grain is read instead of three. A signal in `select` that the pinned grain does not store is a `400 interval_unavailable` naming the grains that carry it (`rsi_14`, fundamentals and valuation ratios are `1d`-only). Without `select`, the row carries the signals the pinned grain stores, and `_meta.signals_not_stored_at_grain` names the rest. A grain with no data for the ticker within its window (14 days for `1d`, 5 for `1h`/`1m`) is a `404 interval_unavailable`. `1m` and `1h` need a timestamp `asof`; with a bare date they are a `400 interval_unavailable`. A live read with `grain` is a 400. Values: 1m: Minute. The one-minute state at or before the instant. Covers the most liquid tickers and the signals stored at one minute. Needs a timestamp `asof`; with a bare date it is a `400 interval_unavailable`. 1h: Hour. The hourly state at or before the instant. Covers every ticker and the signals stored hourly. Needs a timestamp `asof`; with a bare date it is a `400 interval_unavailable`. 1d: Day. The last daily session closed before the instant; a bare date reads that day’s close. Covers every ticker and the most signals, including the daily-only ones such as `rsi_14`, fundamentals and valuation ratios. auto: Auto. Each signal from its freshest grain at or before the instant: minute, then hourly, then the last closed daily session. `_meta.blended` and `_meta.grains_present` say what contributed.auto
selectNoComma-separated signals to return: each row is `ticker` plus exactly these. Omit it, or send `*`, for the full row: every signal the ticker carries, or on an as-of read every signal the read's grain stores. An unknown signal is a 400, beside `*` too.
tickerYesOne symbol, or a comma-separated list of up to 50 for a response keyed by symbol. Case-insensitive. Equities are bare symbols (`NVDA`); every other class carries a prefix: rates (`R:SOFR`), crypto (`X:BTCUSD`), fx (`X:EURUSD`). Bare `BTC`/`ETH` are US-listed ETFs, not spot crypto. See Tickers.

Output Schema

NameRequiredDescriptionDefault
dataYesEverything about the ticker: every signal it carries (see the catalog). On the list form, an object keyed by symbol.
_metaNoWith `asof` only: how the result was reconstructed; on the list form, one block per symbol, keyed by symbol. This read's own keys: `signal_grains`, the grain each signal was served at (on a blended or pinned read), and `signals_not_stored_at_grain`, the signals a pinned grain does not store (on the full row, without `select`). Shared keys: see the `_meta` reference.
as_ofYesServer time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of).
countNoWith a comma list only: the symbols in `data`, that is, how many of the symbols asked for were found.
queryYesYour request echoed, each param with its effective value: `ticker` (the symbols, canonical, de-duplicated, in request order; a list even for one), `asof`, `grain` (`null` on a live read) and `select` (`null` for the full row; `["*"]` when you sent `*`).
not_foundNoWith a comma list only: the requested symbols we do not track, in request order. An empty array when every symbol was found; every symbol when none was (still a 200).
_advisoriesNoPresent only when the response carried a warning: `deprecated` (since, sunset_on, successor, warning; on a deprecated tool, successor names the tool to call), `rate_limit` (warning, retry_after_seconds, limit, remaining, reset_epoch_s) or `monthly_quota` (warning, limit, remaining, reset_epoch_s).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.4.1
    • changedInput schema / properties / asof / description
      Previous value: -"Optional YYYY-MM-DD or ISO timestamp. Date-only returns the row at close of that day; a timestamp returns the row as of that moment (finest tier covering each column)."New value: +"Target moment as `YYYY-MM-DD` (that day's close) or an ISO timestamp (that intraday moment; daily-only signals then carry the previous session's close, never that day's): the same read as it stood then, unlimited depth. Full contract under As of a past date."
    • addedInput schema / properties / grain
      Added value: +{
      +  "default": "auto",
      +  "description": "Only with `asof`. Grain the past state is read at: `1m`, `1h`, `1d` or `auto` (default). `auto` blends: each signal comes from its freshest grain at or before the instant (minute, then hourly, then the last closed daily session), so nothing is refused for grain and no ticker is dropped; `_meta.blended` and `_meta.grains_present` say what contributed. Pin a grain for the fastest response: one grain is read instead of three. A signal in `select` that the pinned grain does not store is a `400 interval_unavailable` naming the grains that carry it (`rsi_14`, fundamentals and valuation ratios are `1d`-only). Without `select`, the row carries the signals the pinned grain stores, and `_meta.signals_not_stored_at_grain` names the rest. A grain with no data for the ticker within its window (14 days for `1d`, 5 for `1h`/`1m`) is a `404 interval_unavailable`. `1m` and `1h` need a timestamp `asof`; with a bare date they are a `400 interval_unavailable`. A live read with `grain` is a 400. Values: 1m: Minute. The one-minute state at or before the instant. Covers the most liquid tickers and the signals stored at one minute. Needs a timestamp `asof`; with a bare date it is a `400 interval_unavailable`. 1h: Hour. The hourly state at or before the instant. Covers every ticker and the signals stored hourly. Needs a timestamp `asof`; with a bare date it is a `400 interval_unavailable`. 1d: Day. The last daily session closed before the instant; a bare date reads that day’s close. Covers every ticker and the most signals, including the daily-only ones such as `rsi_14`, fundamentals and valuation ratios. auto: Auto. Each signal from its freshest grain at or before the instant: minute, then hourly, then the last closed daily session. `_meta.blended` and `_meta.grains_present` say what contributed.",
      +  "pattern": "^\\s*(1[mM]|1[hH]|1[dD]|[aA][uU][tT][oO])\\s*$",
      +  "type": "string"
      +}
    • addedInput schema / properties / select
      Added value: +{
      +  "description": "Comma-separated signals to return: each row is `ticker` plus exactly these. Omit it, or send `*`, for the full row: every signal the ticker carries, or on an as-of read every signal the read's grain stores. An unknown signal is a 400, beside `*` too.",
      +  "type": "string"
      +}
    • changedInput schema / properties / ticker / description
      Previous value: -"Symbol. Case-insensitive. Equities: bare symbol (AAPL). Crypto: X-prefixed pair (X:BTCUSD) — bare BTC/ETH are US-listed ETFs, not spot crypto."New value: +"One symbol, or a comma-separated list of up to 50 for a response keyed by symbol. Case-insensitive. Equities are bare symbols (`NVDA`); every other class carries a prefix: rates (`R:SOFR`), crypto (`X:BTCUSD`), fx (`X:EURUSD`). Bare `BTC`/`ETH` are US-listed ETFs, not spot crypto. See Tickers."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "_advisories": {
      +      "description": "Present only when the response carried a warning: `deprecated` (since, sunset_on, successor, warning; on a deprecated tool, successor names the tool to call), `rate_limit` (warning, retry_after_seconds, limit, remaining, reset_epoch_s) or `monthly_quota` (warning, limit, remaining, reset_epoch_s).",
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "_meta": {
      +      "description": "With `asof` only: how the result was reconstructed; on the list form, one block per symbol, keyed by symbol. This read's own keys: `signal_grains`, the grain each signal was served at (on a blended or pinned read), and `signals_not_stored_at_grain`, the signals a pinned grain does not store (on the full row, without `select`). Shared keys: see the `_meta` reference."
      +    },
      +    "as_of": {
      +      "description": "Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of).",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "count": {
      +      "description": "With a comma list only: the symbols in `data`, that is, how many of the symbols asked for were found."
      +    },
      +    "data": {
      +      "anyOf": [
      +        {
      +          "properties": {
      +            "current_ticker": {},
      +            "date": {},
      +            "held_at_asof": {},
      +            "predecessors": {
      +              "items": {
      +                "properties": {
      +                  "cik": {},
      +                  "composite_figi": {},
      +                  "name": {},
      +                  "tenure_end": {},
      +                  "tenure_start": {}
      +                }
      +              },
      +              "type": [
      +                "array",
      +                "null"
      +              ]
      +            },
      +            "prior_symbols": {
      +              "items": {
      +                "properties": {
      +                  "tenure_end": {},
      +                  "tenure_start": {},
      +                  "ticker": {}
      +                }
      +              },
      +              "type": [
      +                "array",
      +                "null"
      +              ]
      +            },
      +            "symbol_reused": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "tenure_end": {},
      +            "tenure_start": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "ticker": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": {
      +            "properties": {
      +              "current_ticker": {},
      +              "date": {},
      +              "held_at_asof": {},
      +              "predecessors": {
      +                "items": {
      +                  "properties": {
      +                    "cik": {},
      +                    "composite_figi": {},
      +                    "name": {},
      +                    "tenure_end": {},
      +                    "tenure_start": {}
      +                  }
      +                },
      +                "type": [
      +                  "array",
      +                  "null"
      +                ]
      +              },
      +              "prior_symbols": {
      +                "items": {
      +                  "properties": {
      +                    "tenure_end": {},
      +                    "tenure_start": {},
      +                    "ticker": {}
      +                  }
      +                },
      +                "type": [
      +                  "array",
      +                  "null"
      +                ]
      +              },
      +              "symbol_reused": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "tenure_end": {},
      +              "tenure_start": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "ticker": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Everything about the ticker: every signal it carries (see the catalog). On the list form, an object keyed by symbol.",
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "not_found": {
      +      "description": "With a comma list only: the requested symbols we do not track, in request order. An empty array when every symbol was found; every symbol when none was (still a 200)."
      +    },
      +    "query": {
      +      "description": "Your request echoed, each param with its effective value: `ticker` (the symbols, canonical, de-duplicated, in request order; a list even for one), `asof`, `grain` (`null` on a live read) and `select` (`null` for the full row; `[\"*\"]` when you sent `*`).",
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "as_of",
      +    "query",
      +    "data"
      +  ],
      +  "type": "object"
      +}
  2. First observedv0.2.0

TDQS

A3.8/5.0
Behavior4/5

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

With no annotations, the description carries the behavioral burden and delivers: batch responses are keyed by symbol and include `not_found` for misses, past reads are 'unlimited depth', and the crypto-vs-ETF pitfall (bare BTC/ETH are US-listed ETFs, spot crypto is X-prefixed) prevents a common misread. It does not spell out that this is a read-only operation or detail response shape, though an output schema exists for the latter.

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?

Three sentences, front-loaded with what the tool returns, then batch keying, then the ticker-format caveat. Nothing is padded and each sentence carries distinct information.

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

Completeness4/5

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

For a four-parameter tool with an output schema, the description covers the headline behavior, batch semantics, missing-symbol handling and symbol format, while leaving the intricate grain/interval rules to the schema. Coverage is strong; only the absence of any sibling routing keeps it short of complete.

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 coverage is 100%, so the schema already documents `asof`, `grain`, `select` and `ticker` in depth. The description restates the `asof` intent and the symbol-prefix convention, which the schema also states, adding little genuinely new meaning beyond it. Baseline 3 is appropriate.

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 a specific verb and resource: 'Returns everything about one ticker or a comma list of up to 50'. The scope (all signals, live or as-of) is explicit, so an agent can tell it apart from a single-signal read. It does not name any sibling tool to differentiate against, so 4.

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?

Offers an implied use case ('a screen's matches, say') and clarifies that `asof` selects a past state, but never states when to prefer it over a sibling such as a single-signal or history tool, nor any when-not conditions. The more concrete routing guidance lives in the parameter descriptions rather than the main description.

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