Skip to main content
Glama
Tickerbot MCP Server

Tickerbot MCP Server

Official
by tickerbot

tickerbot_list_tickers

List every tracked ticker, active or delisted, with filters for search, exchange, asset type, and asset class. Page through results to find symbols and their identity records.

Instructions

Lists every ticker we track, active or delisted, with its identity. For everything about one, use Get a ticker.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "tickerbot_list_tickers"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoPage size. Max 1000 until 2027-01-12, then 100 (a larger value is clamped to the max, not an error; see Deprecations).
activeNo`true` for tickers that trade today, `false` for delisted ones. Omit it for both.
cursorNoThe previous response's `next_cursor`. Send it with the same params as the first page (`limit` may change); a page whose params differ is a 400 naming the param.
searchNoCase-insensitive match on `ticker` or `name`, max 64 characters (longer is a 400). Results are ranked: an exact ticker match first, then symbols that start with the term, then symbols that contain it, then names that have it as a whole word, then names that contain it; alphabetical within each rank. The cursor carries the rank, so paging a search never repeats or skips.
tickerNoOne symbol or a comma-separated list (up to 50; more is a 400): just those tickers' identity records, in the usual order. A symbol we don't track is absent from `results` and listed in `not_found`. For everything about each one, put the list in the path of Get a ticker.
exchangeNoFilter by exchange name (one or a comma list): the value results carry in their `exchange` field. MIC codes (`XNAS`, `XNYS`, `BATS`) are also accepted and match `exchange_mic`. A malformed value (non-letters, over 16 chars) is a 400.
asset_typeNoFilter by instrument type within equities (one or a comma list): the stored `asset_type` value (`CS`, `ETF`, `ADRC`, `PFD`, `FUND`, `UNIT`, `SP`, `ETS`, `WARRANT`, `RIGHT`, `ETN`, `ETV`), matched case-insensitively. `equity` is a convenience value expanding to the equity-like set. This is not an asset class: `asset_type=crypto` is a 400 (use `asset_class=crypto`). Values: CS: Common stock. ETF: Exchange-traded fund. ADRC: ADR. PFD: Preferred stock. FUND: Fund. UNIT: Unit. SP: Structured product. ETS: Single-stock ETF. WARRANT: Warrant. RIGHT: Right. ETN: Exchange-traded note. ETV: Exchange-traded vehicle. equity: Equity.
asset_classNoFilter by asset class: `stocks`, `rates`, `crypto`, `fx` or a comma-separated list (the live classes today; validated for shape, not against a fixed list, so a well-formed class outside these matches nothing). Omit for every class. This is the class of instrument, distinct from `asset_type` below (the instrument type within equities). Every result carries its `asset_class`, so a non-equity result identifies itself.

Output Schema

