<p align="center">
  <img src="https://cdn.jsdelivr.net/npm/synapse-mt5@latest/assets/synapse-logo-on-black.png" width="104" alt="Synapse MT5 logo" />
</p>

<h1 align="center">Synapse MT5</h1>

<p align="center">
  <strong>Native C++ MCP Bridge for MetaTrader 5</strong><br/>
  <em>Connect AI agents to your MT5 terminal through a production-ready commercial bridge.</em>
</p>

<p align="center">
  <a href="https://synapse-mt5.vercel.app"><img src="https://img.shields.io/badge/Website-synapse--mt5.vercel.app-111111?style=for-the-badge&logo=vercel&logoColor=white" alt="Website" /></a>
  <a href="https://mfalme4.gumroad.com/l/synapse-mt5"><img src="https://img.shields.io/badge/Founders-$49-ff5a1f?style=for-the-badge&logo=gumroad&logoColor=white" alt="Buy on Gumroad" /></a>
  <img src="https://img.shields.io/npm/v/synapse-mt5?style=for-the-badge&color=CB3837&logo=npm&logoColor=white" alt="npm version" />
</p>

<p align="center">
  <img src="https://img.shields.io/badge/C++-17-00599C?style=for-the-badge&logo=cplusplus&logoColor=white" alt="C++17" />
  <img src="https://img.shields.io/badge/MQL5-Expert%20Advisor-0f6bff?style=for-the-badge" alt="MQL5 Expert Advisor" />
  <img src="https://img.shields.io/badge/MCP-64%20tools-7c3aed?style=for-the-badge" alt="64 MCP tools" />
  <img src="https://img.shields.io/badge/Windows-10%2F11%20x64-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Windows 10/11 x64" />
  <img src="https://img.shields.io/badge/License-Commercial-f59e0b?style=for-the-badge" alt="Commercial license" />
</p>

---

## 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
- 64 MCP tools covering account, market, chart, history, Box Theory, risk, recovery, drawing cleanup, 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.

[Buy Synapse MT5 on Gumroad](https://mfalme4.gumroad.com/l/synapse-mt5)

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:

```json
{
  "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:

```json
{
  "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. For setup/support sessions using the `admin` profile, agents can call `bridge.refresh` with `{"restart_daemon": true}` to request a controlled daemon restart from the MCP tool surface.

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, restart the MCP server, replace `SynapseMT5.ex5` in MT5, and reattach the EA or restart MT5. `bridge.status` reports the loaded daemon, client, and EA versions, which should match the package version.

## Release Notes

Release notes are included in the npm package as `CHANGELOG.md`. Version `1.4.2` improves MCP client/daemon handoff after package updates and adds clearer lifecycle fields to `bridge.status`.

## 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](https://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](https://mfalme4.gumroad.com/l/synapse-mt5)
- Website and setup notes: [synapse-mt5.vercel.app](https://synapse-mt5.vercel.app)
- License delivery issues: reply to your Gumroad purchase email
- Product support: support@synapse-mt5.dev

## 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](LICENSE) for the full license terms.

<!-- SYNAPSE_PRODUCT_FACTS_START -->

## Product

| | |
|---|---|
| **Version** | 1.4.2 (early-access) |
| **MCP Tools** | 64 - bridge.status, bridge.refresh, ping, account.summary, terminal.status + 59 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](https://synapse-mt5.vercel.app) |
| **Gumroad** | [https://mfalme4.gumroad.com/l/synapse-mt5](https://mfalme4.gumroad.com/l/synapse-mt5) |
| **Last Updated** | 2026-06-29 |

<!-- SYNAPSE_PRODUCT_FACTS_END -->
