Tickerbot

io.github.tickerbotPublished by GitHub account tickerbotv0.1.3Updated Nov 2, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Tickerbot lets an assistant query US stock and crypto market data in SQL-like terms: scan tickers, inspect signals, replay days, and set up webhook…

What you can do
  • Look up tickers, their details, price history and corporate events
  • Browse the signal catalog, check which tickers match a signal, and read signal history and events
  • Run scans across the universe live or as of a past date, and search market news
  • Create and list custom universes and custom signals
  • Create and list webhook subscriptions for scans, signals and tickers, and delete webhooks
When to use it
Useful when you want an assistant to screen equities or crypto against technical and signal criteria, check indicators such as RSI or short interest, backtest how often a setup triggered, or keep a saved query running as a subscription.
Requirements
A Tickerbot API key, supplied as the TICKERBOT_API_KEY environment variable or as an Authorization bearer header. Runs either as a local npm package via npx (Node.js) or as a hosted remote endpoint with OAuth. Network access to the Tickerbot API; the base URL can be overridden with TICKERBOT_API_URL.
Before you install
The API key is a billable-account credential sent on every call; keep it out of shared config files. Several tools write data: creating universes, custom signals and webhook subscriptions, and deleting webhooks. Queries, tickers and saved signals are sent to Tickerbot's servers.

Installation

In SourceWeft

  1. Open Tickerbot in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.tickerbot%2Fmcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "tickerbot": {
      "type": "http",
      "url": "https://api.tickerbot.io/mcp"
    }
  }
}

README

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

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

Restart Claude Desktop.

Claude Code

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

Cursor

Add to ~/.cursor/mcp.json:

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:

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.

ToolEndpoint
tickerbot_list_tickersGET /v2/tickers
tickerbot_get_tickerGET /v2/tickers/{ticker}
tickerbot_get_ticker_historyGET /v2/tickers/{ticker}/history
tickerbot_get_ticker_eventsGET /v2/tickers/{ticker}/events
tickerbot_list_signals_catalogGET /v2/signals
tickerbot_get_signals_matchGET /v2/signals/{signal}
tickerbot_get_signal_historyGET /v2/signals/{signal}/{ticker}/history/{interval}
tickerbot_list_signal_eventsGET /v2/signals/{signal}/{ticker}/events
tickerbot_scanGET /v2/scan (live or asof)
tickerbot_list_universesGET /v2/universes
tickerbot_get_universeGET /v2/universes/{id}
tickerbot_create_universePOST /v2/universes
tickerbot_create_custom_signalPOST /v2/signals
tickerbot_search_newsGET /v2/news/scan
tickerbot_subscribe_scanPOST /v2/scan/subscribe
tickerbot_subscribe_signalPOST /v2/signals/{signal}/subscribe
tickerbot_subscribe_tickerPOST /v2/tickers/{ticker}/subscribe
tickerbot_list_webhooksGET /v2/webhooks
tickerbot_delete_webhookDELETE /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 varDefaultPurpose
TICKERBOT_API_KEY(required)Your API key. Sent as Authorization: Bearer <key> on every call.
TICKERBOT_API_URLhttps://api.tickerbot.ioOverride 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

Source: README.md at commit 3c9d2ed

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.