Skip to main content
Glama
JonusNattapong

popmely

by JonusNattapong
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

popmely: MetaTrader 5 (MT5) Model Context Protocol (MCP) Server

Version Python License MCP Platform

popmely is a production-grade, asynchronous Model Context Protocol (MCP) server providing seamless integration between MetaTrader 5 (MT5) and Large Language Models (LLMs) such as Claude, Antigravity, Cursor, and OpenAI Agents.

It equips AI assistants with full-duplex control over financial markets—ranging from real-time price feeds, Smart Money Concept (SMC) structure analysis, bar-by-bar backtesting, automated risk calculation, and position lifecycle management, to a background autonomous trading bot with real-time Telegram alerts, a dynamic Trading Credit Score risk governance engine, institutional ICT strategy models, and an embedded SQLite Persistence Database.

Table of Contents

  1. Key Features

  2. The Trader's Journey (Workflow)

  3. System Architecture

  4. MCP Interface Specification (74 Tools)

  5. Institutional & ICT Strategy Models

  6. Trading Credit Score Engine

  7. Smart Money Concepts (SMC) Analyzer

  8. Autonomous Trading Agent

  9. Installation & Quickstart Guide

  10. Client Configuration

  11. Web Data Dashboard

  12. Configuration Parameters

  13. Project Evolution Journey (Changelog)

  14. Development & Testing

  15. Risk Disclaimer

Related MCP server: mt5-mcp

🌟 Key Features

  • Standard MCP Protocol: Fully compliant with JSON-RPC 2.0 stdio and SSE transports for interoperability across Anthropic Claude Desktop, Google Antigravity, Cursor, and custom agentic frameworks.

  • Smart Money Concepts (SMC) Engine: Native detection of Break of Structure (BOS), Change of Character (CHoCH), Order Blocks (OB), Fair Value Gaps (FVG), Liquidity Sweeps, and Optimal Trade Entry (OTE 61.8%–78.6%).

  • Trading Credit Score System (v4.0): Adaptive risk governance model that adjusts trade lot sizes and halts execution dynamically based on consecutive Stop Loss hits and tier degradation.

  • Autonomous Strategy Engine: Non-blocking background worker with configurable polling intervals, automated order execution, trailing stops, auto-breakeven, and Telegram push notifications.

  • Event-Driven Backtester: In-memory bar-by-bar simulation engine calculating Win Rate, Profit Factor, Expected Payoff, and Maximum Drawdown with granular trade logs.

  • Strict Risk Safety Gates: Lot size caps, max daily drawdown limits, mandatory stop-loss constraints, and slippage protection.

🗺️ The Trader's Journey (Workflow)

flowchart TD
    Start([🌅 Market Open / Session Start]) --> Step1[<b>1. Market Briefing & Analysis</b><br>AI scans Daily Levels, Asian Range, & SMC Structure]
    Step1 --> Step2[<b>2. Institutional Confluence Check</b><br>Score H4 Macro + H1 Structure + M15 FVG Retest]
    
    Step2 --> Decision1{Confluence >= 80%?}
    Decision1 -- No --> Wait[⏳ Wait for Clear Setup / Liquidity Sweep]
    Decision1 -- Yes --> Step3[<b>3. Risk & Credit Calibration</b><br>Check Credit Score Tier: 🟢/🟡/🟠/🔴<br>Calculate exact % Lot Size & R:R target]
    
    Step3 --> Step4[<b>4. Smart Order Execution</b><br>Execute via Market / Breakout Stop / Bracket OCO]
    Step4 --> Step5[<b>5. Active Trade Lifecycle</b><br>Auto-Breakeven at +300 pts & Trailing Stop]
    
    Step5 --> Step6[<b>6. Post-Trade Review & Journal</b><br>Auto-deduct on SL / Recover on TP<br>Log into AI Trade Journal]
    Step6 --> End([🌙 Daily Performance Summary])

    style Start fill:#238636,stroke:#2ea043,color:#fff
    style End fill:#1f6feb,stroke:#388bfd,color:#fff
    style Step3 fill:#d29922,stroke:#bb8009,color:#000
    style Step6 fill:#8957e5,stroke:#a371f7,color:#fff

