ScreenerBot
DocsAssistantAI Chat

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 analysis
check_security - Security risk check
get_market_data - Live market data

Portfolio Tools

get_balance - Check SOL balance
get_positions - List open positions
get_position - Position details
get_pnl - Profit/loss stats

Trading Tools

buy_token - Execute buy order
sell_token - Execute sell order
close_position - Close position

⚠️ Requires user confirmation

Config Tools

get_config - View settings
update_config - Change settings

⚠️ Requires user confirmation

System Tools

get_status - System status
get_events - Recent events
force_stop - Emergency stop

Tool 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

Analysis:Token analysis tools
Portfolio:Balance & position tools
Trading:Buy/sell/close tools
Config:Settings tools
System:Status & control tools

Example Conversations

U

Check my wallet balance

Used: get_balance

Your wallet balance is 0.0707 SOL. Wallet address: 6uod...cGMv

U

Analyze BONK token

Used: analyze_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 feature
chat_max_session_messagesMaximum messages per session (default: 100)
chat_auto_summarizeAutomatically summarize long conversations
tool_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.

Related Pages