Getting Started
Dashboard Guides
Trading Guides
Reference
Telegram Integration
Need Help?
Join our community for support, updates, and trading discussions.
AI Chat & Tool Calling
Interact with ScreenerBot through natural conversation. Ask questions, analyze tokens, manage positions, and execute trades using an intelligent assistant with full bot access.
What is AI Chat?
Conversational Bot Control
AI Chat provides a ChatGPT-like interface to interact with your trading bot. Instead of clicking through menus, simply ask questions or give commands in natural language. The Assistant understands context and can execute actions through integrated tools.
This is similar to MCP (Model Context Protocol) - the Assistant has access to a set of tools that let it check balances, analyze tokens, view positions, and even execute trades with your confirmation.
Available Tools
The Assistant has access to 15 tools organized into 5 categories:
Analysis Tools
analyze_token - Full token analysischeck_security - Security risk checkget_market_data - Live market dataPortfolio Tools
get_balance - Check SOL balanceget_positions - List open positionsget_position - Position detailsget_pnl - Profit/loss statsTrading Tools
buy_token - Execute buy ordersell_token - Execute sell orderclose_position - Close position⚠️ Requires user confirmation
Config Tools
get_config - View settingsupdate_config - Change settings⚠️ Requires user confirmation
System Tools
get_status - System statusget_events - Recent eventsforce_stop - Emergency stopTool Permissions
Control how the Assistant handles different types of actions:
Allow
Execute immediately without confirmation. Best for read-only tools like checking balance or viewing positions.
Ask User
Show a confirmation dialog before executing. Required for trading and config changes. You can review the action and approve or deny it.
Deny
Block the tool entirely. The Assistant will explain that this action is not permitted in your configuration.
Permission Categories
Example Conversations
Check my wallet balance
Your wallet balance is 0.0707 SOL. Wallet address: 6uod...cGMv
Analyze BONK token
Bonk analysis:
• Liquidity: $270K
• Market Cap: $640M
• 24h Change: +2.34%
• Volume: $1.2M
Configuration
Enable and configure AI Chat in the Assistant → Settings tab or Config → Assistant section:
Key Settings
chat_enabledEnable/disable the Chat featurechat_max_session_messagesMaximum messages per session (default: 100)chat_auto_summarizeAutomatically summarize long conversationstool_permissions_*Permission level for each tool category (allow/ask_user/deny)Important Notes
Trading Requires Confirmation
By default, all trading actions (buy, sell, close) require your explicit confirmation. This prevents accidental trades. Only change this if you fully trust the Assistant.
API Key Required
AI Chat requires a configured LLM provider. Set up at least one provider (OpenAI, Anthropic, Groq, etc.) with a valid API key before using Chat.