The 6-Step Execution Lifecycle:

  1. Market Briefing: Run daily_market_briefing to assess macro trend, support/resistance, and session ranges.

  2. Institutional Confluence: Run mt5_confluence_matrix or mt5_analyze_silver_bullet to confirm setups with $\ge 80%$ probability.

  3. Risk & Credit Score: Verify mt5_score_status to ensure account is in GREEN or YELLOW tier; compute risk-weighted lot sizing.

  4. Smart Execution: Dispatch orders via mt5_smart_order, mt5_place_bracket_order, or mt5_place_grid_orders.

  5. Lifecycle Management: Background bot monitors trailing stops, executes auto-breakeven, and sends Telegram alerts.

  6. Journal & Governance: Review mt5_get_trade_journal for performance metrics, R:R analytics, and Credit Score health.

🏗️ System Architecture

graph TD
    subgraph "AI Clients / MCP Hosts"
        Claude[Claude Desktop / Antigravity]
        Cursor[Cursor IDE]
        Agent[Autonomous Agent / Script]
    end

    subgraph "popmely MCP Server"
        FastMCP[FastMCP Server Protocol]
        Router[Tool / Resource / Prompt Router]
        
        subgraph "Core Engines"
            CreditScore[Trading Credit Score Engine]
            SMC[SMC Structure Analyzer]
            Backtest[Event-Driven Backtester]
            Bot[Autonomous Trading Worker]
            PosMgr[Position & Breakeven Manager]
            Notifier[Telegram / Webhook Notifier]
        end
    end

    subgraph "Terminal Layer"
        MT5[MetaTrader 5 Windows Terminal]
        Broker[Liquidity Provider / Broker]
    end

    Claude <-->|stdio / JSON-RPC| FastMCP
    Cursor <-->|stdio / JSON-RPC| FastMCP
    Agent <-->|SSE / stdio| FastMCP

    FastMCP --> Router
    Router --> CreditScore
    Router --> SMC
    Router --> Backtest
    Router --> Bot
    Router --> PosMgr

    Bot --> Notifier
    PosMgr --> MT5
    Bot --> MT5
    Router --> MT5
    MT5 <--> Broker

📋 MCP Interface Specification

1. Tools (74 Callable Functions)

💼 Account & Terminal

Tool Name

Description

Parameters

mt5_account_info

Query balance, equity, margin, leverage, and floating profit.

None

mt5_terminal_status

Check terminal connection state and algo-trading permission.

None

📊 Market Data

Tool Name

Description

Parameters

mt5_get_quote

Fetch real-time Bid, Ask, Spread, and timestamps.

symbol: str = "XAUUSD"

mt5_get_symbol_info

Get contract sizes, digits, point size, min/max volume.

symbol: str = "XAUUSD"

mt5_search_symbols

Search broker's tradable asset database by keyword.

query: str = "XAU"

mt5_get_candles

Retrieve recent historical OHLCV candles across standard timeframes.

symbol: str, timeframe: str = "M15", count: int = 100

mt5_get_candles_range

Date/Time Range Candles: Fetch OHLCV candles and period price change % between specific dates/hours.

symbol: str, timeframe: str = "M15", start_time: str, end_time: Optional[str] = None

📈 Technical & SMC Analysis

Tool Name

Description

Parameters

mt5_analyze_technical

Calculate EMAs (20, 50, 200), RSI, MACD, ATR, Bollinger Bands.

symbol: str, timeframe: str = "M15", count: int = 100

mt5_analyze_smc

Full SMC analysis: BOS, CHoCH, Order Blocks, FVGs, OTE levels.

symbol: str, timeframe: str = "M15", count: int = 100

mt5_generate_candlestick_chart

SMC Visual Chart Renderer: Generates high-res dark-themed .png candlestick chart image with FVG, Order Blocks, and EMAs overlaid.

symbol: str = "XAUUSD", timeframe: str = "M15", count: int = 80, overlay_smc: bool = True, overlay_ema: bool = True

👑 Institutional & ICT Strategy Tools (New)

Tool Name

Description

Parameters

mt5_analyze_silver_bullet

ICT Silver Bullet Analyzer: Liquidity Sweeps, MSS displacement, and unmitigated FVG trigger plans (1:2.5 R:R).

symbol: str = "XAUUSD", timeframe: str = "M15", count: int = 100

mt5_detect_judas_swing

Judas Swing & Asian Sweep: Detects London/NY open stop hunts above/below Asian Range and generates sniper reversals.

symbol: str = "XAUUSD", count: int = 120

mt5_analyze_ifvg

Inversion FVG (IFVG) Scanner: Tracks broken FVGs that have inverted roles into high-probability support/resistance.

symbol: str = "XAUUSD", timeframe: str = "M15", count: int = 100

mt5_confluence_matrix

