v1.25.0

Installation Guide

Complete step-by-step instructions to get MISTERSCALPER running

Quick Navigation

1 Install Files

Copy LicenseManager.mqh to Include folder

MetaTrader 5/
└── MQL5/
    └── Include/
        └── LicenseManager.mqh  ← Copy here

Copy MisterScalper_v1_25_0.mq5 to Experts folder

MetaTrader 5/
└── MQL5/
    └── Experts/
        └── MisterScalper_v1_25_0.mq5  ← Copy here

2 Enable WebRequest (CRITICAL!)

This step is required for license validation to work.
  1. Open MetaTrader 5
  2. Go to: Tools → Options → Expert Advisors
  3. Check: ✓ Allow WebRequest for listed URL
  4. Click Add and enter your license server URL:
https://misterscalper.com

5. Click OK

Without this step, the EA will not start!

3 Configure Your License

Option A: Via EA Settings (When Attaching to Chart)

  1. Drag MisterScalper v1.25.0 from Navigator onto a chart
  2. In the settings window, go to the Inputs tab
  3. Scroll down to LICENSE SETTINGS section:
    • License Key: Enter your license key exactly as provided
MS-XXXX-XXXX-XXXX-XXXX
  1. License Server URL: Verify it matches your server
https://misterscalper.com

5. Click OK

Option B: Via EA Properties (After Already Attached)

  1. Right-click on chart → Expert Advisors → Properties
  2. Go to Inputs tab
  3. Find LICENSE SETTINGS section
  4. Enter your license key and verify server URL
  5. Click OK

4 Verify License Activation

First Time Activation

When you start the EA for the first time, check the Expert log:

Success - You should see:
========================================
MisterScalper EA v1.25.0 - Initializing
========================================
✓ License validated successfully!
License Server: https://misterscalper.com
Account: 12345678
Broker: YourBroker-Server1
Last Validation: 2026.03.13 04:00
Your IP address is now authorized for this license.

Panel position loaded: X=20 Y=50
MisterScalper EA initialized successfully
Failure - Common Errors:

If License Key Not Entered:

LICENSE ERROR: License key not configured
PLEASE CONFIGURE YOUR LICENSE:
1. Right-click on chart → Expert Advisors → Properties
2. Go to 'Inputs' tab
3. Find 'LICENSE SETTINGS' section
4. Enter your License Key

If WebRequest Not Enabled:

LICENSE VALIDATION FAILED: WebRequest not allowed.
Add 'https://misterscalper.com' to allowed URLs...
TROUBLESHOOTING STEPS:
1. Verify your license key is correct
2. Check that the license server is accessible
3. Ensure WebRequest is enabled for: https://misterscalper.com
   Go to: Tools → Options → Expert Advisors

Understanding IP-Based Licensing

How It Works

Your license is tied to IP addresses, not MT5 account numbers.

Example with 2 IP address license:
  1. First use from home (IP: 203.0.113.10)
    • EA validates → Your home IP is bound to license → ✓ Authorized
    • You can run EA on unlimited MT5 accounts from this IP
  2. Second use from VPS (IP: 198.51.100.5)
    • EA validates → Your VPS IP is bound to license → ✓ Authorized
    • You can run EA on unlimited MT5 accounts from this IP too
  3. Third use from another VPS (IP: 192.0.2.100)
    • EA validates → Checks: 2 IPs already bound
    • Denied: "License already used from 2 IP address(es). Maximum reached."

Benefits

  • Unlimited MT5 Accounts - Run on as many accounts as you want from the same IP
  • Home + VPS - Most licenses include 2 IPs (home and VPS)
  • Easy Management - No need to register account numbers

What if I change VPS or IP?

Contact support to unbind the old IP address, then you can use the new one.

Ongoing Operation

Automatic Validation

  • EA validates license every 24 hours
  • Uses cached status between validations
  • If server unreachable, uses 7-day grace period
  • Validation happens in background, doesn't interrupt trading

If Validation Fails During Trading

The EA will:

  1. Stop trading immediately
  2. Display error in chart comment
  3. Print error details in Expert log
  4. Remove itself from the chart

Grace Period

If the license server is temporarily unreachable:

  • EA continues working for 7 days using cached validation
  • After 7 days without successful validation, EA stops

Troubleshooting

EA Won't Start - "LICENSE ERROR"

Problem: License key not configured

Solution:

  1. Right-click chart → Expert Advisors → Properties
  2. Inputs tab → LICENSE SETTINGS
  3. Enter your license key exactly as provided

EA Won't Start - "WebRequest not allowed"

Problem: WebRequest not enabled for license server

Solution:

  1. Tools → Options → Expert Advisors
  2. Check: ✓ Allow WebRequest for listed URL
  3. Add: https://misterscalper.com
  4. Restart MT5

EA Won't Start - "Invalid license key"

Problem: License key is incorrect or doesn't exist

Solution:

  1. Verify you copied the key correctly (no extra spaces)
  2. Check your purchase email for the correct key
  3. Contact support if key doesn't work

EA Won't Start - "Max IP addresses reached"

Problem: You're trying to use the EA from more IPs than your license allows

Solution:

  1. If you changed VPS/location, contact support to unbind old IP
  2. Or upgrade to a license with more IP addresses

Support

Before Contacting Support

  1. Check the Expert log: View → Toolbox → Expert
  2. Note exact error message
  3. Verify WebRequest is enabled
  4. Try restarting MT5

Contact Information

Email: [email protected]

Include in your message:

  • License key (first 8 characters only: MS-XXXX...)
  • Error message from Expert log
  • MT5 account number
  • Broker name

Response Time: Usually within 24 hours

Important Notes

  • ⚠️ Keep your license key private - Do not share it with others
  • ⚠️ Internet required - EA needs internet for license validation
  • ⚠️ WebRequest must be enabled - Critical for license validation
  • ⚠️ License is personal - For your use only, not transferable without approval

License Features

  • ✅ Your license is monitored for security and unusual activity
  • ✅ Unauthorized sharing may result in license revocation
  • ✅ One license can run on unlimited accounts from authorized IPs