@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):

config.json

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

Restart Claude Desktop.

Claude Code

Terminal

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

Cursor

Add to ~/.cursor/mcp.json:

config.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:

config.json

{
  "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