Bot12 MCP Server

A complete, production-ready MCP (Model Context Protocol) server template that converts your bot12 trading bot into tools that Claude and other AI assistants can use.

Features

✅ 9 Pre-built Trading Tools - Account info, positions, trades, reporting
✅ Production Ready - Error handling, logging, security
✅ Pydantic Validation - Type-safe data structures
✅ Claude Integration - Works with Claude Desktop
✅ Comprehensive Docs - Multiple guides included
✅ MIT Licensed - Free to use and modify

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Configure Environment

cp .env.example .env
# Edit .env with your bot12 credentials

3. Customize the Server

Edit bot12_mcp_template.py and replace the 4 TODO helper functions with your actual bot12 code.

4. Run the Server

python bot12_mcp_template.py

5. Test with MCP Inspector

npx @modelcontextprotocol/inspector python bot12_mcp_template.py

6. Add to Claude Desktop

Edit ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bot12": {
      "command": "python",
      "args": ["/absolute/path/to/bot12_mcp_template.py"]
    }
  }
}

Tools Available

Account & Positions

• get_account_balance() - Get balance and equity
• get_active_positions() - List open positions
• get_market_price(symbol) - Get bid/ask prices

Trading Operations

• execute_trade(symbol, quantity, direction, ...) - Place a trade
• close_position(position_id) - Close a position

Reporting

• get_trade_history(limit, symbol) - View past trades
• generate_performance_report(start_date, end_date) - Get statistics

System

• get_system_status() - Check bot health
• get_bot_logs(limit, level) - View recent logs

Documentation

• QUICK_START.md - 30-minute quick start guide
• BOT12_MCP_SETUP_GUIDE.md - Comprehensive 7-step setup
• INDEX.md - Complete file reference

Repository

• GitHub: https://github.com/mohamadasani494-pixel/bot12-mcp-server
• License: MIT
• Status: Production Ready

Next Steps

1. Read QUICK_START.md for fast setup
2. Customize bot12_mcp_template.py with your bot12 code
3. Test with MCP Inspector
4. Integrate with Claude Desktop
5. Deploy!

For complete details, see BOT12_MCP_SETUP_GUIDE.md