How do I use mt4-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., "@mt4-mcp show my current 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.

mt4-mcp

by mergeos-bounties

Overview Schema Related Servers Score Discussions

Python

Local

mt4-mcp

Python 3.11+ Version License: MIT MCP

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

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

Related MCP server: ctrader-mcp-server

Highlights

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

Quick start

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

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

Mock mode needs no MetaTrader install.

CLI reference

Command	Purpose
`mt4-mcp version`	Version + mode
`mt4-mcp demo`	Offline smoke of core backend APIs
`mt4-mcp doctor`	Backend health
`mt4-mcp serve`	MCP server over stdio
`mt4-mcp call …`	One-shot tool call
`mt4-mcp tools list`	List MCP tools

mt4-mcp serve

MCP tools

Tool	Purpose
`mt4_mode`	Get/set mock\|live
`mt4_doctor`	Connectivity / account health
`mt4_seed_demo`	Reset mock account
`mt4_account`	Balance, equity, margin
`mt4_symbols`	Symbol list
`mt4_quote`	Bid/ask for a symbol
`mt4_orders`	Open orders
`mt4_order_send`	Market/pending OrderSend-style
`mt4_order_modify`	SL/TP/price modify
`mt4_order_close`	Close by ticket
`mt4_history`	Closed order history

MCP host config

{
  "mcpServers": {
    "mt4-mcp": {
      "command": "python",
      "args": ["-m", "mt4_mcp"],
      "env": {
        "MT4_MCP_MODE": "mock"
      }
    }
  }
}

Also see examples/cursor_mcp.json.

Live bridge (optional)

Set env (never commit secrets):

Variable	Meaning
`MT4_MCP_MODE`	`mock` or `live`
`MT4_MCP_BRIDGE_URL`	Optional HTTP bridge base URL
`MT4_MCP_BRIDGE_FILE`	Optional request/response JSON file path

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

Development

pip install -e ".[dev]"
ruff check src tests
pytest -q
mt4-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.

Latest Blog Posts

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
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

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/mt4-mcp'

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