Enables AI clients to scan, replay, and subscribe to financial data across 14,500 US equities, crypto, FX, and rates using SQL-like queries.
Also known as tickerbot/tickerbot-mcp, tickerbot-mcp, @tickerbot/mcp-server
- Stars
- 0
- Tools
- 33
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Nov 13, 2026
- License
- —
What is Tickerbot MCP?
Tickerbot enables AI clients to scan, replay, and subscribe to financial data across 14,500 US equities, crypto, FX, and rates using SQL-like queries. It exposes 33 tools, such as tickerbot_scan, tickerbot_subscribe_scan, tickerbot_list_signals.
Summary generated from the project's README
About Tickerbot MCP server
Analyzing financial markets through SQL-like queries is what this server enables for developers using AI clients. It provides access to data for approximately 14,500 US-listed equities, along with various crypto, FX, and rates series. Users can perform scans, replay historical data, or set up subscriptions for specific queries across more than 421 signal columns.
To use this server, you must provide a Tickerbot API key via the TICKERBOT_API_KEY environment variable. It integrates with local MCP-compatible clients such as Claude Desktop, Cursor, VS Code Copilot, and Claude Code using npx. For web-based chat applications that cannot run local subprocesses, a remote endpoint is available.
The toolset includes 33 specific functions for managing tickers, signals, events, news, and universes. Developers can use tools like tickerbot_scan to find specific market setups, tickerbot_get_history to retrieve past price action, or tickerbot_subscribe_scan to receive updates on specific market conditions.
What you can do with it
- 1Scanning for specific market setupsAsk the AI to identify semiconductor stocks that are currently oversold and showing increased volume.
- 2Retrieving real-time technical indicatorsRequest the current RSI and short interest levels for a specific ticker like NVDA.
- 3Creating and saving custom signalsDefine a new market signal using a specific logic string and save it to your account.
- 4Analyzing historical setup frequencyCalculate how many times a specific combination of market conditions has occurred over the past month.
Written from the project's README. Every use case is checked against a quote from it.
How to install Tickerbot MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Tickerbot MCP in Claude Code
$ claude mcp add --env 'TICKERBOT_API_KEY=<YOUR_TICKERBOT_API_KEY>' tickerbot-mcp -- npx -y @tickerbot/mcp-serverInstall Tickerbot MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"tickerbot-mcp": {
"command": "npx",
"args": [
"-y",
"@tickerbot/mcp-server"
],
"env": {
"TICKERBOT_API_KEY": "<YOUR_TICKERBOT_API_KEY>"
}
}
}
}Install Tickerbot MCP in VS Code
.vscode/mcp.json
{
"servers": {
"tickerbot-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tickerbot/mcp-server"
],
"env": {
"TICKERBOT_API_KEY": "<YOUR_TICKERBOT_API_KEY>"
}
}
}
}Install Tickerbot MCP in VS Code CLI
$ code --add-mcp '{"name":"tickerbot-mcp","type":"stdio","command":"npx","args":["-y","@tickerbot/mcp-server"],"env":{"TICKERBOT_API_KEY":"<YOUR_TICKERBOT_API_KEY>"}}'Install Tickerbot MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"tickerbot-mcp": {
"command": "npx",
"args": [
"-y",
"@tickerbot/mcp-server"
],
"env": {
"TICKERBOT_API_KEY": "<YOUR_TICKERBOT_API_KEY>"
}
}
}
}Install Tickerbot MCP in Codex
$ codex mcp add tickerbot-mcp --env 'TICKERBOT_API_KEY=<YOUR_TICKERBOT_API_KEY>' -- npx -y @tickerbot/mcp-serverInstall Tickerbot MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.tickerbot-mcp] command = "npx" args = ["-y", "@tickerbot/mcp-server"] [mcp_servers.tickerbot-mcp.env] TICKERBOT_API_KEY = "<YOUR_TICKERBOT_API_KEY>"
Install Tickerbot MCP in Gemini CLI
$ gemini mcp add -s user -e 'TICKERBOT_API_KEY=<YOUR_TICKERBOT_API_KEY>' tickerbot-mcp npx -- -y @tickerbot/mcp-serverInstall Tickerbot MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"tickerbot-mcp": {
"command": "npx",
"args": [
"-y",
"@tickerbot/mcp-server"
],
"env": {
"TICKERBOT_API_KEY": "<YOUR_TICKERBOT_API_KEY>"
}
}
}
}Tickerbot MCP tools 33
Detected from the READMEtickerbot_scantickerbot_subscribe_scantickerbot_list_signalstickerbot_create_custom_signaltickerbot_get_signaltickerbot_update_custom_signaltickerbot_delete_custom_signaltickerbot_subscribe_signaltickerbot_list_tickerstickerbot_get_tickertickerbot_get_historytickerbot_subscribe_ticker
Show all 33 toolsShow fewer tools
tickerbot_get_barstickerbot_get_ticker_coveragetickerbot_get_etf_holdingstickerbot_list_eventstickerbot_list_event_kindstickerbot_subscribe_eventstickerbot_search_newstickerbot_subscribe_newstickerbot_list_universestickerbot_create_universetickerbot_get_universetickerbot_update_universetickerbot_delete_universetickerbot_list_webhookstickerbot_get_webhooktickerbot_update_webhooktickerbot_delete_webhooktickerbot_list_webhook_deliveriestickerbot_redeliver_webhook_deliverytickerbot_enable_webhooktickerbot_test_webhook
Configuration
TICKERBOT_API_KEYRequiredSecretTickerbot API key (tb_live_… or tb_test_…). Get one at https://tickerbot.io/dashboard.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachabletickerbot/tickerbot-mcp is public and reachablegithub.com/tickerbot/tickerbot-mcp ↗Pass
- Package names this repository as its source@tickerbot/mcp-server names tickerbot/tickerbot-mcp as sourcenpmjs.com/package/@tickerbot/mcp-server ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @tickerbot/mcp-servernpmjs.com/package/@tickerbot/mcp-server/v/0.1.3#provenance ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-13github.com/tickerbot/tickerbot-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @tickerbot/mcp-serverPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model33 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHub@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-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
The tools are whatever the hosted server lists when the bridge starts. At the time of this release that is 33 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). Bars and History answer data: one symbol gives its rows, a comma list gives them keyed by symbol.
| Tool | Endpoint |
|---|---|
tickerbot_scan |
POST /v2/scan |
tickerbot_subscribe_scan |
POST /v2/scan/subscribe |
tickerbot_list_signals |
GET /v2/signals |
tickerbot_create_custom_signal |
POST /v2/signals |
tickerbot_get_signal |
GET /v2/signals/{signal} |
tickerbot_update_custom_signal |
PATCH /v2/signals/{signal} |
tickerbot_delete_custom_signal |
DELETE /v2/signals/{signal} |
tickerbot_subscribe_signal |
POST /v2/signals/{signal}/subscribe |
tickerbot_list_tickers |
GET /v2/tickers |
tickerbot_get_ticker |
GET /v2/tickers/{ticker} |
tickerbot_get_history |
GET /v2/tickers/{ticker}/history |
tickerbot_subscribe_ticker |
POST /v2/tickers/{ticker}/subscribe |
tickerbot_get_bars |
GET /v2/tickers/{ticker}/bars/{interval} |
tickerbot_get_ticker_coverage |
GET /v2/tickers/{ticker}/coverage |
tickerbot_get_etf_holdings |
GET /v2/tickers/{ticker}/holdings |
tickerbot_list_events |
GET /v2/events |
tickerbot_list_event_kinds |
GET /v2/events/kinds |
tickerbot_subscribe_events |
POST /v2/events/subscribe |
tickerbot_search_news |
GET /v2/news |
tickerbot_subscribe_news |
POST /v2/news/subscribe |
tickerbot_list_universes |
GET /v2/universes |
tickerbot_create_universe |
POST /v2/universes |
tickerbot_get_universe |
GET /v2/universes/{id} |
tickerbot_update_universe |
PATCH /v2/universes/{id} |
tickerbot_delete_universe |
DELETE /v2/universes/{id} |
tickerbot_list_webhooks |
GET /v2/webhooks |
tickerbot_get_webhook |
GET /v2/webhooks/{id} |
tickerbot_update_webhook |
PATCH /v2/webhooks/{id} |
tickerbot_delete_webhook |
DELETE /v2/webhooks/{id} |
tickerbot_list_webhook_deliveries |
GET /v2/webhooks/{id}/deliveries |
tickerbot_redeliver_webhook_delivery |
POST /v2/webhooks/{id}/deliveries/{delivery_id}/redeliver |
tickerbot_enable_webhook |
POST /v2/webhooks/{id}/enable |
tickerbot_test_webhook |
POST /v2/webhooks/{id}/test |
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 |
|---|---|---|
TICKERBOT_API_KEY |
(required) | Your API key. Sent as Authorization: Bearer <key> to the hosted MCP server (and to the REST API in fallback). |
TICKERBOT_API_URL |
https://api.tickerbot.io |
Override the base URL. The bridge connects to <base>/mcp; the fallback calls <base>/v2/.... |
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
Tickerbot MCP questions
How do I add Tickerbot MCP to Claude Code?
Run claude mcp add --env 'TICKERBOT_API_KEY=<YOUR_TICKERBOT_API_KEY>' tickerbot-mcp -- npx -y @tickerbot/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Tickerbot MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Tickerbot MCP provide?
It exposes 33 tools, including tickerbot_scan, tickerbot_subscribe_scan, tickerbot_list_signals, tickerbot_create_custom_signal, tickerbot_get_signal.
What assets can I analyze with Tickerbot?
You can scan approximately 14,500 US-listed equities, a curated set of rates, FX, and crypto series.