NameRequiredDescriptionDefault
_metaNoWith `asset_class` only: `scope.asset_class` lists the classes the page was filtered to.
as_ofYesServer time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of).
countYesTickers in this page.
queryYesYour request echoed, each param with its effective value: `search`, `ticker`, `asset_class`, `asset_type` and `exchange` (lists), `active` and `limit`. A filter you did not send is `null`.
resultsYesOne identity record per ticker: the signals in the catalog's Identifiers & reference category (`ticker`, `name`, `asset_class`, `asset_type`, `exchange`, `country`, `currency_name`, `cik`, `composite_figi`, `active`, `delisted_utc` and the rest), nothing else. Delisted tickers (`active: false`) carry `delisted_utc` (ISO 8601); they are still addressable on the state route with `asof`.
not_foundNoWith `ticker` only: the symbols you named that we do not track, in request order; an empty array when we track every one. A tracked symbol that another filter or the page leaves out is not in it.
_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).
next_cursorYesOpaque token for the next page; `null` on the last page.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 schema fields changedv0.4.1
    • addedInput schema / properties / active
      Added value: +{
      +  "description": "`true` for tickers that trade today, `false` for delisted ones. Omit it for both.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / asset_class / description
      Previous value: -"Filter by asset class — `stocks`, `rates`, `crypto`, `fx`, or a comma-separated list. Omit for every class. Distinct from asset_type (the instrument type within equities)."New value: +"Filter by asset class: `stocks`, `rates`, `crypto`, `fx` or a comma-separated list (the live classes today; validated for shape, not against a fixed list, so a well-formed class outside these matches nothing). Omit for every class. This is the class of instrument, distinct from `asset_type` below (the instrument type within equities). Every result carries its `asset_class`, so a non-equity result identifies itself."
    • changedInput schema / properties / asset_type / description
      Previous value: -"Filter by INSTRUMENT TYPE within equities: the stored value (CS, ETF, ADRC, PFD, FUND, UNIT, SP, ETS, WARRANT, RIGHT, ETN, ETV), or \"equity\" for the equity-like set. This is not an asset class — `asset_type=crypto` is rejected; crypto is in the main list under its X: symbols."New value: +"Filter by instrument type within equities (one or a comma list): the stored `asset_type` value (`CS`, `ETF`, `ADRC`, `PFD`, `FUND`, `UNIT`, `SP`, `ETS`, `WARRANT`, `RIGHT`, `ETN`, `ETV`), matched case-insensitively. `equity` is a convenience value expanding to the equity-like set. This is not an asset class: `asset_type=crypto` is a 400 (use `asset_class=crypto`). Values: CS: Common stock. ETF: Exchange-traded fund. ADRC: ADR. PFD: Preferred stock. FUND: Fund. UNIT: Unit. SP: Structured product. ETS: Single-stock ETF. WARRANT: Warrant. RIGHT: Right. ETN: Exchange-traded note. ETV: Exchange-traded vehicle. equity: Equity."
    • addedInput schema / properties / asset_type / pattern
      Added value: +"^\\s*([cC][sS]|[eE][tT][fF]|[aA][dD][rR][cC]|[pP][fF][dD]|[fF][uU][nN][dD]|[uU][nN][iI][tT]|[sS][pP]|[eE][tT][sS]|[wW][aA][rR][rR][aA][nN][tT]|[rR][iI][gG][hH][tT]|[eE][tT][nN]|[eE][tT][vV]|[eE][qQ][uU][iI][tT][yY])(\\s*,\\s*([cC][sS]|[eE][tT][fF]|[aA][dD][rR][cC]|[pP][fF][dD]|[fF][uU][nN][dD]|[uU][nN][iI][tT]|[sS][pP]|[eE][tT][sS]|[wW][aA][rR][rR][aA][nN][tT]|[rR][iI][gG][hH][tT]|[eE][tT][nN]|[eE][tT][vV]|[eE][qQ][uU][iI][tT][yY]))*\\s*$"
    • changedInput schema / properties / cursor / description
      Previous value: -"Opaque cursor from a prior response."New value: +"The previous response's `next_cursor`. Send it with the same params as the first page (`limit` may change); a page whose params differ is a 400 naming the param."
    • changedInput schema / properties / exchange / description
      Previous value: -"Filter by exchange (e.g. \"XNYS\", \"XNAS\", \"BATS\")."New value: +"Filter by exchange name (one or a comma list): the value results carry in their `exchange` field. MIC codes (`XNAS`, `XNYS`, `BATS`) are also accepted and match `exchange_mic`. A malformed value (non-letters, over 16 chars) is a 400."
    • addedInput schema / properties / limit / default
      Added value: +50
    • changedInput schema / properties / limit / description
      Previous value: -"Page size. Max 1000. Default 50."New value: +"Page size. Max 1000 until 2027-01-12, then 100 (a larger value is clamped to the max, not an error; see Deprecations)."
    • removedInput schema / properties / min_market_cap
      Removed value: -{
      -  "description": "Minimum market cap in USD. Orders results by market_cap desc.",
      -  "type": "number"
      -}
    • changedInput schema / properties / search / description
      Previous value: -"Case-insensitive substring filter on ticker/name. Orders results by market_cap desc."New value: +"Case-insensitive match on `ticker` or `name`, max 64 characters (longer is a 400). Results are ranked: an exact ticker match first, then symbols that start with the term, then symbols that contain it, then names that have it as a whole word, then names that contain it; alphabetical within each rank. The cursor carries the rank, so paging a search never repeats or skips."
    • removedInput schema / properties / sector
      Removed value: -{
      -  "description": "Exact-match sector filter (e.g. \"Technology\").",
      -  "type": "string"
      -}
    • addedInput schema / properties / ticker
      Added value: +{
      +  "description": "One symbol or a comma-separated list (up to 50; more is a 400): just those tickers' identity records, in the usual order. A symbol we don't track is absent from `results` and listed in `not_found`. For everything about each one, put the list in the path of Get a ticker.",
      +  "type": "string"
      +}
    • removedInput schema / properties / tickers
      Removed value: -{
      -  "description": "Comma-separated symbols (max 50). When set, returns full rows for these symbols and pagination params are ignored.",
      -  "type": "string"
      -}
    • removedInput schema / properties / universe
      Removed value: -{
      -  "description": "Restrict to a universe slug (top_10, top_100, or a saved one).",
      -  "type": "string"
      -}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "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 `asset_class` only: `scope.asset_class` lists the classes the page was filtered to."
      +    },
      +    "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": "Tickers in this page.",
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "next_cursor": {
      +      "description": "Opaque token for the next page; `null` on the last page.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "not_found": {
      +      "description": "With `ticker` only: the symbols you named that we do not track, in request order; an empty array when we track every one. A tracked symbol that another filter or the page leaves out is not in it."
      +    },
      +    "query": {
      +      "description": "Your request echoed, each param with its effective value: `search`, `ticker`, `asset_class`, `asset_type` and `exchange` (lists), `active` and `limit`. A filter you did not send is `null`.",
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "results": {
      +      "description": "One identity record per ticker: the signals in the catalog's Identifiers & reference category (`ticker`, `name`, `asset_class`, `asset_type`, `exchange`, `country`, `currency_name`, `cik`, `composite_figi`, `active`, `delisted_utc` and the rest), nothing else. Delisted tickers (`active: false`) carry `delisted_utc` (ISO 8601); they are still addressable on the state route with `asof`.",
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "as_of",
      +    "query",
      +    "count",
      +    "next_cursor",
      +    "results"
      +  ],
      +  "type": "object"
      +}
  2. First observedv0.2.0

