How do I use mt5-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mt5-mcp show me my account balance" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mt5-mcp

by mergeos-bounties

Overview Schema Related Servers Score Discussions

Python

Local

mt5-mcp

Python 3.11+ Version License: MIT MCP

mt5-mcp is an MCP server so AI agents can inspect and trade against a MetaTrader 5 terminal — account, symbols, quotes, orders/positions, history — with a full offline mock for CI and demos.

Install (one command)

Grok — recommended

pip install "git+https://github.com/mergeos-bounties/mt5-mcp.git" && grok plugin install mergeos-bounties/mt5-mcp --trust

This installs the Python CLI (mt5-mcp) and the Grok plugin (skill + MCP server from .mcp.json).

Check:

mt5-mcp version
mt5-mcp doctor
mt5-mcp demo
grok plugin list
grok mcp list

Local clone:

git clone https://github.com/mergeos-bounties/mt5-mcp.git
cd mt5-mcp
pip install -e ".[dev]"
grok plugin install . --trust

Other agents (stdio MCP)

After pip install "git+https://github.com/mergeos-bounties/mt5-mcp.git", point any MCP host at:

Field	Value
command	`mt5-mcp`
args	`["serve"]`
env	`MT5_MCP_MODE=mock`

Claude Desktop — merge examples/claude_desktop_config.json into Claude MCP config.

Cursor — merge examples/cursor_mcp.json.

Grok config.toml (manual, without plugin):

[mcp_servers.mt5_mcp]
command = "mt5-mcp"
args = ["serve"]
env = { MT5_MCP_MODE = "mock" }
enabled = true

One-liner via Grok CLI:

pip install "git+https://github.com/mergeos-bounties/mt5-mcp.git"
grok mcp add mt5-mcp -- mt5-mcp serve

Related MCP server: OpenTrading

Supported AI agents / hosts

Host	Support	Install
Grok (CLI / TUI / Build)	Yes	`grok plugin install mergeos-bounties/mt5-mcp --trust` then `pip install "git+https://github.com/mergeos-bounties/mt5-mcp.git"`
Claude Desktop	Yes	Copy examples/claude_desktop_config.json into Claude MCP settings
Cursor	Yes	Merge examples/cursor_mcp.json into Cursor MCP config
Claude Code	Yes	stdio MCP: same `command`/`args` as Claude Desktop / Grok
VS Code (MCP / Continue / Cline)	Yes	Generic stdio server config pointing at `mt5-mcp serve`
Windsurf / Cascade	Yes	stdio MCP entry with `mt5-mcp` + `serve`
Codex CLI	Yes (stdio)	Register MCP server command `mt5-mcp serve` in Codex MCP settings
ChatGPT Desktop	Partial	Only if host supports custom MCP stdio servers
Gemini CLI	Partial	Only if MCP stdio plugins are enabled

All packages speak MCP over stdio (mt5-mcp serve). Default mode is mock (offline, no simulator/terminal/GIMP required).

Modes

Mode	When	Behavior
mock (default)	Windows / CI / no terminal	Seeded demo account, FX/CFD symbols, orders, history
live	Host has a bridge configured	Optional file/HTTP bridge (see env vars); fails closed if unavailable

Highlights

Capability	Description
Offline demo	`mt5-mcp demo` exercises doctor, quotes, market order, history
MCP stdio serve	Plug into Cursor / Claude / Grok as an MCP server
One-shot call	`mt5-mcp call …` without a full MCP host
Safety	Mock never talks to a real broker; live needs explicit env

Quick start

cd mt5-mcp
python -m venv .venv
.\.venv\Scripts\activate
pip install -e ".[dev]"

mt5-mcp version
mt5-mcp demo
mt5-mcp tools list
pytest -q

Mock mode needs no MetaTrader install.

CLI reference

Command	Purpose
`mt5-mcp version`	Version + mode
`mt5-mcp status`	Mode, balance, equity, positions, orders
`mt5-mcp demo`	Offline smoke of core backend APIs
`mt5-mcp doctor`	Backend health
`mt5-mcp serve`	MCP server over stdio
`mt5-mcp call …`	One-shot tool call
`mt5-mcp tools list`	List MCP tools

mt5-mcp serve

MCP tools

Tool	Purpose
`mt5_mode`	Get/set mock\|live
`mt5_doctor`	Connectivity / account health
`mt5_seed_demo`	Reset mock account
`mt5_account`	Balance, equity, margin, trade mode
	`mt5_symbols`
	`mt5_symbol_spec`
	`mt5_quote`
`mt5_positions`	Open positions (filled market orders)
`mt5_orders`	Pending orders (limit/stop, not yet filled)
`mt5_order_send`	Market/pending
`mt5_position_close`	Close position by ticket
`mt5_history_deals`	Deal history
`mt5://account` (resource)	Account + positions snapshot

MCP host config

{
  "mcpServers": {
    "mt5-mcp": {
      "command": "python",
      "args": ["-m", "mt5_mcp"],
      "env": {
        "MT5_MCP_MODE": "mock"
      }
    }
  }
}

Also see examples/cursor_mcp.json.

Live bridge (optional)

Set env (never commit secrets):

Variable	Meaning
`MT5_MCP_MODE`	`mock` or `live`
`MT5_MCP_MAGIC`	Optional magic number for live orders
`MT5_MCP_MAX_VOLUME`	Max order volume cap
`MT5_MCP_SYMBOL_ALLOWLIST`	Comma-sep allowlisted symbols
`MT5_MCP_BRIDGE_URL`	Optional HTTP bridge base URL
`MT5_MCP_BRIDGE_FILE`	Optional request/response JSON file path

Without a working bridge, live mode returns structured errors; demos stay on mock.

Safety

Rule	Detail
Mock-only env	Copy `examples/env.mock.example` → `.env` and keep `MT5_MCP_MODE=mock`
No secrets in git	Add `.env` to `.gitignore` — never commit live broker credentials
Max volume	Set `MT5_MCP_MAX_VOLUME` to cap any single order in live mode
Symbol allowlist	Restrict tradeable symbols via `MT5_MCP_SYMBOL_ALLOWLIST` (comma-sep)

Deal history

Deal history fields

Field	Type	Description
`ticket`	int	Deal ID
`time`	str	Timestamp
`symbol`	str	Instrument
`type`	str	Deal type (buy/sell)
`volume`	float	Lot size
`price`	float	Execution price
`commission`	float	Broker commission (mock)
`swap`	float	Overnight swap (mock)
`profit`	float	Net P&L (mock)

Development

pip install -e ".[dev]"
ruff check src tests
pytest -q
mt5-mcp demo

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

metatrader-mcp-server
Finance
ariadng
A
license
-
quality
D
maintenance
metatrader-mcp-server
Updated 5 months ago (2026-03-28 18:39 UTC)
708
MIT
OpenTrading
Finance AI & Machine Learning Autonomous Agents
hyuwowo
A
license
-
quality
D
maintenance
An open-source AI trading agent for MetaTrader 5 with MCP support, connecting AI clients to MT5 for market data, analysis, and risk-gated trading.
Updated 3 months ago (2026-05-07 15:09 UTC)
MIT
mt5-mcp
Finance Autonomous Agents
vincentwongso
A
license
A
quality
A
maintenance
An MCP server that lets an AI agent read your MetaTrader 5 account and place trades over the Model Context Protocol, with a configurable human approval gate.
Updated 12 days ago (2026-08-05 04:28 UTC)
15
4
MIT
mt5ctl
Finance Shell Access
Chust-dev
A
license
-
quality
B
maintenance
An MCP server for operating headless MetaTrader 5 terminals — over SSH, from your agent.
Updated a month ago (2026-07-06 01:41 UTC)
MIT

View all related MCP servers

Related MCP Connectors

Backtest360
MCP server exposing the Backtest360 engine API as tools for AI agents.
MTContext
Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.
gainium-mcp
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mergeos-bounties/mt5-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mt5-mcp

Install (one command)

Grok — recommended

Other agents (stdio MCP)

Supported AI agents / hosts

Modes

Highlights

Quick start

CLI reference

MCP tools

MCP host config

Live bridge (optional)

Safety

Deal history

Deal history fields

Development

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

metatrader-mcp-server

OpenTrading

mt5-mcp

mt5ctl

Related MCP Connectors

Latest Blog Posts

MCP directory API