Multi-Timeframe Confluence Matrix: Computes a 0-100% Institutional Confluence Score across H4, H1, M15, and RSI.

symbol: str = "XAUUSD"

📰 High-Impact News & Straddle Trading (New)

Tool Name

Description

Parameters

mt5_get_economic_calendar

Live Economic Calendar: Official feeds for CPI, NFP, FOMC with Impact & Currency filters.

currency: Optional[str], impact: str = "High", days: int = 7

mt5_check_news_blackout

News Blackout Window: Check if market is within High-Impact news volatility window.

symbol: str = "XAUUSD", minutes_before: int = 15, minutes_after: int = 15

mt5_execute_news_straddle

Trade the News Spike: Place two-sided bracket straddle order (BUY_STOP + SELL_STOP) with 1:3 R:R to catch explosive news spikes.

symbol: str = "XAUUSD", event_name: str, distance_points: float = 250.0, volume: float = 0.01, sl_points: float = 150.0, tp_points: float = 450.0

mt5_analyze_news_volatility

Post-News Volatility Analyzer: Real-time ATR spike & displacement to assess news momentum continuation.

symbol: str = "XAUUSD", timeframe: str = "M1", count: int = 30

🔬 Backtesting Engine

Tool Name

Description

Parameters

mt5_run_backtest

Run historical backtest on SMC FVG or EMA Cross strategies with auto-archiving.

symbol: str, timeframe: str = "M15", strategy: str = "smc_fvg", bars: int = 500, initial_balance: float = 10000.0, risk_percent: float = 1.0, rr_ratio: float = 2.0

🧮 Risk Management

Tool Name

Description

Parameters

mt5_calculate_lot_size

Calculate position size by account risk %, balance, and SL distance.

symbol: str, entry_price: float, stop_loss_price: float, take_profit_price: float, risk_percent: float = 1.0

⚡ Smart Order & Position Execution

Tool Name

Description

Parameters

mt5_place_order

Send standard Market BUY/SELL order with SL, TP, and magic number.

symbol: str, action: str ("BUY"/"SELL"), volume: float, sl: float = 0.0, tp: float = 0.0, comment: str = ""

mt5_smart_order

Smart Auto-Risk Order: Computes exact lot size by % risk, verifies Credit Score, calculates TP by R:R, and executes in 1 step.

symbol: str, action: str, sl_price: float, tp_price: float = 0.0, rr_ratio: float = 2.0, risk_percent: float = 1.0

mt5_place_pending_order

Place pending Limit or Stop orders (BUY_LIMIT, SELL_LIMIT, BUY_STOP, SELL_STOP).

symbol: str, order_type: str, price: float, volume: float, sl: float = 0.0, tp: float = 0.0

mt5_place_bracket_order

News/Breakout Straddle: Place both BUY_STOP above and SELL_STOP below market price simultaneously.

symbol: str, distance_points: float = 200.0, volume: float = 0.01, sl_points: float = 150.0, tp_points: float = 300.0

mt5_place_grid_orders

DCA / Grid Scaling: Place multiple pending limit orders stepping down (Buy) or up (Sell) to average entry price.

symbol: str, action: str, levels: int = 3, step_points: float = 150.0, volume_per_order: float = 0.01

mt5_get_positions

List currently open market positions with floating PnL and tickets.

symbol: str = ""

mt5_modify_position

Update Stop Loss or Take Profit of an active position.

ticket: int, sl: float = 0.0, tp: float = 0.0

mt5_close_position

Close an active position by ticket ID with partial close support.

ticket: int, volume: float = 0.0

mt5_close_all_positions

Emergency liquidation of all active positions.

symbol: str = ""

mt5_close_profitable_positions

Close only profitable open positions (Profit > min_profit_usd) to lock in gains.

symbol: str = "", min_profit_usd: float = 0.0

mt5_take_partial_profit

Smart Scale-Out: Close N% (e.g. 50%) of a position, lock profit into account, and move SL to Breakeven (100% Risk-Free).

ticket: int, close_percent: float = 50.0, move_sl_to_be: bool = True, be_offset_points: float = 10.0

mt5_scale_out_all_profitable

Bulk Scale-Out: Close N% across all profitable positions and secure remaining volumes at Breakeven in 1 click.

min_profit_usd: float = 5.0, close_percent: float = 50.0, move_sl_to_be: bool = True

mt5_lock_profit_target

Lock Guaranteed Profit: Move Stop Loss to a guaranteed positive profit level (+points beyond entry).

ticket: int, lock_profit_points: float = 100.0

mt5_close_losing_positions

Close only losing open positions (Loss < -max_loss_usd) to cut losses immediately.

symbol: str = "", max_loss_usd: float = 0.0

mt5_close_by_comment

Close open positions matching a specific comment / order name tag (e.g. 'AI_SMC', 'Manual').

comment_query: str, symbol: str = ""

mt5_close_by_magic

Close open positions matching a specific EA Magic Number.

magic_number: int, symbol: str = ""

mt5_get_pending_orders

List all active pending orders in terminal.

symbol: str = ""

mt5_cancel_pending_order

Cancel a single pending order by ticket ID.

ticket: int

mt5_cancel_all_pending_orders

Cancel all active pending orders across terminal in one click.

symbol: str = ""

mt5_get_trade_history

Retrieve closed trade logs and historical deals for past N days.

days: int = 7

mt5_get_trade_history_range

Date Range PnL & Deals: Retrieve closed trades and win rate stats between specific dates.

start_time: str, end_time: Optional[str] = None, symbol: Optional[str] = None

mt5_execute_rapid_scalp

Second-by-Second Sniper Scalp: High-speed M1/tick momentum scalp with ultra-tight SL, 1:2 R:R TP, and spread protection.

symbol: str = "XAUUSD", direction: str = "AUTO", volume: float = 0.05, sl_points: float = 35.0, tp_points: float = 70.0, max_spread_points: float = 30.0

mt5_get_trade_journal

AI Trade Journey & Journal: Generates detailed trade journey logs, R:R analytics, Credit Score impact, and AI feedback.

days: int = 7, symbol: Optional[str] = None

🤖 Autonomous Agent Management & Notifications

Tool Name

Description

Parameters

mt5_agent_start

Launch background autonomous scanning and execution worker.

symbol: str, timeframe: str = "M15", strategy: str = "smc", scan_interval: int = 15, auto_trade: bool = False, risk_percent: float = 1.0, rr_ratio: float = 2.0, enable_breakeven: bool = True, be_trigger_points: float = 300.0

mt5_agent_stop

Terminate the background autonomous worker thread.

None

mt5_agent_status

Query uptime, scan count, signals generated, and execution stats.

None

mt5_send_test_alert

Dispatch test notification to Telegram / Webhook channels.

message: str

mt5_send_telegram_message

Custom Telegram Message: Send any freeform text, trade alert, or daily summary to Telegram.

message: str, chat_id: Optional[str], parse_mode: str = "HTML", token: Optional[str]

mt5_send_telegram_photo

Telegram Chart Sender: Send generated candlestick chart images (.png) directly to Telegram with trade plan captions.

photo_path: str, caption: Optional[str], chat_id: Optional[str], token: Optional[str]

🛡️ Trading Credit Score (Risk Governance)

Tool Name

Description

Parameters

mt5_score_init

Initialize or configure credit score and reference portfolio balance (persisted to SQLite).

max_score: float = 100.0, initial_balance: float = 10000.0, base_multiplier: float = 100.0, recovery_rate: float = 0.5

mt5_score_status

Retrieve current score, tier, lot multiplier, and streak counters.

None

mt5_score_deduct

Deduct points upon SL hit with automatic losing streak penalty (saved to SQLite).

loss_usd: float, reason: str = "SL Hit"

mt5_score_recover

Recover points upon TP hit (50% of deduction rate).

profit_usd: float

mt5_score_reset

Reset score to initial maximum capacity.

None

mt5_score_set

Manually override score value for manual risk calibration.

score: float

mt5_score_history

Audit log of score modifications, penalties, and recoveries from SQLite.

limit: int = 20

💾 Persistent Database (SQLite Storage)

Tool Name

Description

Parameters

mt5_db_add_trade_note

Journal Diary Entry: Attach user/AI reflections, strategy tags, and PnL notes to a trade ticket.

symbol: str, note: str, deal_ticket: Optional[int], profit_usd: Optional[float], strategy: Optional[str], tags: Optional[str]

mt5_db_get_journal_notes

Query Journal Notes: Retrieve persistent trade journal notes filtered by symbol or ticket.

symbol: Optional[str], deal_ticket: Optional[int], days: int = 30, limit: int = 50

mt5_db_get_signal_history

Signal Audit Trail: Retrieve historical bot signals, triggers, and execution statuses.

symbol: Optional[str], strategy: Optional[str], limit: int = 50

mt5_db_get_backtest_archive

Backtest Library: Query archived historical backtest runs, win rates, and profit factors.