TDQS

A4/5.0
Behavior3/5

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

With no annotations, the description carries the full burden. It usefully discloses the inventory scope (includes delisted symbols, returns identity records only), but says nothing about result size, pagination, or any rate/volume constraints, despite this being a whole-catalog listing whose schema defaults to a page size of 50 and caps at 1000/100.

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?

Two short sentences with zero filler: scope first, then the sibling hand-off. Nothing is repeated from the schema and nothing needs trimming.

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 an 8-parameter, zero-required, paginated list tool with an output schema, the description covers purpose and the key sibling boundary. The remaining gap is that "every ticker we track" reads as unfiltered while the tool exposes rich filtering and cursor paging that an agent would benefit from knowing about up front.

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 100% and the parameter docs are unusually thorough (cursor coupling, search ranking, asset_type vs asset_class distinction, not_found behavior), so the schema does the heavy lifting. The description adds no parameter meaning beyond what is already structured, so the baseline 3 applies.

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

Purpose5/5

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

States a specific verb and resource ("Lists every ticker we track") plus scope ("active or delisted, with its identity"), and explicitly separates itself from the single-ticker sibling ("For everything about one, use Get a ticker"). An agent can distinguish it from tickerbot_get_ticker without opening either schema.

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

Usage Guidelines4/5

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

Gives a clear routing rule to the alternative tool for per-ticker detail, which is the main ambiguity for this catalog-listing operation. It does not address when to use the built-in filters (search, ticker, exchange) versus paging the full list, but that guidance is largely carried by the schema.

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