etrink-mcp
Officialetrink-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-mcpCreate 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 |
| Your etrink API key (required) |
| Path to a |
| API base URL, default |
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_signalsMT5 (write — the agent must dry-run with
test: trueand get the user's confirmation):place_order,open_accountService 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.mjsLicense: MIT
Available Tools
23 toolscreate_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
Scored across 23 tools
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).
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.
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.
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
Related MCP Connectors
Hosted MCP server for MT4 and MT5: read accounts, prices and candles, and place or close orders.
Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables trading on MetaTrader5 platform via MCP, including account management, order placement, market data, technical indicators, and signal tools.6-
- AlicenseNot gradedqualityDmaintenanceAn MCP server for operating headless MetaTrader 5 terminals — over SSH, from your agent.MIT
- AlicenseNot gradedqualityBmaintenanceMCP 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 npm1MIT
- FlicenseNot gradedqualityDmaintenanceUniversal MCP server that enables AI assistants to control MetaTrader 5 directly, executing trades, managing data, and automating MT5 operations through natural language.4-