Skip to main content
Glama

etrink-mcp

MCP server for etrink: cloud MetaTrader 5 accounts and 24/7 bot hosting, driven by Claude, OpenAI Codex, Gemini CLI, Cursor or any other MCP client. stdio transport, Node.js 18+, no runtime dependencies (the published file is a single bundle).

This repository is the server implementation: TypeScript sources in src/ (index.ts — MT5 tools, services-tools.ts — service hosting tools, apiClient.ts — HTTPS client for api.etrink.com), built with esbuild into dist/etrink-mcp.mjs. Published on npm as etrink-mcp.

Run

ETRINK_API_KEY=etrk_mcp_... npx -y etrink-mcp

Create the API key at https://etrink.com/app/api-keys (the key is shown once — keep it in an env var or a .env file and point ETRINK_ENV_FILE at it; never commit it).

Env

Meaning

ETRINK_API_KEY

Your etrink API key (required)

ETRINK_ENV_FILE

Path to a .env file that contains ETRINK_API_KEY=... (alternative to the above)

ETRINK_API_BASE

API base URL, default https://api.etrink.com

Client config (Claude Desktop, Cursor, Gemini CLI, … — mcpServers JSON):

{ "mcpServers": { "etrink": { "command": "npx", "args": ["-y", "etrink-mcp"],
                               "env": { "ETRINK_ENV_FILE": "/full/path/.env" } } } }

Claude Code: claude mcp add etrink -e ETRINK_ENV_FILE=/full/path/.env -- npx -y etrink-mcp

Related MCP server: mt5ctl

