Connect your AI
Add ZenBot to Claude or ChatGPT and ask about your scans, a stock or a chart in plain words: “what’s on my Gap Up scan, and which ones have news?”, “read the NVDA daily chart”, “build me a scan for stocks near the 50 SMA with rising volume, and save it”. Your AI calls ZenBot for the data and answers from it, the same scans and numbers you see in the app. ZenBot describes, it never advises. Connecting is free with any ZenBot account: you get every tool on 15-minute delayed data. ZenBot Turbo adds real-time data and higher daily limits.
You add ZenBot as a connector and sign in with your ZenBot account. No keys, no settings files. In Claude and ChatGPT it is one click from their directories; other apps take the address:
https://www.zenbotscanner.com/mcp
Add to Claude
ZenBot is listed in Claude’s connector directory. It works in Claude on the web, the desktop app and the phone app: add it once and it is there on all of them.
- Open ZenBot Stock Scanner in Claude’s directory, or in Claude go to Settings, Connectors, Browse and search for ZenBot.
- Click Connect. The ZenBot login opens: sign in the way you usually do and click Accept to let Claude use your ZenBot account.
- Start a chat. ZenBot is in the tools menu (the sliders icon under the message box); make sure it is switched on, then ask “What’s on the Gap Up scan right now?”
Claude asks before ZenBot changes anything in your account, such as saving a scan or turning on alerts.
If your workspace hides the directory (some Team and Enterprise plans), add it by hand: Settings, Connectors, Add custom connector, name it ZenBot, paste https://www.zenbotscanner.com/mcp, open Advanced settings and paste qaDxACfEJgMY8zhPLW59XgZxb93uRWhE as the OAuth Client ID (leave the secret empty), click Add, then Connect.
Add to ChatGPT
ZenBot is listed in ChatGPT’s plugin directory. ChatGPT calls these plugins.
- Open ZenBot Stock Scanner in ChatGPT’s plugins and add it.
- The ZenBot login opens: sign in the way you usually do and click Accept to let ChatGPT use your ZenBot account.
- In a new chat, type @ in the message box, choose ZenBot and ask “What’s on the Gap Up scan right now?”
If your workspace hides the directory, add ZenBot by hand. Custom servers need a paid ChatGPT plan, and a Business or Enterprise workspace admin can switch them off.
- Go to chatgpt.com/plugins.
- Click +, then Add custom MCP server.
- Name it ZenBot. Under Connection, paste
https://www.zenbotscanner.com/mcpas the server URL. - Choose OAuth for authentication, then click Advanced OAuth settings and paste
qaDxACfEJgMY8zhPLW59XgZxb93uRWhEas the OAuth Client ID. Leave the client secret empty. - Read the warning, click I understand and want to continue, then Create as a plugin. ChatGPT lists ZenBot’s tools.
- The ZenBot login opens: sign in and click Accept.
- In a new chat, type @ in the message box, choose ZenBot and ask away.
If the login page says the callback URL is not allowed, copy the callback address shown on your ZenBot plugin’s page in ChatGPT (it starts with https://chatgpt.com/connector/oauth/) and email it to support@zenbotscanner.com. We’ll switch it on, usually the same day, and you click Connect again.
Cursor and VS Code
On the Connect AI page, under For developers, click Make a key, then Add to Cursor or Add to VS Code. The app opens with ZenBot Stock Scanner and your key filled in; confirm and it is connected.
What your AI can call
| Tool | What it returns |
|---|---|
| list_scans | Every built-in scan with its key, title, what it finds and how many stocks are on it now, plus your own custom scans. |
| get_scan_results | The stocks on a scan, up to 25, with price, change, relative volume, relative strength vs SPY, distance from VWAP, sector and more. Your custom scans too, by name. |
| get_ticker | One stock as the scanner sees it: price, move, volume, strength, levels, the scans it is on, earnings, options liquidity, headlines. Options and technicals on request. |
| why_on_scan | Every rule of a scan checked against a stock, with the values. |
| get_technicals | Every technical reading the scanner holds for one stock, as data: RSI, LRSI, MACD, ADX, TTM squeeze, EMAs with slopes and crosses, VWAP and AVWAP distances, Bollinger width, ZenTrend, ATR and ADR, relative strength vs SPY, relative volume, distances from the day’s levels and the 50/100/200-day averages, patterns and extremes. Two groups, the 5-minute chart and the daily; the field names are the scanner’s own. No bars. |
| search_filters | The filter catalog scans are built from: ids, units, timeframes, industries. |
| run_scan | Runs a scan spec on the live scanner: the funnel (how many stocks pass each condition), the total and up to 25 matches. Nothing is saved. |
| get_market | Indexes, breadth, sectors ranked, busiest scans, movers, ZenBot’s commentary and the top headlines. |
| get_calendar | The week’s economic events and earnings. |
| get_chart | A Fast Chart image (1m to daily) with the stock’s numbers, for the AI to read. |
| save_scan | Saves a spec into your account as a custom scan, named, with its share link. Your AI asks before it writes. |
| create_alert | Turns a scan’s alerts on or off in your account, built-in or custom. Delivery still needs your alerts switch and a channel in Alert Settings. |
| get_watchlist | Your Watchlist: the stocks flagged green, yellow and red, in your order, each with price, move and relative volume. |
| add_to_watchlist | Flags stocks on your Watchlist in a color; a stock already flagged moves to that color. The app updates at once. Your AI asks before it writes. |
| remove_from_watchlist | Takes stocks off your Watchlist, whatever their color. Your AI asks first. |
ZenBot also brings Ask Zen’s shortcuts into your AI. In Claude they are under the + menu once ZenBot is connected; each runs the task the way Ask Zen does, on your own AI:
- Explain a chart (a stock, and a timeframe if you like)
- How is a stock doing?
- What’s interesting right now?
- Plan tomorrow’s session
- Build a scan from a description
- Why is a stock on (or off) a scan?
- Answer like Zen: Zen’s rules for any ZenBot question
This user guide comes along too, as resources, so “how does the Age column work” is answered from these pages.
For developers: keys
Tools that don’t sign in with OAuth (Claude Code, scripts, some editors) use a connector key instead. On the Connect AI page, under For developers, click Make a key (keys come with ZenBot Turbo). The key is shown once with ready-made setup for each tool; copy it then. You can keep up to three keys and revoke any of them there.
- Claude Code:
claude mcp add --transport http zenbot https://www.zenbotscanner.com/mcp --header "Authorization: Bearer <your key>" - Cursor, VS Code, Windsurf: an
mcpServersentry with"url": "https://www.zenbotscanner.com/mcp"and the headerAuthorization: Bearer <your key>, or the Add to Cursor / Add to VS Code buttons shown with the key. - Claude Desktop with a key: the
mcp-remotebridge block shown with the key (needs Node.js). Adding a connector, above, is easier.
ZenBot is also in the official MCP Registry as com.zenbotscanner/zenbot, so editors and tools that read the registry can find it by name.
Keep the key private
Anyone with the key can read your scans. If it leaks, revoke it on the Connect AI page and make a new one.Limits and what it won’t do
A Turbo connection allows 120 calls a minute and 2,000 a day on real-time data. A free connection has a lower daily limit, higher in your first week, on 15-minute delayed data. Both have smaller daily caps on the single-stock and chart tools. Results stop at 25 rows and no tool returns raw price bars or the whole market: the connection is for your scans and the scanner’s read, not a data feed. If a Turbo subscription ends, the connection keeps working with the free tier’s delayed data and limits. Your AI’s own usage is covered by your Claude or ChatGPT plan, not billed by ZenBot.
Do I need Turbo?
No. A free account can do everything: ask about scans and stocks, read charts, build and save scans, turn on scan alerts and manage your Watchlist. The data is 15 minutes delayed, and there’s a daily limit that is higher in your first week. If you trade on what your AI tells you, Turbo gives it real-time data. Keys for your own scripts and agents also come with Turbo. Start a 14-day free trial from ZenBot Turbo.