synapse-mt5
v1.2.12
Published
Synapse MT5 — Native C++ MCP server bridging AI assistants to MetaTrader 5. Sub-millisecond latency, zero Python dependencies.
Maintainers
Readme
What It Is
Synapse MT5 is a native Windows bridge that lets MCP-compatible AI clients work with MetaTrader 5. It gives your agent structured access to account data, market snapshots, history, open positions, chart tools, order previews, and guarded trade execution.
This is sold as a finished commercial product. You buy a license, add the key to your MCP client configuration, attach the included Expert Advisor in MT5, and the bridge handles the local connection.
What You Get
- Native C++ bridge binaries for Windows 10/11 x64
- SynapseMT5 Expert Advisor for MetaTrader 5
- Optional BoxTheoryKillZoneScanner alert EA for previous-D1 box and kill-zone monitoring
- 52 MCP tools covering account, market, chart, history, risk, recovery, and trade workflows
- Permission profiles from read-only analysis to guarded trade execution
- Local-first architecture: your trading account data stays on your machine
- One-time Founder's Edition license with lifetime access
- 30-day refund policy
Purchase
Synapse MT5 is sold through Gumroad. The current Founder's Edition price is $49 USD one-time for the first 50 launch copies. After the founder allocation is sold out, the price will increase.
Gumroad handles checkout and license delivery. After purchase, your license key is delivered by email.
Quick Start
Add your purchased license key to your MCP client configuration. This is the standard production setup:
{
"mcpServers": {
"synapse-mt5": {
"command": "npx",
"args": ["-y", "synapse-mt5", "--", "--profile", "read_only"],
"env": {
"SYNAPSE_LICENSE_KEY": "YOUR-LICENSE-KEY"
}
}
}
}Then copy the included SynapseMT5.ex5 Expert Advisor into your MT5 MQL5\Experts folder, restart MT5, and attach SynapseMT5 to one chart. The license key belongs in the MCP config, not in the EA inputs.
Permission Profiles
Use --profile to choose what the agent can do:
| Profile | Use it for |
|---|---|
| read_only | Account, positions, orders, logs, market data, history, and trade previews |
| analysis | Read-only tools plus chart screenshots |
| chart_control | Analysis plus chart drawing tools |
| trade_draft_only | Trade planning without confirmed order sends |
| trade_execution_enabled | Guarded order placement, modification, and closing |
| admin | Diagnostics and daemon control during setup or support |
For demo/live trade execution, configure both the MCP profile and daemon trade gate:
{
"mcpServers": {
"synapse-mt5": {
"command": "npx",
"args": [
"-y", "synapse-mt5",
"--",
"--profile", "trade_execution_enabled",
"--allow-trading",
"--allowed-symbols", "EURUSD,GBPUSD",
"--max-volume", "0.01"
],
"env": {
"SYNAPSE_LICENSE_KEY": "YOUR-LICENSE-KEY"
}
}
}
}Useful optional arguments:
When using npx, keep the -- separator before Synapse options so npm passes the flags to Synapse instead of consuming them.
| Argument | Purpose |
|---|---|
| --profile <name> | Selects the permission profile for this MCP client |
| --port <number> | Matches the EA bridge port; default is 7777 |
| --allow-trading | Enables daemon-side write-tool routing |
| --allowed-symbols <list> | Comma-separated exact symbols, all, or empty to block trading |
| --max-volume <lots> | Daemon-side max order size |
| --dry-run | Forces order checks without sending orders |
EA Inputs
The EA intentionally keeps only normal customer controls visible:
| EA input | Default | Meaning |
|---|---:|---|
| InpPort | 7777 | TCP bridge port; match --port only if you change it |
| InpAllowTrading | true | EA-side order tool gate |
| InpAllowedSymbols | all | EA-side symbol allowlist |
| InpMaxVolume | 0.10 | EA-side max lots per order |
| InpDryRun | false | Check orders without sending |
Recovery
Agents can call bridge.status to inspect the connection and bridge.refresh to refresh license/status state and request a fresh EA handshake. If a daemon was started before the license key was added, restart your MCP client; current builds detect that state and recover automatically.
If you change daemon-level trading arguments while a daemon is already running, close the MCP client and restart it so the daemon starts with the new settings.
After updating Synapse MT5, also replace SynapseMT5.ex5 in MT5 and reattach the EA or restart MT5. bridge.status reports the loaded EA version, which should match the package version.
Release Notes
Release notes are included in the npm package as CHANGELOG.md. Version 1.2.12 adds the optional BoxTheoryKillZoneScanner alert EA and improves npm README logo visibility.
Supported Clients
Synapse MT5 works with MCP-compatible clients and IDE agent environments, including:
- Claude Desktop
- Cursor
- Windsurf
- ChatGPT-compatible MCP hosts
- Custom MCP clients
Website Status
The temporary production website is currently hosted at synapse-mt5.vercel.app. Checkout and license delivery through Gumroad are live.
Some website content sections are still under active maintenance while we refine the public documentation, dashboard copy, and launch materials. We are also resolving issues with the primary .io domain and will replace the temporary Vercel URL shortly.
Roadmap
We are working on curated agent skills for trading workflows and selected strategy research. These skills are being developed carefully with testing, research, and due diligence so they improve the customer experience without encouraging unsafe trading behavior.
Planned additions include:
- Strategy-specific agent skill packs
- More guided setup material
- Improved dashboard and documentation pages
- More examples for safe trade preview, risk checks, and execution workflows
Support
- Purchase and license delivery: Gumroad
- Website and setup notes: synapse-mt5.vercel.app
- License delivery issues: reply to your Gumroad purchase email
- Product support: [email protected]
Trading Risk
Synapse MT5 is infrastructure software. It is not a signal service, financial advisor, broker, or guaranteed trading system. Trading involves substantial risk of loss. Always test on a demo account first and use conservative risk limits before enabling live execution.
License
Synapse MT5 is proprietary commercial software. See LICENSE for the full license terms.
Product
| | |
|---|---|
| Version | 1.2.12 (early-access) |
| MCP Tools | 52 - bridge.status, bridge.refresh, ping, account.summary, terminal.status + 47 more |
| License | One-time purchase, perpetual license (Founder's Edition) |
| Price | $49 USD one-time |
| Founder Allocation | First 50 launch copies |
| Install | npx synapse-mt5 |
| Platform | Windows 10/11 (64-bit) |
| Engine | Native C++ (MSVC 2022, C++17) |
| Website | https://synapse-mt5.vercel.app |
| Gumroad | https://mfalme4.gumroad.com/l/synapse-mt5 |
| Last Updated | 2026-06-27 |