symbol: Optional[str], strategy: Optional[str], limit: int = 20

mt5_db_stats

Database Health: View SQLite database size, file path, and record counts across all tables.

None

🧠 AI Memory & Order Recall Suite

Tool Name

Description

Parameters

mt5_recall_similar_trades

Past Setup Memory: Recall past similar trades, historical Win Rate %, average profit, and AI lessons learned.

symbol: Optional[str] = "XAUUSD", strategy: Optional[str] = None, limit: int = 20

mt5_recall_trading_mistakes

Safety Reflection: Recall recent losing trades and AI reflections to serve as a pre-trade checklist.

symbol: Optional[str] = None, days: int = 30, limit: int = 5

mt5_recall_strategy_rankings

Strategy Leaderboard: Aggregate and rank historical strategies by Win Rate % and expectancy.

symbol: Optional[str] = None

mt5_recall_recent_order

Emergency Undo Button: Immediately close/recall the most recently opened market position (within N seconds) to reverse mistakes.

symbol: Optional[str] = None, max_age_seconds: int = 120

mt5_recall_all_pending_orders

Emergency Revocation: Instantly revoke and cancel all active pending limit and stop orders in 1 click.

symbol: Optional[str] = None

⚙️ Dynamic Configuration & Key Setup

Tool Name

Description

Parameters

mt5_get_config

Inspect Settings: View current runtime configuration settings, Telegram credentials, and safety limits (masked for security).

masked: bool = True

mt5_set_config

Dynamic Setup: Configure Telegram Bot Token, Chat ID, Webhooks, Max Lot Size, and Risk Limits directly via MCP without server restart.

telegram_bot_token: Optional[str], telegram_chat_id: Optional[str], webhook_url: Optional[str], default_symbol: Optional[str], max_lot_size: Optional[float], max_daily_drawdown_percent: Optional[float], require_sl: Optional[bool], persist_to_env: bool = True

🌐 Polymarket Prediction Market Suite (Live Mainnet)

Tool Name

Description

Parameters

poly_get_markets

Market Discovery: Search and discover Polymarket event prediction markets, odds, volume, and outcome tokens.

query: Optional[str] = None, limit: int = 10, active: bool = True

poly_get_orderbook

Live Orderbook: Retrieve live Level 2 bid/ask orderbook and spread for a specific outcome token.

token_id: str

poly_get_portfolio

Portfolio & Positions: Query active open positions and total portfolio value for a given wallet address.

user_address: Optional[str] = None

poly_get_trade_history

Trade Audit: Query on-chain closed trade history and executed fills on Polymarket.

user_address: Optional[str] = None, limit: int = 20

poly_place_order

Live Order Execution: Place real live limit prediction orders directly on Polymarket CLOB Mainnet using your wallet Private Key.

token_id: str, side: str = "BUY", price: float = 0.50, size_usd: float = 10.0

poly_cancel_order

Cancel Live Order: Cancel an active open limit order on Polymarket CLOB Mainnet.

order_id: str

2. Resources (Read-Only State)

Read-only context URIs accessible by LLMs to inject situational awareness into conversation contexts:

URI

Content Schema

Description

mt5://account/status

application/json

Real-time equity, balance, margin levels, and terminal status.

mt5://positions/active

application/json

Active position tickets, floating profit, and entry pricing.

mt5://config/limits

application/json

Safety thresholds, max lot size, and default parameters.

mt5://score/status

application/json

Credit score tier, active lot multiplier, and streak metrics.

3. Prompts (Pre-Built Workflows)

Interactive prompt workflows registered on the MCP server:

  • daily_market_briefing: Synthesizes account health, credit score tier, multi-timeframe technical momentum (H1/M15), and SMC structural zones into an actionable daily briefing.

  • smc_trade_setup: Evaluates Premium/Discount pricing, unmitigated FVGs/OBs, calculates risk-weighted lot sizing adhering to current score tier rules, and prepares entry plans.

🛡️ Trading Credit Score Engine (v4.0)

The Trading Credit Score system prevents catastrophic drawdown through dynamic risk scaling and autonomous circuit breaking.

Tier Classifications

   100% ┌──────────────────────────────────────────────┐
        │  🟢 GREEN TIER (70% - 100%)                  │  → Standard Trading (100% Lot Size)
    70% ├──────────────────────────────────────────────┤
        │  🟡 YELLOW TIER (50% - 70%)                  │  → Cautious Mode (50% Lot Size)
    50% ├──────────────────────────────────────────────┤
        │  🟠 ORANGE TIER (30% - 50%)                  │  → Warning Mode (25% Lot Size + Alerts)
    30% ├──────────────────────────────────────────────┤
        │  🔴 CRITICAL TIER (< 30%)                    │  → CIRCUIT BREAKER (Trading Blocked)
     0% └──────────────────────────────────────────────┘

