Updated MCP, CLI with skills

Author: dipankar

.claude/skills/polybot.md

@@ -0,0 +1,86 @@
+---
+name: polybot
+description: Interact with PolyBot trading system via CLI
+---
+
+# PolyBot CLI Skill
+
+Execute PolyBot CLI commands for trading system management.
+
+## Available Commands
+
+### Service Management
+- `polybot start` - Start all services
+- `polybot api` - Run API server only
+- `polybot mcp start` - Start MCP server
+
+### Strategy Management  
+- `polybot strategy list` - List all strategies with enabled/shadow status
+- `polybot strategy enable <name>` - Enable a strategy
+- `polybot strategy disable <name>` - Disable a strategy
+- `polybot strategy shadow <name> --enable` - Enable shadow mode (paper trading)
+- `polybot strategy shadow <name> --disable` - Disable shadow mode
+- `polybot strategy run <name>` - Run a single strategy
+
+### AI Trading Management (MCP)
+- `polybot mcp status` - Show MCP server status, mode, and pending approvals
+- `polybot mcp mode <disabled|shadow|live>` - Set AI trading mode
+- `polybot mcp pending` - List pending AI trade approvals
+- `polybot mcp approve <id>` - Approve a pending AI trade
+- `polybot mcp reject <id> -r "reason"` - Reject a pending AI trade
+- `polybot mcp audit` - View AI action audit log
+
+### Market Analysis
+- `polybot ai plugins` - List available AI prediction plugins
+- `polybot ai info <plugin>` - Show plugin details
+- `polybot ai predict <market_id>` - Test AI prediction for a market
+- `polybot ai scan` - Scan markets for AI-predicted opportunities
+
+### Statistical Arbitrage
+- `polybot statarb correlations` - Show computed market correlations
+- `polybot statarb compute --hours 48` - Compute correlations
+- `polybot statarb opportunities` - Show current stat arb opportunities
+- `polybot statarb prices` - Show recent price snapshots
+
+### Database & Configuration
+- `polybot db init` - Initialize databases
+- `polybot db stats` - Show 30-day trading statistics
+- `polybot config` - Show current configuration
+
+### Authentication
+- `polybot auth --create` - Create new API credentials
+- `polybot auth --derive` - Derive existing credentials
+
+## Usage
+
+When using this skill, run commands via bash. For example:
+
+```bash
+# List all strategies
+polybot strategy list
+
+# Enable arbitrage in shadow mode
+polybot strategy enable arbitrage
+polybot strategy shadow arbitrage --enable
+
+# Check MCP status
+polybot mcp status
+
+# Approve an AI trade
+polybot mcp approve abc123
+```
+
+## AI Trading Modes
+
+| Mode | Description |
+|------|-------------|
+| `disabled` | AI can only read market data |
+| `shadow` | AI can paper trade (no real money) |
+| `live` | AI can submit real orders (with approval) |
+
+## Safety Notes
+
+- Shadow mode is recommended for testing AI strategies
+- Live trading requires explicit approval by default
+- All AI actions are logged in the audit log
+- Position limits apply to AI trades separately from manual limits

.env.example

@@ -130,3 +130,38 @@ CORS_ALLOW_METHODS=GET,POST,PUT,DELETE,OPTIONS
 
 # Allowed headers
 CORS_ALLOW_HEADERS=Authorization,X-API-Key,Content-Type,Accept
+
+# =============================================================================
+# MCP SERVER (AI Agent Integration)
+# =============================================================================
+
+# Enable MCP server for AI agent integration
+MCP_ENABLED=false
+
+# MCP server host and port
+MCP_HOST=127.0.0.1
+MCP_PORT=3001
+
+# AI trading mode:
+#   disabled - AI can only read market data
+#   shadow   - AI can paper trade (no real money)
+#   live     - AI can submit real orders (with approval)
+MCP_AI_TRADING_MODE=shadow
+
+# AI-specific risk limits (separate from main limits)
+MCP_MAX_POSITION_USD=100
+MCP_MAX_DAILY_TRADES=50
+MCP_DAILY_LOSS_LIMIT_USD=200
+
+# Approval settings for live trading
+MCP_REQUIRE_APPROVAL=true
+MCP_APPROVAL_TIMEOUT_SEC=300
+
+# Rate limiting and audit
+MCP_RATE_LIMIT_PER_MIN=30
+MCP_AUDIT_LOG_ENABLED=true
+
+# Strategy assessment settings
+MCP_ALLOW_CODE_READ=true
+MCP_ALLOW_CLI_EXECUTION=true
+MCP_ASSESSMENT_LOOKBACK_DAYS=30

README.md

@@ -167,6 +167,67 @@ class MyAIPlugin(AIModelPlugin):
 
 [Developer Guide](https://docs.cryptuon.com/polybot/developer-guide/)
 
+## AI Agent Integration
+
+PolyBot includes comprehensive AI agent integration via MCP (Model Context Protocol):
+
+- **MCP Server** for AI agents (Claude, etc.) to interact with trading
+- **Strategy Assessment** for AI to analyze and improve strategies
+- **Claude Code Skill** for direct CLI interaction
+
+### Quick Start
+
+```bash
+# Enable MCP server
+export MCP_ENABLED=true
+export MCP_AI_TRADING_MODE=shadow  # Start with paper trading
+
+# Start MCP server
+polybot mcp start
+```
+
+### Claude Code Skill
+
+Install the skill for direct CLI access in Claude Code:
+
+```bash
+cp -r .claude/skills ~/.claude/skills/
+```
+
+Then use `/polybot` in Claude Code:
+```
+/polybot strategy list
+/polybot mcp status
+```
+
+### AI Capabilities
+
+| Feature | Description |
+|---------|-------------|
+| **Market Analysis** | Query markets, prices, positions |
+| **Shadow Trading** | Paper trade without real money |
+| **Live Trading** | Real orders with approval workflow |
+| **Strategy Assessment** | Analyze performance, suggest improvements |
+| **CLI Execution** | Run polybot commands programmatically |
+
+### Trading Modes
+
+| Mode | Description |
+|------|-------------|
+| `disabled` | AI can only read market data |
+| `shadow` | AI can paper trade (no real money) |
+| `live` | AI can submit real orders (with approval) |
+
+### Safety Controls
+
+- **Position Limits**: AI trades limited to `MCP_MAX_POSITION_USD`
+- **Daily Loss Limit**: Auto-disable if `MCP_DAILY_LOSS_LIMIT_USD` exceeded
+- **Approval Queue**: Live trades require human approval by default
+- **Audit Logging**: All AI actions logged for review
+- **CLI Whitelist**: Only safe commands allowed via MCP
+
+[AI Integration Guide](https://docs.cryptuon.com/polybot/user-guide/ai-agents/)
+
 ## Architecture
 
 ```
@@ -215,6 +276,15 @@ polybot ai plugins                 # List AI plugins
 polybot ai predict <market_id>     # Test prediction
 polybot ai scan                    # Scan for opportunities
 
+# MCP (AI Agent) management
+polybot mcp start                  # Start MCP server
+polybot mcp status                 # Show status and pending approvals
+polybot mcp mode <mode>            # Set AI trading mode
+polybot mcp pending                # List pending approvals
+polybot mcp approve <id>           # Approve AI trade
+polybot mcp reject <id>            # Reject AI trade
+polybot mcp audit                  # View AI action audit log
+
 # Database
 polybot db init            # Initialize databases
 polybot db stats           # Show performance stats