ariadng/metatrader-mcp-server

**Let AI assistants trade for you using natural language**
---
📑 Table of Contents
- What is This?
- Features
- Who Is This For?
- Important Disclaimer
- Prerequisites
- Quick Start
- Trading Assistant Skill
- Usage Examples
- Available Operations
- WebSocket Quote Server
- Advanced Configuration
- Roadmap
- Development
- Contributing
- Documentation
- Getting Help
- License
---
🌟 What is This?
**MetaTrader MCP Server** is a bridge that connects AI assistants (like Claude, ChatGPT) to the MetaTrader 5 trading platform. Instead of clicking buttons, you can simply tell your AI assistant what to do:
> "Show me my account balance"
> "Buy 0.01 lots of EUR/USD"
> "Close all profitable positions"
The AI understands your request and executes it on MetaTrader 5 automatically.
How It Works
✨ Features
- **🗣️ Natural Language Trading** - Talk to AI in plain English to execute trades
- **🤖 Multi-AI Support** - Works with Claude Desktop, ChatGPT (via Open WebUI), and more
- **📊 Full Market Access** - Get real-time prices, historical data, and symbol information
- **💼 Complete Account Control** - Check balance, equity, margin, and trading statistics
- **⚡ Order Management** - Place, modify, and close orders with simple commands
- **🔒 Secure** - All credentials stay on your machine
- **🌐 Flexible Interfaces** - Use as MCP server, REST API, or WebSocket stream
- **📖 Well Documented** - Comprehensive guides and examples
🎯 Who Is This For?
- **Traders** who want to automate their trading using AI
- **Developers** building trading bots or analysis tools
- **Analysts** who need quick access to market data
- **Anyone** interested in combining AI with financial markets
⚠️ Important Disclaimer
**Please read this carefully:**
Trading financial instruments involves significant risk of loss. This software is provided as-is, and the developers accept **no liability** for any trading losses, gains, or consequences of using this software.
By using this software, you acknowledge that:
- You understand the risks of financial trading
- You are responsible for all trades executed through this system
- You will not hold the developers liable for any outcomes
- You are using this software at your own risk
**This is not financial advice. Always trade responsibly.**
---
📋 Prerequisites
Before you begin, make sure you have:
1. **Python 3.10 or higher** - Download here
2. **MetaTrader 5 terminal** - Download here
3. **MT5 Trading Account** - Demo or live account credentials
- Login number
- Password
- Server name (e.g., "MetaQuotes-Demo")
🚀 Quick Start
Step 1: Install the Package
Open your terminal or command prompt and run:
Step 2: Enable Algorithmic Trading
1. Open MetaTrader 5
2. Go to Tools → Options
3. Click the Expert Advisors tab
4. Check the box for Allow algorithmic trading
5. Click OK
Step 3: Choose Your Interface
Pick one based on how you want to use it:
Option A: Use with Claude Desktop (Local STDIO)
1. Find your Claude Desktop config file:
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
- **Mac**: ~/Library/Application Support/Claude/claude_desktop_config.json
2. Open the file and add this configuration:
**Optional: Specify Custom MT5 Terminal Path**
If your MT5 terminal is installed in a non-standard location, add the --path argument:
3. Replace YOUR_MT5_LOGIN, YOUR_MT5_PASSWORD, and YOUR_MT5_SERVER with your actual credentials
4. Restart Claude Desktop
5. Start chatting! Try: *"What's my account balance?"*
Option B: Use with Open WebUI (For ChatGPT and other LLMs)
1. Start the HTTP server:
**Optional: Specify Custom MT5 Terminal Path**
If your MT5 terminal is installed in a non-standard location, add the --path argument:
2. Open your browser to http://localhost:8000/docs to see the API documentation
3. In Open WebUI:
- Go to **Settings** → **Tools**
- Click **Add Tool Server**
- Enter http://localhost:8000
- Save
4. Now you can use trading tools in your Open WebUI chats!
Option C: Real-Time Quotes via WebSocket
Stream live tick data (bid, ask, spread, volume) over WebSocket for dashboards, bots, or monitoring: