Skip to main content
Glama
Tickerbot MCP Server

Tickerbot MCP Server

Official
by tickerbot

@tickerbot/mcp-server

Model Context Protocol server for Tickerbot — the stock market, in SQL. Install in Claude, Cursor, VS Code Copilot, and other MCP-compatible clients to scan ~14,500 US-listed equities plus a curated set of rates, FX and crypto series, replay any day, or subscribe a query — across 421+ signal columns.

This package is a thin stdio bridge to the hosted Tickerbot MCP server at https://api.tickerbot.io/mcp. On start it reads the tool list from that server with your key, and it forwards every tool call there and returns the result unchanged. A tool added or changed on Tickerbot reaches you the next time your client starts the server, with no package update. Each request to the hosted server carries an X-Tickerbot-MCP-Client: @tickerbot/mcp-server/<version> header, so Tickerbot's call log can tell this package's traffic from other MCP clients; it is a label only.

Install

You need a Tickerbot API key. Get one from your dashboard.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tickerbot": {
      "command": "npx",
      "args": ["-y", "@tickerbot/mcp-server"],
      "env": {
        "TICKERBOT_API_KEY": "tb_live_..."
      }
    }
  }
}

Restart Claude Desktop.

Claude Code

claude mcp add tickerbot --env TICKERBOT_API_KEY=tb_live_... -- npx -y @tickerbot/mcp-server

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tickerbot": {
      "command": "npx",
      "args": ["-y", "@tickerbot/mcp-server"],
      "env": { "TICKERBOT_API_KEY": "tb_live_..." }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "tickerbot": {
      "command": "npx",
      "args": ["-y", "@tickerbot/mcp-server"],
      "env": { "TICKERBOT_API_KEY": "tb_live_..." }
    }
  }
}

Related MCP server: tradingview-mcp-server

Tools

The tools are whatever the hosted server lists when the bridge starts. At the time of this release that is 35 tools covering scans, signals, tickers (state, history, bars, coverage, ETF holdings), events and their kinds, news, universes and webhook subscriptions (scan, signal, ticker, events and news). History answers series keyed by symbol, one flat row per grain step, for one ticker or a comma list. tickerbot_list_events and tickerbot_search_news were renamed tickerbot_query_events and tickerbot_query_news; the old names still work, as deprecated tools, until 2027-01-12. An argument a tool does not declare is sent to the API, which answers unknown_parameter for it.

Tool

Endpoint

tickerbot_scan

POST /v2/scan

tickerbot_subscribe_scan

POST /v2/scan/subscribe

tickerbot_list_signals

GET /v2/signals

tickerbot_create_custom_signal

POST /v2/signals

tickerbot_get_signal

GET /v2/signals/{signal}

tickerbot_update_custom_signal

PATCH /v2/signals/{signal}

tickerbot_delete_custom_signal

DELETE /v2/signals/{signal}

tickerbot_subscribe_signal

POST /v2/signals/{signal}/subscribe

tickerbot_list_tickers

GET /v2/tickers

tickerbot_get_ticker

GET /v2/tickers/{ticker}

tickerbot_get_history

GET /v2/tickers/{ticker}/history

tickerbot_subscribe_ticker

POST /v2/tickers/{ticker}/subscribe

tickerbot_get_bars

GET /v2/tickers/{ticker}/bars/{interval}

tickerbot_get_ticker_coverage

GET /v2/tickers/{ticker}/coverage

tickerbot_get_etf_holdings

GET /v2/tickers/{ticker}/holdings

tickerbot_query_events

GET /v2/events

tickerbot_list_events

GET /v2/events (deprecated: use tickerbot_query_events; works until 2027-01-12)

tickerbot_list_event_kinds

GET /v2/events/kinds

tickerbot_subscribe_events

POST /v2/events/subscribe

tickerbot_query_news

GET /v2/news

tickerbot_search_news

GET /v2/news (deprecated: use tickerbot_query_news; works until 2027-01-12)

tickerbot_subscribe_news

POST /v2/news/subscribe

tickerbot_list_universes

GET /v2/universes

tickerbot_create_universe

POST /v2/universes

tickerbot_get_universe

GET /v2/universes/{universe}

tickerbot_update_universe

PATCH /v2/universes/{universe}

tickerbot_delete_universe

DELETE /v2/universes/{universe}

