Tickerbot MCP Server
OfficialA hosted stock-market "SQL" MCP server: screen ~14,500 US equities plus rates/FX/crypto with SQL WHERE clauses over 400+ signals, read history/bars/events/news, and set up webhook alerts.
Scan & backtest:
tickerbot_scanscreens every ticker with a SQLq(AND/OR/NOT, comparisons, custom signals,ticker IN (...),asset_class='crypto'), withselect,group_byrollups/having,order,universescoping, cursors, andasof+grain(1m/1h/1d/auto) to replay any past moment.Signals: list/search the catalog (built-in + custom), get one signal's catalog entry and matching tickers (with typed
condition), and create/update/delete custom boolean signals.Tickers & price data: list tickers with identity/filters, fetch a ticker's full live or as-of state (1–50 symbols), OHLCV bars from
1sto1mo(adjusted/session options), time-series history at 1m–1y grains, coverage/backfill report, and ETF holdings + sector weights.Events: query earnings, dividends, splits, filings, insider trades, analyst actions, estimate revisions, news and signal enter/exit firings with SQL, kind filters,
join=state, windows, and rollups; list event kinds and their fields.News: SQL-query articles with per-ticker relevance/sentiment mentions, full-text
search, ticker/universe scoping,min_relevance, and group-by rollups.Universes: create, read, update and delete named ticker lists (up to 10,000 symbols) used to scope scans and alerts.
Webhook alerts: subscribe to scans, single signals, one ticker, event kinds, or news searches; list/get/update/enable/delete webhooks, inspect delivery history, redeliver past deliveries, and send a signed test fire. Channels: HTTPS webhook (HMAC-signed), Discord, in-app, mobile push.
Constraints noted: strategies are not exposed; deprecated tool aliases (
list_events,search_news,enable_webhook) keep working until 2027-01-12; webhooks require a paid plan.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tickerbot MCP Server Find oversold semiconductor stocks bouncing on volume."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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-serverCursor
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 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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_volumedefined asrsi_14 < 30 AND volume_ratio_20d > 2."
Configuration
Env var | Default | Purpose |
| (required) | Your API key. Sent as |
|
| Override the base URL. The bridge connects to |
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 toolstickerbot_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
Scored across 35 tools
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.
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.
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.
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
Related MCP Connectors
Scan options flow, analyze real-time market data, and build investing and trading workflows.
The data and trading platform for AI: decades of US market data, backtests in seconds.
Backtest US stock setups on 400K+ Trade-Ideas alerts since 2019. Your agent picks from 250+ filters, sees what happened on the day of every matching event, and simulates intraday entries and exits (win rate, profit factor, P&L per share). Also: ticker overviews, per-ticker gap history and today's premarket gappers. Pro adds a live market scanner and paper trading. Connect with OAuth or an API key; the free plan includes 50 requests a day.
Live market data, financial analysis, and portfolio research tools across 10,000+ tickers.
Related MCP Servers
AlicenseAqualityAmaintenanceProvides AI assistants with market screening, analysis, and scoring across stocks, crypto, and forex, enabling natural language queries for trading insights.4MIT- AlicenseBqualityDmaintenanceProvides 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.371MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT

ApexTick MCP Serverofficial
AlicenseAqualityBmaintenanceEnables 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.8MIT