Tools

  • MT5 (read): list_accounts, get_open_positions, get_positions, get_report, get_trades, get_recent_signals

  • MT5 (write — the agent must dry-run with test: true and get the user's confirmation): place_order, open_account

  • Service hosting: list_services, get_service, create_service, deploy_service, get_build, list_releases, get_service_logs, set_service_env, update_service, start_service, stop_service, restart_service, rollback_service, exec_in_service, delete_service

Every order passes the same server-side guards as etrink webhooks (plan limits, symbol allow-list, volume cap, idempotency). How an agent should use the tools safely: the companion Agent Skill etrinkhq/etrink-skill (Claude, Codex, Gemini CLI, Cursor).

Build

npm install && npm run build   # → dist/etrink-mcp.mjs

License: MIT

Available Tools

23 tools
create_serviceA

Yeni bir servis oluşturur (kod henüz yüklenmez — ardından deploy_service). Ayarlar kodun kökündeki etrink.json ile de verilebilir: {"runtime":"python|node|static|binary","version":"node: 26|24|22 · python: 3.14|3.13|3.12|3.11 (isteğe bağlı; yoksa package.json engines.node / .python-version, o da yoksa en yeni)","start":"python main.py","port":8080,"size":"small|medium|large","db":"none|postgres|postgres_redis","public":false,"spa":false}. static = kökte index.html olan HTML/CSS/JS sitesi (sunucu kodu yok, port 8080 ve HTTPS otomatik; spa:true bilinmeyen yolları index.html'e düşürür). GÜVENLİK KURALI (geçersiz kılınamaz): desteği bitmiş dil sürümü istenirse yükleme reddedilir (version_eol); derlemede npm audit (yüksek/kritik) ya da pip-audit (düzeltmesi olan açık) bulursa derleme başarısız olur — paketleri güncel sürüme yükseltip tekrar yükle. Boyutlar: small 0.25 CPU/256 MB/1 GB disk, medium 0.5/512 MB/3 GB, large 1/1 GB/10 GB. Ücret (kullandıkça öde müşterisi): günlük karşılığı small $0.10, medium $0.20, large $0.40, +postgres $0.10, +postgres_redis $0.13; başlamış her saat bakiyeden kesilir (aynı gün silinirse yalnız kullanılan saatler). Oluşturma/yükleme için en az 1 günlük bakiye gerekir (insufficient_balance).

Inputs: name (required), db, port, size, +2 more.

delete_serviceA

Servisi siler. Geri alınamaz: /data ve veritabanı 7 gün sonra kalıcı silinir. confirm alanına servisin slug'ını aynen yaz. Kullanıcı açıkça istemedikçe çağırma.

Inputs: confirm (required), serviceId (required).

deploy_serviceA

Yerel bir klasörü (ya da tek bir derlenmiş Linux x86_64 programını) zipleyip servise yükler, derlemeyi bekler ve sonucu + derleme logunu döner. .gitignore'a uyar; node_modules, .venv, .git, .env* gönderilmez (bağımlılıklar sunucuda requirements.txt / package.json'dan kurulur). Derleme hata verirse logu oku, kodu düzelt ve tekrar deploy_service çağır. Başarılıysa get_service_logs ile çalışma çıktısını izle.

Inputs: path (required), serviceId (required), wait.

exec_in_serviceA

Servisin ortamında (aynı kod, env, veritabanı, /data) tek seferlik bir komut çalıştırır ve çıktısını döner — ör. 'python manage.py migrate', 'node scripts/seed.js', 'ls -la /data'. En fazla 300 sn; çıktı en fazla 64 KB.

Inputs: cmd (required), serviceId (required), timeoutSec.

get_buildA

Bir sürümün derleme durumu ve logu (en fazla 60 sn bekler). deploy_service wait=false ile çağrıldıysa kullan.

Inputs: releaseId (required), serviceId (required).

get_open_positionsB

Tüm (ya da seçilen) hesapların açık pozisyonlarını ve bakiye/equity'sini son snapshot'tan döner; magic/sembol ile süzülebilir.

Inputs: magic, symbol, accountId.

get_positionsB

Belirli bir MT5 hesabının açık pozisyonlarını ve son bakiye/equity değerini döner. accountId list_accounts'tan alınır.

Inputs: accountId (required).

get_recent_signalsA

Müşterinin son sinyal/emir olaylarını (webhook + MCP) döner: tarih, durum (pending/done/rejected/failed/test), payload, hedef hesap; ayrıca sinyal fiyatı, dolum fiyatı, kayma (aleyhe +) ve iletim gecikmesi (sn). magic/hesap/durum/tarih ile süzülebilir.

Inputs: limit, magic, since, before, +2 more.

get_reportB

Kapanan işlemlerin özeti (panel Rapor sayfası): toplam işlem/kazanan/kaybeden/brüt kâr-zarar/net, magic bazında kırılım ve günlük net. Net = kâr + swap + komisyon (hesap para biriminde; cent hesapta USC).

Inputs: to, tz, from, magic, +2 more.

get_serviceA

Bir servisin ayrıntısı: durum, durum açıklaması, son sürüm, başlatma komutu, env değişken ADLARI (değerler gösterilmez), kaynak kullanımı.

Inputs: serviceId (required).

get_service_logsA

Servisin çalışma logları (stdout/stderr + sistem olayları: başlatma, çökme, bellek aşımı). Yeni satırlar için önceki yanıttaki cursor'ı after olarak ver.

Inputs: serviceId (required), after, lines.

get_tradesA

Kapanan işlemleri listeler (en yeni önce): ticket, sembol, yön, lot, açılış/kapanış fiyatı ve zamanı, kâr, swap, komisyon, net, magic, yorum, hesap. Devamı için dönen nextCursor'ı cursor olarak verin.

Inputs: to, from, limit, magic, +3 more.

list_accountsB

Müşterinin etrink'teki MT5 hesaplarını listeler (id, label, broker, login, durum, bakiye, equity).

Inputs: no named parameters.

list_releasesC

Servisin sürüm geçmişi (sürüm no, derleme durumu, kaynak: panel/api, tarih).

Inputs: serviceId (required).

list_servicesA

etrink'te barındırılan servislerini listeler (Python / Node.js / hazır Linux programı): durum, boyut, adres, kaynak kullanımı, kota. Durumlar: no_release (kod yok), building, starting, running, crashed, stopped, error.

Inputs: no named parameters.

open_accountA

Yeni bir MT5 hesabı oluşturur (varsayılan: manuel login, demo) ve isteğe bağlı olarak instance başlatır. Auto login için login+password+mt5Server gerekir. region opsiyonel (en yakın sunucu seçimi).

Inputs: brokerName (required), label, login, region, +5 more.

place_orderB

Bir MT5 hesabında emir gönderir: buy/sell (volume gerekli) veya close. Sunucu güvenlik limitlerini (volume tavanı, izinli semboller, üyelik/plan) uygular. test=true ise doğrulama yapılır ama GERÇEK EMİR gönderilmez.

Inputs: action (required), symbol (required), accountId (required), id, +8 more.

restart_serviceC

Servisi yeniden başlatır (çöktüyse de).

Inputs: serviceId (required).

rollback_serviceB

Bir önceki başarılı sürüme (ya da verilen releaseId'ye) geri döner.

Inputs: serviceId (required), releaseId.

set_service_envA

Ortam değişkenlerini (API anahtarları, ayarlar) ekler / değiştirir / siler; servis yeni değerlerle yeniden başlar. Değerler şifreli saklanır ve bir daha GÖSTERİLMEZ. PORT, DATABASE_URL, REDIS_URL, DATA_DIR sistem tarafından verilir. Gizli değerleri koda ya da zip'e koyma — bu aracı kullan.

Inputs: serviceId (required), set, unset.

start_serviceB

Durmuş servisi başlatır.

Inputs: serviceId (required).

stop_serviceA

Servisi durdurur (veriler korunur).

Inputs: serviceId (required).

update_serviceB

Servis ayarlarını değiştirir (ad, boyut, veritabanı, port, başlatma komutu, dışarıdan HTTPS erişimi). Değişiklik servisi yeniden başlatır.

Inputs: serviceId (required), db, name, port, +3 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 23 tools

    Disambiguation4/5

    Most tools map to a distinct resource+action: service lifecycle (create/deploy/start/stop/restart/rollback/delete), observability (get_service, get_build, get_service_logs, list_releases), and MT5 trading (accounts, positions, orders, signals, reports, trades). The one real collision is get_positions (single account, live) versus get_open_positions (all accounts, last snapshot), which return near-identical data and invite misselection; get_recent_signals vs get_trades vs get_report are close but descriptions differentiate them (events vs closed trades vs aggregate).

    Naming Consistency4/5

    All 23 names are snake_case with a leading verb (list_/get_/create_/delete_/update_/start_/stop_/restart_/deploy_/rollback_/set_/exec_in_), which is highly predictable. Minor deviations: get_build and list_releases omit the '_service'/'service_' qualifier that the other ~15 hosting tools use, making them look domain-agnostic even though they are service-scoped.

    Tool Count3/5

    23 tools is heavy for a single server, and the surface is really two products stapled together (~15 hosting tools plus ~8 MT5 trading tools). Each half is reasonably scoped on its own, but the combined set exceeds the comfortable 3-15 range and increases selection cost.

    Completeness4/5

    Hosting coverage is essentially complete: create, deploy, build status, releases, logs, env, start/stop/restart, rollback, update, delete, plus one-off exec — no dead ends. Trading coverage handles accounts, positions, order placement/close, signals, trades and reporting, but lacks account-level operations (update/delete account, balance/deposit history) and richer order management (modify SL/TP, pending orders).

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables trading on MetaTrader5 platform via MCP, including account management, order placement, market data, technical indicators, and signal tools.
      6
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for operating headless MetaTrader 5 terminals — over SSH, from your agent.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for E*TRADE that reads account balances, positions, transactions, and orders, with optional opt-in order placement via a two-step preview-confirm handshake.
      35 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Universal MCP server that enables AI assistants to control MetaTrader 5 directly, executing trades, managing data, and automating MT5 operations through natural language.
      4
      -