tickerbot_list_webhooks

GET /v2/webhooks

tickerbot_get_webhook

GET /v2/webhooks/{webhook}

tickerbot_update_webhook

PATCH /v2/webhooks/{webhook}

tickerbot_enable_webhook

PATCH /v2/webhooks/{webhook} (deprecated: use tickerbot_update_webhook with enabled: true; works until 2027-01-12)

tickerbot_delete_webhook

DELETE /v2/webhooks/{webhook}

tickerbot_list_webhook_deliveries

GET /v2/webhooks/{webhook}/deliveries

tickerbot_redeliver_webhook_delivery

POST /v2/webhooks/{webhook}/deliveries/{delivery}/redeliver

tickerbot_test_webhook

POST /v2/webhooks/{webhook}/test

Strategies are not exposed via MCP — see the REST API docs for those.

When the hosted server can't be reached

If api.tickerbot.io/mcp does not answer at start, the bridge serves the tool list bundled with this version, runs each call itself against the REST API, and writes a warning to stderr. The bundled list can be behind the server's. The bridge retries the server at most once a minute (on tools/list) and switches back when it answers. With no TICKERBOT_API_KEY set it does not contact the server: it lists the bundled tools and every call answers with how to set a key.

Examples

Open Claude and try:

"Find oversold semiconductor stocks bouncing on volume."

"What's NVDA's RSI and short interest right now?"

"How often has the gap-up + small-cap + high-RVOL setup hit over the last 30 days?"

"Save a signal called oversold_with_volume defined as rsi_14 < 30 AND volume_ratio_20d > 2."

Configuration

Env var

Default

Purpose

TICKERBOT_API_KEY

(required)

Your API key. Sent as Authorization: Bearer <key> to the hosted MCP server (and to the REST API in fallback).

TICKERBOT_API_URL

https://api.tickerbot.io

Override the base URL. The bridge connects to <base>/mcp; the fallback calls <base>/v2/....

Remote install

Clients that connect to an MCP server by URL (Claude.ai web/mobile, ChatGPT, and most desktop and IDE clients) can use the hosted server at https://api.tickerbot.io/mcp directly and sign in with OAuth, no package needed. See tickerbot.io/docs/mcp for setup.

Development

npm install
npm test                         # builds, then runs the bridge against a stubbed hosted server
node scripts/regen-tools.mjs     # refresh the bundled fallback list from ../tickerbot (optional)

License

MIT

Available Tools

35 tools
tickerbot_create_custom_signalBInspect

Saves a named true/false SQL expression you can screen on, select and subscribe to like a built-in boolean.

Inputs: expr (required), name (required), description. Returns: expr, kind, name, type, +6 more

tickerbot_create_universeCInspect

Saves a named list of tickers to scope screens and subscriptions.

Inputs: name (required), tickers (required), id, description. Returns: id, kind, name, size, +9 more

tickerbot_delete_custom_signalAInspect

Deletes one of your custom signals. Refused by default if another of your signals references it.

Inputs: signal (required), force.

tickerbot_delete_universeAInspect

Permanently deletes one of your universes. A universe any of your webhooks still uses answers 409 universe_referenced; force=true deletes it, and those webhooks are disabled at their next evaluation.

Inputs: universe (required), force.

tickerbot_delete_webhookBInspect

Deletes a webhook and its delivery history.

Inputs: webhook (required).

tickerbot_enable_webhookAInspect

Deprecated: works until 2027-01-12, then is removed. Turns a disabled webhook back on (a webhook disabled after repeated delivery failures, or one you turned off). It is tickerbot_update_webhook with enabled=true: call that instead.

Inputs: webhook (required). Returns: q, id, dir, kind, +34 more

tickerbot_get_barsBInspect

Returns OHLCV bars from 1s to monthly for one ticker or a comma list of up to 50 in the path, such as a screen's matches.

Inputs: ticker (required), interval (required), to, asof, +5 more. Returns: bars, note, _meta, as_of, +7 more

tickerbot_get_etf_holdingsAInspect

Returns an ETF's constituents and their weights, heaviest first, and its sector weights, for one ETF or a comma list of up to 50. Returns data.holdings and the sector mix data.sectors. When the ticker is not an ETF, data.is_etf is false and both are empty; data.is_etf: true with zero holdings means a real ETF whose holdings are not ingested yet. The reverse lookup ("which ETFs hold NVDA") is the etf_holders signal on tickerbot_get_ticker, or a scan: 'SMH' = ANY(etf_holders).

