Skip to main content
Glama

mql5-docs-mcp

CI

An MCP server that gives coding agents (Claude Code, Cursor, Claude Desktop) the real MQL5 function signatures and error-code meanings, so they stop writing MQL4 syntax or inventing functions when they build MetaTrader 5 EAs.

It runs locally over stdio with a prebuilt index. It makes no network calls at runtime and needs no API key.

Tools

Tool

What it does

Example

search_reference

Search built-in functions by name or section, up to 10 results

Copy, Trade Functions

get_signature

Exact signature(s), section and doc link for one function

CopyBuffer

explain_code

Trade server return codes and runtime errors, by number or constant

10016, 4014, TRADE_RETCODE_DONE

Example get_signature("CopyBuffer"):

CopyBuffer (Timeseries and Indicators Access)
int CopyBuffer(int indicator_handle, int buffer_num, int start_pos, int count, double buffer[])
int CopyBuffer(int indicator_handle, int buffer_num, datetime start_time, int count, double buffer[])
int CopyBuffer(int indicator_handle, int buffer_num, datetime start_time, datetime stop_time, double buffer[])
https://www.mql5.com/en/docs/series/copybuffer

Related MCP server: mt5-mcp

Status (v0.1)

The index covers all 517 functions in the official function index (name, section and doc link) and all 296 trade return codes and runtime errors. Exact signatures are indexed for 203 functions so far, because mql5.com rate-limited the indexer partway through. For the rest, get_signature returns the doc link. Running npm run build:index again resumes from .cache/ and fills in the gaps.

Install

Claude Code:

claude mcp add mql5-docs -- npx -y github:zafmy/mql5-docs-mcp

Any other MCP client (mcpServers config):

{ "mql5-docs": { "command": "npx", "args": ["-y", "github:zafmy/mql5-docs-mcp"] } }

Scope

Covered: MQL5 built-in functions from the official function index, trade server return codes and runtime error codes.

Not covered: Standard Library classes (CTrade and friends), backtesting, broker connections and compiling. The index stores names, signatures, sections and links only. For the full explanation, follow the link to mql5.com.

Develop

npm install
npm test               # builds and runs the tests against the bundled index
npx -y github:zafmy/mcp-smoke -- node dist/index.js   # smoke-tests the built server with mcp-smoke.json
npm run build:index    # re-scrapes the reference slowly (4 s/page), resumable via .cache/
npm run build:index:offline  # rebuilds data/ from .cache/ only, no network

License

MIT for the code. MQL5 and MetaTrader are trademarks of MetaQuotes Ltd.; this project is not affiliated with them. Signatures and code descriptions come from the official MQL5 reference.

Available Tools

3 tools
explain_codeA

Explain an MQL5 trade server return code (MqlTradeResult.retcode, e.g. 10016) or runtime error (GetLastError(), e.g. 4014) by number or constant name.

Inputs: code (required).

get_signatureA

Get the exact MQL5 signature(s), section and official doc link for one function, e.g. CopyBuffer or OrderSend.

Inputs: name (required).

search_referenceA

Search the official MQL5 (MetaTrader 5) function reference by name or section. Returns up to 10 matches with signatures and doc links. Use before writing MQL5 calls to avoid MQL4 syntax or invented functions.

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 3 tools

    Disambiguation4/5

    search_reference and get_signature both target function lookups and could be confused at the margins, but the multi-match search vs. single exact-signature semantics are described clearly. explain_code is entirely distinct, targeting return codes and runtime errors.

    Naming Consistency5/5

    All three tools use a consistent snake_case verb_noun pattern (search_reference, get_signature, explain_code) with clear, predictable action verbs. No mixing of conventions or styles.

    Tool Count4/5

    Three focused tools is on the lean side but each earns its place covering search, lookup, and error decoding. Slightly thin for a documentation server that could also expose browsing or content retrieval.

    Completeness3/5

    Search, signature lookup, and error explanation are covered, but there is no way to retrieve full documentation text, code examples, or enumerate functions within a section. These gaps force agents to rely only on signatures and external links.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A local-first MCP server that bridges AI coding agents with MetaTrader 5 for inspection, market data, MQL5 development, compiling, Strategy Tester review, workspace sync, logs, audit trails, demo trading, and carefully gated live trading.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables LLM agents to compile, deploy, backtest, and analyze MetaTrader 4/5 MQL sources without touching the MetaTrader UI, leveraging the build pipeline.
      41
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with MetaTrader 5 for market data, live streaming, and trading operations, running locally over stdio.
      -