Mathematical Model

Deduction Formula (SL Hit)

$$\Delta \text{Score}{\text{deduct}} = \left( \frac{\text{Loss}{\text{USD}}}{\text{Balance}{\text{ref}}} \times \text{Multiplier}{\text{base}} \right) \times \text{StreakMultiplier}$$

$$\text{StreakMultiplier} = \begin{cases} 1.0 & \text{if Streak} \le 2 \ 1.5 & \text{if } 3 \le \text{Streak} \le 4 \ 2.0 & \text{if Streak} \ge 5 \end{cases}$$

Recovery Formula (TP Hit)

$$\Delta \text{Score}{\text{recover}} = \left( \frac{\text{Profit}{\text{USD}}}{\text{Balance}{\text{ref}}} \times \text{Multiplier}{\text{base}} \right) \times \text{RecoveryRate} \quad (\text{Default: } 0.50)$$

Score recovery occurs at 50% velocity relative to penalties to encourage disciplined risk management.

🧠 Smart Money Concepts (SMC) Analyzer

The built-in SMC engine calculates institutional market structure directly from OHLCV arrays:

  1. Swing Highs / Lows: Multi-bar fractal pivot identification.

  2. Break of Structure (BOS): Continuation signals validated by candle body closes.

  3. Change of Character (CHoCH): Early trend reversal identification.

  4. Fair Value Gaps (FVG): 3-candle imbalance zones tracked for mitigation state.

  5. Order Blocks (OB): High-volume institutional origin candles.

  6. Premium vs. Discount Zones: Equilibrium calculations based on dealing ranges.

  7. Optimal Trade Entry (OTE): Fibonacci retracement zones (61.8%, 70.5%, 78.6%).

🤖 Autonomous Trading Agent

The autonomous agent runs on a non-blocking background thread (daemon=True) to perform continuous market scanning:

sequenceDiagram
    autonumber
    participant Agent as Autonomous Agent
    participant Score as Credit Score Engine
    participant MT5 as MetaTrader 5
    participant SMC as SMC Analyzer
    participant Risk as Risk Calculator
    participant Telegram as Telegram / Webhook

    loop Every Scan Interval (e.g. 15s)
        Agent->>MT5: Manage Active Positions (Auto-BE / Trailing Stop)
        Agent->>MT5: Poll Closed Deals History
        alt Closed Deal Found
            Agent->>Score: Update Points (Deduct SL / Recover TP)
        end
        Agent->>Score: Check is_trading_allowed()
        alt Score is CRITICAL (<30%)
            Agent->>Agent: Suppress Execution (Signal-Only Mode)
        else Score is Valid
            Agent->>MT5: Fetch Latest OHLCV Data
            Agent->>SMC: Evaluate Market Structure & FVGs
            alt Valid Setup Detected
                Agent->>Risk: Calculate Base Lot Size (Risk %)
                Risk->>Score: Fetch Tier Lot Multiplier (1.0 / 0.5 / 0.25)
                Agent->>Telegram: Dispatch Instant Signal Alert
                alt auto_trade == True
                    Agent->>MT5: Execute Market Order
                end
            end
        end
    end

🚀 Installation & Quickstart Guide

⚡ 5-Minute Quickstart (Windows PowerShell)

# 1. Clone the repository
git clone https://github.com/JonusNattapong/popmely.git
cd popmely

# 2. Create and activate virtual environment
python -m venv .venv
.venv\Scripts\activate

# 3. Install dependencies and package
pip install -e .

# 4. Copy environment configuration
Copy-Item .env.example .env

# 5. Verify installation
python -c "import popmely; print(f'🎉 popmely v{popmely.__version__} is ready!')"

🖥️ Step 1: MetaTrader 5 Terminal Configuration

  1. Open your MetaTrader 5 terminal.

  2. Log into your Demo or Live trading account.

  3. Enable Automated Trading:

    • Go to top menu: Tools > Options (or press Ctrl + O).

    • Select the Expert Advisors tab.

    • ✅ Check "Allow Algo Trading".

    • ✅ Check "Allow WebRequest for listed URL" (if using Webhooks).

    • Click OK.

📱 Step 2: Telegram Push Notification Setup (Optional)

