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.

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_..." }
    }
  }
}

Tools

19 tools covering tickers, signals, scans, universes, news, and webhook subscriptions.

Tool	Endpoint
tickerbot_list_tickers	GET /v2/tickers
tickerbot_get_ticker	GET /v2/tickers/{ticker}
tickerbot_get_ticker_history	GET /v2/tickers/{ticker}/history
tickerbot_get_ticker_events	GET /v2/tickers/{ticker}/events
tickerbot_list_signals_catalog	GET /v2/signals
tickerbot_get_signals_match	GET /v2/signals/{signal}
tickerbot_get_signal_history	GET /v2/signals/{signal}/{ticker}/history/{interval}
tickerbot_list_signal_events	GET /v2/signals/{signal}/{ticker}/events
tickerbot_scan	GET /v2/scan (live or asof)
tickerbot_list_universes	GET /v2/universes
tickerbot_get_universe	GET /v2/universes/{id}
tickerbot_create_universe	POST /v2/universes
tickerbot_create_custom_signal	POST /v2/signals
tickerbot_search_news	GET /v2/news/scan
tickerbot_subscribe_scan	POST /v2/scan/subscribe
tickerbot_subscribe_signal	POST /v2/signals/{signal}/subscribe
tickerbot_subscribe_ticker	POST /v2/tickers/{ticker}/subscribe
tickerbot_list_webhooks	GET /v2/webhooks
tickerbot_delete_webhook	DELETE /v2/webhooks/{id}

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

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> on every call.
TICKERBOT_API_URL	https://api.tickerbot.io	Override the API base URL (for staging or self-hosted).

Remote install

For consumer chat apps (Claude.ai web/mobile, ChatGPT) that don't run subprocesses, use the hosted remote MCP endpoint at https://mcp.tickerbot.io instead. See tickerbot.io/mcp-server for setup.

License

MIT