Skip to content
Agentmart
Submit a tool

tickerbot/mcp-server

The stock market, in SQL — scan, replay, or subscribe across ~12k US tickers and top 100 cryptos.

Connector by tickerbot · GitHub account verified by the MCP Registry

IndexedLicense unknownLocal (stdio)Remote (HTTP)
Write a review

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/tickerbot-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://api.tickerbot.io/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

The stock market, in SQL — scan, replay, or subscribe across ~12k US tickers and top 100 cryptos.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
17 read · 12 write · 3 delete
Secrets
2 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 32

Read from the source code; the running server may list different tools.

Read 17 · Look things up without changing anything.

  • tickerbot_get_bars
  • tickerbot_get_etf_holdings
  • tickerbot_get_etf_sectors
  • tickerbot_get_series
  • tickerbot_get_signal
  • tickerbot_get_ticker
  • tickerbot_get_ticker_coverage
  • tickerbot_get_universe
  • tickerbot_get_webhook
  • tickerbot_list_events
  • tickerbot_list_signals
  • tickerbot_list_tickers
Show 5 more tools
  • tickerbot_list_universes
  • tickerbot_list_webhook_deliveries
  • tickerbot_list_webhooks
  • tickerbot_scan
  • tickerbot_search_news

Write 12 · Create, change, send or run things.

  • tickerbot_create_custom_signal
  • tickerbot_create_universe
  • tickerbot_create_webhook
  • tickerbot_enable_webhook
  • tickerbot_subscribe_events
  • tickerbot_subscribe_scan
  • tickerbot_subscribe_signal
  • tickerbot_subscribe_ticker
  • tickerbot_test_webhook
  • tickerbot_update_custom_signal
  • tickerbot_update_universe
  • tickerbot_update_webhook

Delete 3 · Delete, drop, revoke or wipe things.

  • tickerbot_delete_custom_signal
  • tickerbot_delete_universe
  • tickerbot_delete_webhook

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • Authorization
  • TICKERBOT_API_KEY

Network hosts it talks to 1

  • api.tickerbot.io · found in remote endpoint, install command

Files it touches

  • Any path the agent passes to its tools

Tools (32)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • tickerbot_create_custom_signal

    A named boolean predicate you can reference anywhere a built-in signal goes.

  • tickerbot_create_universe

    Create a named ticker list owned by your account.

  • tickerbot_create_webhook

    Canonical create: a webhook is a trigger plus a delivery. Trigger shapes: scan {type:"scan", q, universe?}; ticker {type:"ticker", ticker, condition}; signal {type:"signal", signal, ticker?, universe?, condition?}; event {type:"event", kinds, tickers?, universe?, event_q?}. The subscribe tools are flat sugar over exactly this. Webhooks need a paid plan (Free has no webhook slots).

  • tickerbot_delete_custom_signal

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

  • tickerbot_delete_universe

    Permanently delete one of your universes. Webhooks that reference the deleted universe fail on their next eval — clean those up first.

  • tickerbot_delete_webhook

    Delete a webhook subscription, and its delivery history with it.

  • tickerbot_enable_webhook

    Re-enable a disabled webhook and start it clean. Clears match-state, so the next eval treats every currently-matching ticker as new.

  • tickerbot_get_bars

    OHLCV bars from 1-second through monthly. The feed underneath the table.

  • tickerbot_get_etf_holdings

    Returns an ETF's constituents and their weights, heaviest first. When the ticker is not an ETF, `is_etf` is false and `holdings` is empty; `is_etf: true` with zero holdings means a real ETF whose holdings are not ingested yet. The reverse lookup ("which ETFs hold NVDA") is a scan filter on `etf_holders`, not this tool.

  • tickerbot_get_etf_sectors

    Returns an ETF's sector weights, heaviest first. Always complete, since sector breakdowns are small. When the ticker is not an ETF, `is_etf` is false and `sectors` is empty.

  • tickerbot_get_series

    Any signals for any tickers on one shared time grid — up to 50 tickers by 25 columns per call. One flat row per ticker per interval step, cursor-paged backward. `transitions_only: true` with boolean signals returns only the rows where a boolean flipped.

  • tickerbot_get_signal

    The state of a signal is the set of tickers matching it right now, or with `asof`, as of any moment. One name, the whole market, one call. Booleans need no `condition`; numerics need one like ">70". Sorted by signal value desc for numerics.

  • tickerbot_get_ticker

    The full ticker row, every signal on the schema page, for one symbol or a comma list of up to 50. Right now, or with `asof`, as of any past date. Pass a comma list of up to 50 symbols for a batch (`data` keyed by symbol plus `not_found`). Crypto is the X-prefixed pair (X:BTCUSD) — bare BTC/ETH are US-listed ETFs.

  • tickerbot_get_ticker_coverage

    For one ticker, what we hold and how far back — so an empty result is never ambiguous. Ask this before treating a gap in bars or series as an outage. `minute_tier.included: false` with `on_demand: true` is not a gap — sub-hour bars fetch from the provider on first request.

  • tickerbot_get_universe

    Returns the universe doc. Use `top_10`/`top_100` to fetch a system universe; any other slug must be one your account owns.

