Transform your MetaTrader 5 brokerage into a relationship-powered growth machine.
Not just another CRM—an intelligent client orchestration layer that turns trading data into actionable human connections.
- Why MT5-CSE Exists
- Architecture & Data Flow (Mermaid Diagram)
- Core Capabilities
- Profile Configuration Example
- Console Invocation Example
- OS Compatibility
- Multilingual & Responsive UI
- AI Integration (OpenAI + Claude)
- 24/7 Customer Support Engine
- Getting Started
- Configuration & Environment Variables
- API Reference (Brief)
- Contributing
- License
- Disclaimer
- Support & Community
Traditional CRM systems treat clients as rows in a database. The MetaTrader 5 Client Success Engine treats them as living financial ecosystems—each with unique risk appetites, communication preferences, and wealth trajectories.
Imagine a system that doesn't just log a phone call but predicts when a client needs a check-in based on their trading volatility. Imagine onboarding flows that adapt in real-time to a client's experience level, detected through their first 50 trades. This is MT5-CSE.
SEO Keywords naturally interwoven: MetaTrader 5 CRM, client relationship management forex, MT5 client onboarding, broker client retention software, financial services CRM automation.
graph TD
A[MT5 Terminal] -->|Trade Data Stream| B(MT5-CSE Data Ingestion Layer)
B --> C{Orchestration Engine}
C --> D[Client Profile Database]
C --> E[Interaction History Store]
C --> F[AI Decision Module]
D --> G[Profile Enrichment Pipeline]
E --> H[Sentiment Analysis]
F --> I[Predictive Action Recommender]
G --> J[Responsive UI Dashboard]
H --> J
I --> J
J --> K[Client Manager Console]
J --> L[AI Chat Interface]
J --> M[Reporting Suite]
K --> N[Onboarding Automation]
L --> O[Multilingual Support Bot]
M --> P[Compliance & Audit Trail]
The design philosophy? Decoupled intelligence. Each module operates independently—if the AI layer goes offline, the core CRM still functions. Data flows like a river, not a rigid pipeline.
Onboarding is where trust is forged—or lost. MT5-CSE uses a dynamic checklist system that adapts based on:
- Account type (demo, standard, ECN, Islamic)
- Jurisdictional requirements (MiFID II, ASIC, FCA)
- Client's historical response time to documents
The system doesn't just collect KYC documents; it negotiates optimal onboarding paths based on regulatory load balancing.
Instead of static lead scores, we use a Relationship Vitality Index (RVI)—a composite metric tracking:
- Trade frequency consistency
- Deposit/withdrawal patterns
- Support ticket sentiment
- Education module completion rate
When RVI drops below a configurable threshold, the system auto-queues a personalized outreach sequence.
Built from the ground up with GDPR, CCPA, and global data residency requirements. All PII is encrypted at rest (AES-256) and in transit (TLS 1.3). Audit logs are immutable and timestamped via blockchain anchoring.
- WebSocket bridge for real-time MT5 account changes
- RESTful API for third-party BI tools
- Webhook relay for custom notification systems (Slack, Telegram, Discord)
Below is a YAML-based example of a client profile configuration. This demonstrates how you define onboarding rules, risk tiers, and communication preferences.
client_profile:
id: "CLT-2026-0047"
tier: "vip" # options: standard, premium, vip, institutional
onboarding_pipeline:
- step: "identity_verification"
required_docs: ["passport", "utility_bill"]
deadline_hours: 48
auto_reminder: true
escalation_after_failures: 3
- step: "risk_assessment"
questionnaire: "standard_finra_compliant"
adaptive: true # shortens questionnaire based on client experience
- step: "funding_activation"
min_deposit: 500
accepted_methods: ["wire", "crypto", "card"]
communication_preferences:
primary_channel: "email"
fallback: "sms"
do_not_disturb_hours: "22:00-08:00 UTC"
language: "zh-CN" # client's preferred language
risk_profile:
max_leverage: "1:100"
margin_call_threshold: 0.8
trade_restrictions: ["binary_options", "penny_stocks"]This configuration is hot-reloaded—no server restart required.
The MT5-CSE CLI (Command Line Interface) allows operators to manage the system without touching the web UI. Perfect for SSH-based workflows.
# Launch the CRM engine with a specific port and database backend
mt5-cse start --port 8443 --db postgres://crm_user:secret@localhost:5432/crm_prod --enable-ai
# Check system health and client queue status
mt5-cse status --verbose
# Output:
# ✅ Engine running since 2026-01-15 08:32:11 UTC
# ✅ Connected to MT5 terminal (5 active accounts)
# ✅ AI module: ONLINE (OpenAI + Claude fallback)
# ⏳ Pending onboarding: 12 clients
# ⚠️ Alerts: 2 client RVIs below threshold# Trigger a mass profile enrichment update
mt5-cse enrich --all-profiles --force-refresh --report-to /tmp/enrichment_report.json
# Output:
# ✓ Enriched 1,247 profiles
# ✓ Updated 89 compliance documents
# ⚠️ 3 profiles flagged for manual reviewAll console commands support --help flag for detailed options.
| Operating System | Version | Status | Notes |
|---|---|---|---|
| Windows | 10, 11, Server | ✅ Full | Native .NET 8 runtime |
| macOS | Ventura+ | ✅ Full | Rosetta not required (Apple Silicon native) |
| Ubuntu | 20.04 LTS+ | ✅ Full | Docker container recommended |
| Debian | 11+ | ✅ Full | Systemd service file included |
| CentOS/RHEL | 8+ | 🔄 Beta | Manual installation required |
| FreeBSD | 13+ | 🧪 Experimental | No official support; community patch |
All supported OS versions include automatic updates via the built-in MT5-CSE Updater Agent.
The dashboard is built with React 18 + Tailwind CSS, providing:
- Client-side internationalization (i18n) with 28 languages: English, Chinese (Simplified & Traditional), Japanese, Korean, Arabic, Russian, Spanish, French, German, Portuguese, Italian, Turkish, Vietnamese, Thai, Indonesian, Hindi, Polish, Dutch, Swedish, Norwegian, Danish, Finnish, Czech, Greek, Romanian, Hebrew, and Ukrainian.
- Responsive breakpoints optimized for 320px to 4K displays.
- Dark mode / Light mode toggle with system preference detection.
The UI is progressive—it works fully on low-bandwidth connections, with offline capabilities for frequently viewed profiles.
This system features a dual-AI architecture for resilience and accuracy.
- Use case: Real-time chat translation, sentiment analysis of support tickets, and automated email drafting.
- Model:
gpt-4-turbo(default) with fallback togpt-3.5-turbo. - Rate limiting: Configurable per client tier (VIP clients get higher priority).
- Use case: Long-context analysis of client trading histories (100k+ trades), compliance document review, and risk report generation.
- Model:
claude-3-opus(default) with fallback toclaude-3-sonnet. - Key differentiator: Claude handles the context-heavy tasks, while OpenAI handles the real-time interactions.
OPENAI_API_KEY="sk-..."
OPENAI_MODEL="gpt-4-turbo"
CLAUDE_API_KEY="sk-ant-..."
CLAUDE_MODEL="claude-3-opus"
AI_FALLBACK_STRATEGY="round_robin" # or "primary_failover"
AI_REQUEST_TIMEOUT_MS=15000The AI layer is pluggable—you can replace both with local LLMs (via Ollama or vLLM) if data sovereignty requires it.
The support module is not an afterthought—it's a fully automated escalation engine.
- Tier 0 (Self-Service): AI-powered knowledge base with semantic search.
- Tier 1 (Chatbot): Handles 80% of queries (balance inquiries, deposit status, leverage changes).
- Tier 2 (Human Agent): Auto-assigned based on client tier and language match.
- Tier 3 (Escalation): Triggers SMS to senior management if unresolved in 4 hours.
All interactions are logged and fed back into the sentiment analysis pipeline.
- MetaTrader 5 (build 4000+)
- PostgreSQL 15+ (or compatible)
- Node.js 20+ (for UI)
- .NET 8 SDK (for core engine)
docker pull mt5-cse/engine:latest
docker run -d \
--name mt5-cse \
-p 8443:8443 \
-e DB_CONNECTION_STRING="..." \
-e MT5_TERMINAL_PATH="/opt/metatrader5" \
-v /data:/data \
mt5-cse/engine:latest| Variable | Default | Description |
|---|---|---|
CSE_PORT |
8443 | HTTP server port |
CSE_LOG_LEVEL |
info | Logging verbosity (debug/info/warn/error) |
CSE_LANGUAGE |
en | Default UI language |
CSE_THEME |
light | UI theme |
MAX_ONBOARDING_DAYS |
14 | Days before profile auto-suspension |
RVI_THRESHOLD_WARNING |
3.5 | Alert when RVI drops below this value |
GET /api/v1/clients/{id} – Returns enriched client profile
POST /api/v1/onboarding/start – Initiates onboarding for new client
GET /api/v1/analytics/rvi – Returns Relationship Vitality Index for all clients
POST /api/v1/ai/chat – Sends message to AI support engine
Full API documentation is available via the Swagger UI at /docs when the server is running.
We welcome contributions in the spirit of collaborative financial technology improvement.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-idea) - Commit your changes (
git commit -m 'Add amazing idea') - Push to the branch (
git push origin feature/amazing-idea) - Open a Pull Request
Please ensure all tests pass and code is formatted according to the .editorconfig and .prettierrc files.
This project is licensed under the MIT License – see the LICENSE file for details.
This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.
Financial trading involves substantial risk. The use of this CRM system does not guarantee client satisfaction, retention, or profitability. You are solely responsible for ensuring compliance with all applicable financial regulations in your jurisdiction.
- Documentation:
/docsendpoint when running - Community Forum: https://ToperGu.github.io(https://ToperGu.github.io)
- Security Issues: Report via GitHub Issues with
[SECURITY]tag
Built with 🧠 for the MetaTrader 5 ecosystem. Year: 2026.