Inputs: ticker (required), limit, cursor. Returns: data, as_of, count, query, +3 more

tickerbot_get_historyAInspect

Returns the signals of one ticker or a comma list of up to 50 in the path (a screen's matches, say) over time, all-time: up to 25 signals in select, or * for every signal the grain stores, every ticker on one shared grid. series is keyed by symbol, one flat row per grain step. Paged backward: pass next_cursor back as cursor with the same params. For when a yes/no signal flipped, use tickerbot_query_events with kind=signal.

Inputs: ticker (required), to, asof, from, +4 more. Returns: _meta, as_of, count, query, +4 more

tickerbot_get_signalAInspect

Returns what one signal is (its catalog entry, the same object List signals returns for it) and every ticker matching it, live or on any past date with asof: a screen on that one signal. Returns catalog (what the signal is) every time. Booleans list their matches with no condition; every other type lists them only with one, typed like the signal: ">70" (numeric), "<YYYY-MM-DDTHH:MM:SSZ" (timestamp), ">=YYYY-MM-DD" (date), "=ETF" (string); without it you get the catalog entry and a note. Without order, a non-boolean sorts by its value in the direction the condition implies (< ascending, > descending). To know when each ticker started matching, use tickerbot_query_events with kind=signal, signal=, transition=enter.

Inputs: signal (required), dir, asof, grain, +6 more. Returns: note, _meta, as_of, count, +7 more

tickerbot_get_tickerAInspect

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.

Inputs: ticker (required), asof, grain, select. Returns: data, _meta, as_of, count, +3 more

tickerbot_get_ticker_coverageAInspect

Reports what we hold for one ticker or a comma list of up to 50, and how far back, so an empty result is never ambiguous. Ask this before treating a gap in bars or history as an outage. An absent 1m span is not a gap: sub-hour bars load on the first request for a symbol.

Inputs: ticker (required). Returns: data, as_of, count, query, +2 more

tickerbot_get_universeBInspect

Returns one universe: a built-in (top_10, top_100) or one you own.

Inputs: universe (required). Returns: id, kind, name, size, +9 more

tickerbot_get_webhookAInspect

Returns one webhook's current state.

Inputs: webhook (required). Returns: q, id, dir, kind, +33 more

tickerbot_list_event_kindsAInspect

Returns every event kind: what it is, whether it is in the default stream and can be subscribed to, what its ts means, and the fields you can name in q, select and group_by when you ask for that kind alone.

Inputs: no named parameters. Returns: as_of, count, kinds, _advisories, +1 more

tickerbot_list_eventsAInspect

Deprecated: works until 2027-01-12. Same as tickerbot_query_events; call that instead.

Inputs: q, to, dir, from, +14 more. Returns: _meta, as_of, count, query, +6 more

tickerbot_list_signalsAInspect

Lists every signal you can screen on: the built-ins and your custom signals, in one catalog you can filter, search and page. Use to discover the signal names and q vocabulary before composing a scan; custom signals appear with kind: custom. Narrow it with category, group, type, search and select=type,description rather than reading all ~460 rows.

Inputs: kind, type, grain, group, +7 more. Returns: as_of, count, query, signals, +4 more

tickerbot_list_tickersAInspect

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

Inputs: limit, active, cursor, search, +4 more. Returns: _meta, as_of, count, query, +4 more

tickerbot_list_universesAInspect

Lists every universe you can use: your own ticker lists and the built-in ones. kind: builtin lists the built-in universes (top_10, top_100); omit it for yours; builtin,custom lists both. Use a slug as universe on scan, signal and subscribe tools.

Inputs: kind, limit, cursor, search. Returns: as_of, count, query, universes, +2 more

tickerbot_list_webhook_deliveriesBInspect

Lists a webhook's recent deliveries: what was sent and what came back.

Inputs: webhook (required), to, from, limit, +2 more. Returns: as_of, count, deliveries, _advisories, +1 more

tickerbot_list_webhooksBInspect

Lists every webhook on your account, newest first.

Inputs: limit, cursor, status. Returns: as_of, count, webhooks, _advisories, +1 more

tickerbot_query_eventsAInspect

Queries events with SQL across every ticker or a screen's matches: earnings, dividends, splits, filings, insider trades and analyst actions, plus opt-in estimate revisions, news and signal firings. Requires at least one bound: a ticker scope (ticker/universe) or a time window (from/to); q alone is not a bound. With one kind, its payload fields are bare names in q/select/group_by (q: firm ILIKE 'Morgan Stanley', q: relevance >= 0.8 on news); tickerbot_list_event_kinds lists them. join: state adds the ticker's signals as of each event. Every result has a stable id: use it to drop duplicates. kind: signal takes custom signals too.

Inputs: q, to, dir, from, +14 more. Returns: _meta, as_of, count, query, +6 more

tickerbot_query_newsAInspect

Queries news with SQL for any ticker or a screen's matches: articles with how each one treats every ticker it mentions, or rollups when you group them. ticker (one or a comma list) keeps articles that mention it; add min_relevance: 0.8 to keep only articles about it. Each article carries mentions: per ticker, relevance and sentiment_score/sentiment. Naming ticker, relevance, sentiment_score or sentiment in q/select/group_by gives one row per article per mention: q: ticker = 'NVDA' AND sentiment_score < -0.3 is articles negative about NVDA. search is full-text over title and summary. Rollups with group_by/having return truncated: true instead of paging.

Inputs: q, to, dir, from, +10 more. Returns: as_of, count, query, results, +4 more

tickerbot_redeliver_webhook_deliveryAInspect

Resends a past delivery, with the exact body it carried, to the webhook's current target. The webhook must be active (409 otherwise); take delivery ids from tickerbot_list_webhook_deliveries. Test fires cannot be resent.

Inputs: webhook (required), delivery (required). Returns: id, test, as_of, event, +14 more

tickerbot_scanAInspect

Screens every ticker with a SQL WHERE clause and returns the matches. Run it now, or add asof to backtest it on any past date. The q grammar is a flat SQL WHERE over signal names: AND/OR/NOT, comparisons, numeric and string literals, custom signals by name. No JOIN or subqueries. With group_by the result is rollup rows, not tickers. Example: gap_up AND market_cap < 2000000000 AND NOT earnings_this_week.

Inputs: q (required), dir, asof, grain, +7 more. Returns: _meta, as_of, count, query, +5 more

tickerbot_search_newsAInspect

Deprecated: works until 2027-01-12. Same as tickerbot_query_news; call that instead.

Inputs: q, to, dir, from, +10 more. Returns: as_of, count, query, results, +4 more

tickerbot_subscribe_eventsAInspect

Gets you an alert by webhook when new events of the kinds you choose land, filtered on the event and on the ticker's signals. Webhooks need a paid plan (Free has no webhook slots). One q covers the event's fields (with one kind, bare: firm = 'Goldman Sachs') and the ticker's signals at fire time (market_cap > 1e10); on a name clash (price, cik) the ticker signal wins; the event's own value is payload->>'price'. Latency is the ingest cadence (analyst ≤1h, corporate kinds daily), not sub-minute.

Inputs: q, kind, name, select, +6 more. Returns: q, id, dir, kind, +36 more

tickerbot_subscribe_newsAInspect

Gets you an alert by webhook when a new article matches your search, tickers or SQL filter, with how it treats each ticker it mentions. Webhooks need a paid plan (Free has no webhook slots). Takes Query news's filters (search, ticker, universe, min_relevance, q); one of search/ticker/universe/q is required, since the whole market is about 6,000 articles a weekday. Fires as new matching articles land; each article fires once. Each delivery is event: "news.fired" with articles, each the Query news row (or select) plus mentions.

Inputs: q, name, search, select, +7 more. Returns: q, id, dir, kind, +36 more

tickerbot_subscribe_scanAInspect

Gets you an alert by webhook each time a ticker starts matching a screen. Webhooks need a paid plan (Free has no webhook slots). Use for "alert me when this happens" requests. For one signal use tickerbot_subscribe_signal; a compound condition is a scan: q: golden_cross AND rsi_14 > 70.

Inputs: q (required), dir, name, order, +7 more. Returns: q, id, dir, kind, +36 more

tickerbot_subscribe_signalAInspect

Gets you an alert by webhook each time a ticker starts matching one signal, bounded by a condition the way Get a signal is. Webhooks need a paid plan (Free has no webhook slots). A yes/no or custom signal takes no condition; any other signal needs one (<30). For a compound condition use tickerbot_subscribe_scan.

Inputs: signal (required), dir, name, order, +8 more. Returns: q, id, dir, kind, +36 more

tickerbot_subscribe_tickerAInspect

Gets you an alert by webhook each time one ticker starts matching a condition. Webhooks need a paid plan (Free has no webhook slots). Omit target_url for in-app delivery.

Inputs: ticker (required), q, name, select, +5 more. Returns: q, id, dir, kind, +36 more

tickerbot_test_webhookAInspect

Sends a sample delivery to your endpoint, instantly: the same shape, headers and signature as a real fire. One-shot: a failed test never retries and never auto-disables the webhook. 400 for an in-app webhook (nothing external to send to).

Inputs: webhook (required). Returns: id, test, as_of, event, +16 more

tickerbot_update_custom_signalBInspect

Updates a custom signal you own: its expression, description or name.

Inputs: signal (required), expr, new_name, description. Returns: expr, kind, name, type, +6 more

tickerbot_update_universeAInspect

Updates one of your universes: its name, description or members. tickers replaces the whole list; add/remove adjust it. Built-in universes cannot be edited.

Inputs: universe (required), add, name, remove, +2 more. Returns: id, kind, name, size, +9 more

tickerbot_update_webhookAInspect

Edits a webhook in place; send only the fields you want to change. The trigger takes the filters of the subscribe that made the webhook (subscription_origin.type: scan q/universe/select/order/dir; ticker q/select; signal condition/universe/select/order/dir; event kind/ticker/universe/q/select; news search/ticker/universe/min_relevance/q/select), validated like a new subscribe; a change to the filters fires only on new matches (what already matches or already happened does not fire), while an edit of select/order/dir keeps what already matched. enabled=true turns a disabled webhook back on. Unknown fields are a 400.

Inputs: webhook (required), q, dir, kind, +14 more. Returns: q, id, dir, kind, +34 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 35 tools

    Disambiguation4/5

    Most tools are cleanly separated by resource (bars vs history vs ticker vs ETF holdings vs events vs news vs universes vs webhooks), and the long descriptions call out the boundaries explicitly. The fuzzy zone is the subscribe family: subscribe_ticker (a ticker matching a condition), subscribe_signal (one signal + condition) and subscribe_scan (compound screen) are adjacent enough that an agent may pick wrong, and three deprecated aliases (list_events, search_news, enable_webhook) still sit in the catalog alongside their replacements.

    Naming Consistency4/5

    Nearly all tools follow a uniform tickerbot_verb_noun pattern (get_ticker, list_universes, create_custom_signal, delete_webhook, redeliver_webhook_delivery). Deviations are minor: the bare tickerbot_scan has no noun, and the verb choice flips between list_ and query_ for the same resource pair (list_events vs query_events, search_news vs query_news), though those are the deprecated/new split.

    Tool Count3/5

    35 tools is heavy, and three of them are deprecated aliases that add no capability. The breadth is partly justified (bars, signals, scans, history, events, news, ETF holdings, webhooks, universes are genuinely separate domains), but the surface could be trimmed toward the 15-20 range without losing functionality.

    Completeness5/5

    Full lifecycle coverage appears present: CRUD for universes, custom signals and webhooks, plus deliveries, redelivery and test-fire; read/query paths for tickers, coverage, bars, history, signals, scans, ETF holdings, events and news, with asof backtesting and paging. I can't identify a dead end an agent would hit for the stated purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Provides AI assistants with market screening, analysis, and scoring across stocks, crypto, and forex, enabling natural language queries for trading insights.
      4
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides real-time market data, technical analysis, screeners, and backtesting for stocks, crypto, forex, and futures across global exchanges, enabling AI assistants to fetch quotes, indicators, and strategy results via natural language.
      37
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to scan crypto and US stocks for beta-adjusted relative strength, momentum signals, RSI readings, and entry/stop/target trade plans, with watchlists validated against live data. Also lets users start a persistent background bot that pushes high-confidence setup alerts via desktop notifications or Discord/Slack webhooks.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to access low-latency global market data, including quotes, fundamentals, technical indicators, earnings context, sector movers, and options implied-volatility screening across equities, ETFs, FX pairs, and cryptocurrencies.
      8
      MIT