To receive real-time signal alerts and credit score warnings:

  1. Open Telegram and search for @BotFather.

  2. Send /newbot and follow the prompts to create your bot $\rightarrow$ copy the TELEGRAM_BOT_TOKEN.

  3. Search for @userinfobot $\rightarrow$ start it to get your personal TELEGRAM_CHAT_ID.

  4. Edit your .env file:

    TELEGRAM_BOT_TOKEN=123456789:ABCdefGhIJKlmNoPQRstuvWxyz
TELEGRAM_CHAT_ID=987654321

  5. Test your alert:

    python -c "from popmely.agent.notifier import notifier; notifier.send_alert('🚀 popmely alert is working!')"

⚙️ Client Configuration

Claude Desktop (claude_desktop_config.json)

Add popmely to your Claude Desktop configuration located at %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "popmely": {
      "command": "python",
      "args": [
        "-m",
        "popmely"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

Google Antigravity / Cursor IDE (mcp.json)

{
  "mcpServers": {
    "popmely": {
      "command": "python",
      "args": [
        "d:\\Projects\\Github\\popmely\\src\\popmely\\server.py"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

Direct CLI Invocation

# Standard stdio MCP mode
python -m popmely

# FastMCP SSE Transport mode
python -m popmely --transport sse --host 127.0.0.1 --port 8000

📺 Live Streaming Trading Dashboard & Console

Run the interactive live terminal console to monitor real-time prices, SMC structure, Credit Score meter, and bot executions on your screen:

# Monitor XAUUSD in real-time (auto-refreshes every 2 seconds)
python -m popmely.live --symbol XAUUSD --interval 2

# Monitor BTCUSD with autonomous auto-trading execution enabled
python -m popmely.live --symbol BTCUSD --interval 1 --auto-trade
==================================================================================
 👑 POPMELY LIVE STREAMING TRADING TERMINAL v5.0.0 | 2026-08-16 17:15:00
 🔌 MT5 Account: #110491916 (MetaQuotes-Demo) | Terminal: CONNECTED
==================================================================================
 💰 Balance: $100,000.00    | Equity: $100,000.00    | Floating PnL: $0.00       
 🔒 Margin Used: $0.00      | Free Margin: $100,000.00 | Margin Level: 0.0%
----------------------------------------------------------------------------------
 🛡️  Trading Credit Score : [████████████████████] 100.0% 🟢 GREEN (100% Lot)
    Streak Counters      : Win Streak: 2 | Loss Streak: 0 | SQLite: PERSISTENT
----------------------------------------------------------------------------------
 📊 Ticker (XAUUSD)       : Bid: 4376.00 | Ask: 4376.20 | Spread: 20 pts
 🎛️  Confluence Matrix   : STRONG_BUY   (Bullish: 85% | Bearish: 15%)
 📰 Economic News Status : 🟢 CLEAR (No High-Impact News)
----------------------------------------------------------------------------------
 📈 Active Positions (1 Open):
    #1234567   XAUUSD   BUY    0.10     4375.50      4376.00      +$50.00   
----------------------------------------------------------------------------------
 📡 Live Stream Event Feed:
    [17:15:00] 🚀 Live Streaming Terminal Initialized.
    [17:15:02] 🎯 Institutional Confluence 85% detected on XAUUSD M15.
    [17:15:04] ⚡ Order executed: BUY 0.10 XAUUSD @ 4375.50 (Ticket #1234567).
==================================================================================

📊 Web Data Dashboard (Browser)

A local, read-only web dashboard over the persistent SQLite database — Credit Score trajectory, bot signal performance, trade journal, and backtest archive in one page. It holds no MT5 connection and issues SELECT statements only, so it is safe to leave open while the bot trades.

# Start on http://127.0.0.1:8787 (opens your browser)
python -m popmely.dashboard

# Custom port, no browser popup, alternate database file
popmely-dashboard --port 9000 --no-browser --db ~/.popmely/popmely.db

Section

What it shows

Hero + meter

Current Credit Score, tier, lot-size multiplier, and the tier bands

KPI row

Win/loss streaks, signals logged, signal win rate, journaled P&L, avg confluence, backtest count

Credit score trajectory

Score after every recorded event, with hover detail and a table view

Signals by strategy

Signal volume per strategy, with execution and outcome detail on hover

Tables

Recent signals, trade journal notes, backtest archive, full score event log

Built on the Python standard library — no extra dependencies, no CDN, works offline. It reads ~/.popmely/popmely.db; if that file does not exist yet, the page renders an empty state rather than failing. Use --host 0.0.0.0 only on a trusted network: the dashboard has no authentication.

🔧 Configuration Parameters

Create a .env file in the project root to override default settings:

# Optional: Auto-login credentials (Leave blank to use active MT5 terminal session)
MT5_ACCOUNT=
MT5_PASSWORD=
MT5_SERVER=
MT5_PATH=

# Trading Defaults
DEFAULT_SYMBOL=XAUUSD
DEFAULT_MAGIC=112233
DEFAULT_DEVIATION=20
MAX_SLIPPAGE_POINTS=50

# Safety Controls
MAX_LOT_SIZE=1.0
MAX_DAILY_DRAWDOWN_PERCENT=5.0
REQUIRE_SL=false

# Push Notifications
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here
WEBHOOK_URL=https://your-webhook-endpoint.com/api

🚀 Project Evolution Journey

The evolution of popmely from a basic MT5 bridge to an institutional AI trading server:

v1.0.0 (Core Bridge) ──► v2.0.0 (SMC & Backtest) ──► v3.1.0 (Autonomous Bot) ──► v4.0.0 (Credit Score) ──► v4.5.0 (ICT Strategies) ──► v5.0.0 (SQLite Database)

Milestone

Version

Release Highlights

Key Tools Added

The Genesis Bridge

v1.0.0

Initial bridge between MT5 terminal and AI models via MCP protocol.

Account Info, Quote Feed, Place/Close Order

SMC & Quantitative Engine

v2.0.0

Introduced Smart Money Concepts analyzer and bar-by-bar backtest simulation.

BOS, CHoCH, OB, FVG, Backtest Engine

Autonomous AI & Protocol

v3.1.0

Standardized to FastMCP, background autonomous scanning worker, and Telegram alerts.

Agent Worker, Auto-BE, Trailing Stop, Telegram Notifier

Trading Credit Score

v4.0.0

Adaptive risk governance engine that scales lot sizes and halts trading on drawdown.

Credit Score Tiers (GREEN/YELLOW/ORANGE/CRITICAL)

Institutional Mastery

v4.5.0

Institutional ICT strategies, Smart entry orders, Selective position closing, and Date range queries.

Silver Bullet, Judas Swing, IFVG, Confluence, Trade Journal

SQLite Persistence & DB

v5.0.0

Embedded SQLite database engine with state persistence, trade notes diary, signal audit trails, and backtest archives.

DB Add Note, Query Notes, Signals Log, Backtest Archive, DB Stats (50 Tools)

🧪 Development & Testing

Run unit and integration test suites:

# Run test suite
python -m unittest discover -s tests

# Direct module verification
python -c "import popmely; print(f'Loaded popmely v{popmely.__version__}')"

⚠️ Risk Disclaimer

IMPORTANT: Trading foreign exchange, commodities, cryptocurrencies, and CFDs carries a high level of risk and may not be suitable for all investors. High leverage can work against you as well as for you.

This software is provided for research, educational, and workflow automation purposes. Always test all strategies extensively on Demo Accounts before deploying real capital. The author and contributors accept no responsibility for financial losses incurred through the use of this software.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Maintained with ❤️ by JonusNattapong.

This server cannot be installed

A
license - permissive license
-
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • mt5-mcp

    alikhande70
    A
    license
    -
    quality
    C
    maintenance
    A local-first MCP server that bridges AI coding agents with MetaTrader 5 for inspection, market data, MQL5 development, compiling, Strategy Tester review, workspace sync, logs, audit trails, demo trading, and carefully gated live trading.
    MIT

  • FullMt5McpByLeo

    TradeSystemsNique
    F
    license
    -
    quality
    B
    maintenance
    Universal MCP server that enables AI assistants to control MetaTrader 5 directly, executing trades, managing data, and automating MT5 operations through natural language.
    2
  • MTContext by mtcontext

    MTContextofficial

    mtcontext
    F
    license
    -
    quality
    C
    maintenance
    Cloud-hosted MCP server that connects AI clients to MetaTrader 4/5 for live prices, account state, indicators, and trades with dry-run safety via natural language.

View all related MCP servers

Related MCP Connectors

  • gainium-mcp

    MCP server for Gainium — manage trading bots, deals, and balances via AI assistants

  • Hive Capital

    HiveCapital MCP Server — autonomous investment layer for AI agents

  • Backtest360

    MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JonusNattapong/popmely'

If you have feedback or need assistance with the MCP directory API, please join our Discord server