Show 17 more tools
  • tickerbot_get_webhook

    The current state of one webhook subscription.

  • tickerbot_list_events

    One timeline across every ticker: earnings, dividends, splits, insider filings, analyst actions, plus opt-in signal firings and news. Requires at least one bound: a ticker scope (ticker/tickers/universe), a time window (from/to), or firm/action — `q` alone is not a bound. `firm`/`action` match case-insensitively; a `q` payload match is case-sensitive. `join: state` attaches the ticker state as of each event.

  • tickerbot_list_signals

    Every signal you can name in a query — the built-in signals and your own custom signals, in one catalog. Use to discover the signal names and `q` vocabulary before composing a scan; custom signals appear with `kind: custom`.

  • tickerbot_list_tickers

    Every symbol we track, active or delisted, as one identity row each. Use `/v2/tickers/{ticker}` for the full row.

  • tickerbot_list_universes

    Every universe you can reference: your own named ticker lists and the built-in ones. `owner: system` lists the built-in universes (top_10, top_100); `all` lists both. Use a slug as `universe` on scan, signal, and subscribe tools.

  • tickerbot_list_webhook_deliveries

    Recent deliveries for one webhook — what was sent, and what came back.

  • tickerbot_list_webhooks

    Every webhook subscription on this account, newest first.

  • tickerbot_scan

    Every ticker matching a SQL WHERE clause. Right now, or with `asof`, as of 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`.

  • tickerbot_search_news

    SQL query over the news archive. Article rows, or rollups when you group them. Filter to a ticker with the `ticker` param, or in `q` via the auto-unnest alias `tk = 'NVDA'`. `search` is full-text over title and summary. Rollups with group_by/having return `truncated: true` instead of paging.

  • tickerbot_subscribe_events

    Push new events: we POST your endpoint when events of the kinds you chose land in the archives. Webhooks need a paid plan (Free has no webhook slots). `q` filters the ticker STATE; `event_q` filters the EVENT payload in the /v2/events grammar. Latency is the ingest cadence (analyst ≤1h, corporate kinds daily), not sub-minute.

  • tickerbot_subscribe_scan

    Push a whole query: we POST your endpoint every time the match set changes. Webhooks need a paid plan (Free has no webhook slots). Use for "alert me when this happens" requests.

  • tickerbot_subscribe_signal

    Push one signal: we POST your endpoint whenever any ticker starts matching it. Webhooks need a paid plan (Free has no webhook slots). Omit `ticker` to watch the whole universe.

  • tickerbot_subscribe_ticker

    Push one ticker: we POST your endpoint whenever it matches the condition you give. Webhooks need a paid plan (Free has no webhook slots). Omit `target_url` for in-app delivery.

  • tickerbot_test_webhook

    Send a real-shape test POST to your endpoint, instantly. One-shot: a failed test never retries and never auto-disables the webhook. 400 when the webhook has no target_url.

  • tickerbot_update_custom_signal

    Update a custom signal you own — its expression, description, or name.

  • tickerbot_update_universe

    Update one of your universes: its name, description, or members. `tickers` replaces the whole list; `add`/`remove` adjust it. System universes cannot be edited.

  • tickerbot_update_webhook

    Edit a webhook in place — send only the fields you want to change. The trigger and channel are immutable — delete and re-create to change what fires or where it delivers. Unknown fields are a 400.

Signals

Stars
0
Forks
0
Open issues
0
Last commit
Sep 17, 2026 (1 month ago)
Last release
Jun 11, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.tickerbot/mcp-server
Version
0.1.3
Auth
Bearer token, API key
Packages
npm @tickerbot/mcp-server
License
License unknown
Repository
github.com/tickerbot/tickerbot-mcp
Website
tickerbot.io/mcp-server
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

tickerbot/mcp-server. Agent Mart. https://agentmart.dev/connectors/tickerbot-mcp-server (last updated 2026-10-24)