TradeZylo MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TradeZylo MCP Server Show my last 20 FOREX trades with PnL"
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.
TradeZylo MCP Server
Give Claude / Cursor / Antigravity IDE full intelligence, analytics, and journal action access to your TradeZylo trading data.
38 Tools — 7 Domains (Reads, Writes & Structural Actions)
Domain | Count | Tools |
Trades | 6 |
|
Analytics | 6 |
|
Psychology | 5 |
|
Risk | 5 |
|
Playbook | 4 |
|
Accounts | 8 |
|
Journal | 4 |
|
Related MCP server: AlgoChains MCP Server
4 AI Workflow Prompts (Slash-Command Routines)
Trigger pre-built institutional trading routines in Claude Desktop or Cursor with 1 click or by typing /:
Prompt | Timing | Purpose |
| Morning | Checks daily risk limits, verifies open swing positions, reviews active playbook setup rules, and runs a 3-point mental readiness check. |
| Evening | Reviews closed trades, calculates win rate & PnL, audits execution mistakes, and drafts a structured journal review to save via |
| Mindset Audit | Deep-dives into emotional leaks ( |
| Weekend / Strategy | Evaluates strategy edge, win rate, and holding efficiency ( |
Quick Start
1. Install dependencies
cd web/mcp
npm install2. Build
npm run build3. Generate your MCP API Key
Go to TradeZylo Dashboard → MCP Server (/mcp) in your sidebar:
Click Generate New Key
Copy your key (starts with
tzm_)You can also copy the ready-to-use JSON config directly from that page!
4. Configure Claude Desktop / Cursor
Add to your claude_desktop_config.json or Cursor MCP settings:
{
"mcpServers": {
"tradezylo": {
"command": "node",
"args": ["d:/SAAS APPS PENDING/TRADEZYLO/web/mcp/dist/index.js"],
"env": {
"TRADEZYLO_API_URL": "http://localhost:3001",
"TRADEZYLO_TOKEN": "PASTE_YOUR_TOKEN_HERE"
}
}
}
}5. Or run in dev mode (tsx, no build needed)
cd web/mcp
TRADEZYLO_API_URL=http://localhost:3001 TRADEZYLO_TOKEN=your_token npm run devExample Conversations with Claude
Once connected, you can ask Claude things like:
"Show me my last 20 FOREX trades with PnL"
"Log my EURUSD trade: entered long at 1.0850, stop 1.0820, target 1.0920, 1 lot"
"Tag 'FOMO' mistake with high impact on trade #102"
"Save morning prep notes: watching CPI release at 8:30am, bias bullish on NAS100"
"Add 'Liquidity Sweep Reversal' strategy to my playbook"
"Update my daily loss limit to $750 and max risk per trade to 1.5%"
"Freeze trading for 24 hours: on tilt after 3 consecutive losses"
"Create a new trading account 'FTMO $100k Phase 1' with $100,000 initial balance"
"What's my win rate this month and fee leakage across brokers?"
"Am I close to my daily loss limit today?"
Architecture
Claude / Cursor / Antigravity IDE
↓ stdio (MCP Protocol)
TradeZylo MCP Server (web/mcp)
↓ HTTP + Bearer JWT
TradeZylo Fastify Backend (:3001)
↓ Prisma ORM
PostgreSQL DatabaseSecurity & Integrity Notes
Zero Real Broker Risk: TradeZylo is an analytics and journaling platform. MCP write tools mutate your TradeZylo journal database only; they cannot touch exchange accounts or live broker funds.
Full Populated Records: All write tools return complete, populated records rather than simple acknowledgments.
Audit Logging: Every write action (
log_trade,update_trade,close_trade,add_mistake,save_daily_review,add_strategy,update_limits,freeze_trading,create_account) is appended tologs/mcp-audit.logwith timestamp and payload details.Token Stays Local: Your JWT/API key is stored only in your local environment variables and is never transmitted to third parties.
Local stdio: The server runs strictly via local stdio communication rather than exposing an open network port.
Available Tools
38 toolsadd_mistakeA
[WRITE ACTION] Tag one or more execution discipline mistakes on a trade (e.g. FOMO, Overleveraging, Revenge Trading, Moved Stop Loss, Exited Early, Chasing). Appends to existing mistakes and optionally updates lesson learned. Returns full updated trade record.
Example questions:
"Tag mistake FOMO and Revenge Trading on trade <trade_id>"
"I revenge traded on my last gold trade, tag Revenge Trading with lesson: stop trading after 2 losses"
"Tag Overleveraging on trade <trade_id>"
Inputs: mistake (required), notes, trade_id, instrument, +2 more.
add_strategyA
[WRITE ACTION] Add a new trading setup or strategy to your TradeZylo Playbook with rules, description, timeframes, and markets. Returns full created strategy and updated playbook catalog.
Example questions:
"Add a new playbook strategy: 'ICT Silver Bullet', 15m timeframe on Forex, rules: enter on FVG between 10am-11am NY time"
"Save a strategy to my playbook named 'London Breakout Retest'"
"Add strategy 'Opening Range Breakout' for Stocks on 5m"
Inputs: desc (required), name (required), r, wins, +6 more.
close_tradeA
[WRITE ACTION] Close an open trade in TradeZylo journal by recording the exit price. Backend automatically calculates realized PnL ($ and %), actual R:R multiple, and updates account balance. Returns full updated trade record and refreshed account balance.
Example questions:
"Close my open EUR/USD trade at 1.0890"
"Close trade <trade_id> at exit price 65200"
"I just exited my gold long at 2365, mark it closed with notes: hit target cleanly"
Inputs: exit_price (required), mistakes, trade_id, exit_time, +4 more.
create_accountA
[WRITE ACTION] Create a new trading account in TradeZylo (e.g. funded challenge, personal live broker, demo account) with starting balance, broker name, and market type. Returns the full created account record.
Example questions:
"Create a new trading account named 'FTMO $100k Phase 1', broker FTMO, market FOREX, starting balance 100000"
"Add an account for Binance Futures with $5,000 initial balance"
"Create account 'Apex 50k' on FUTURES with $50000 balance and set it active"
Inputs: name (required), market_type (required), initial_balance (required), currency, +2 more.
freeze_tradingA
[WRITE ACTION] Activate a psychological disciplinary trading freeze / cooldown in TradeZylo to prevent tilt and revenge trading. Locks daily allowed trades to 0 in risk limits, optionally deactivates target trading account, and logs a disciplinary cooldown reflection in your journal. Returns full freeze status.
Example questions:
"Freeze trading for 24 hours: on tilt after 3 consecutive losses"
"I breached my daily limit, freeze trading for today to prevent revenge trades"
"Activate a 12 hour trading cooldown on account FTMO"
Inputs: reason (required), account, lock_account, duration_hours.
get_account_comparisonA
Side-by-side performance comparison of all accounts: compare win rate, PnL, closed trades, profit factor, and return % between different accounts (e.g. Prop firm vs Live cash).
Example questions:
"Compare the performance between my FTMO account and my personal account"
"Which of my trading accounts has a higher win rate and profit factor?"
"Give me a side-by-side comparison of all my accounts"
Inputs: no named parameters.
get_accountsA
List all linked trading accounts in TradeZylo: name, broker, market type, current balance, initial balance, total PnL, win rate, profit factor, active status. Can filter for a specific account.
Example questions:
"List all my trading accounts with their balances"
"Show my FTMO and personal broker account details"
"What accounts do I have configured?"
Inputs: account.
get_active_accountA
Get details of the currently active/selected trading account in TradeZylo (balance, equity, win rate, PnL, broker).
Example questions:
"Which trading account is currently active?"
"Show balance and stats of my currently selected account"
"Am I currently using my funded or personal account?"
Inputs: no named parameters.
get_ai_insightsA
[AUTOMATED PATTERN OBSERVATIONS & COACHING] Get algorithmic and AI-detected pattern observations from TradeZylo: behavioral tendencies, session leaks, holding duration correlations, and automated recommendations.
Best for: Automated coach observations, hidden leak detection, and high-level behavioral habits. NOT for: Specific raw numbers like buy vs sell (use get_edge_by_direction) or market breakdown (use get_edge_by_market).
Example questions:
"What automated insights does TradeZylo have about my trading habits?"
"What are my top trading weaknesses based on AI analysis?"
"What hidden leaks or bad habits are hurting my profitability?"
"Give me AI coaching suggestions for my trading"
Inputs: account, date_to, date_from, account_id, +1 more.
get_checklist_scoreA
Evaluate pre-trade checklist discipline versus trade outcome. Compares win rate and PnL when the checklist was completed vs when it was skipped.
Example questions:
"Does following my pre-trade checklist actually improve my win rate?"
"What is my performance when I skip the checklist?"
"Show my checklist discipline score"
"What is my checklist adherence rate?"
Inputs: account, date_to, date_from.
get_daily_notesA
Fetch the overall daily journal note written in TradeZylo for a specific date (overall daily reflections, pre-market prep, mindset observations).
Example questions:
"What did I write in my daily journal for today?"
"Show my daily reflection notes for 2026-08-21"
"What were my morning thoughts on yesterday's journal?"
Inputs: date (required).
get_drawdown_statsA
Calculate equity peak and drawdown statistics for accounts: peak equity, current drawdown in dollars and percent from peak, all-time max drawdown, and recovery status. Can filter for a specific account.
Example questions:
"What is my current drawdown from peak equity on my accounts?"
"How much drawdown do I have on my FTMO account?"
"What was the maximum drawdown ever recorded on account 01?"
"Am I close to max drawdown?"
Inputs: account.
get_edge_by_directionA
[DIRECTIONAL BIAS: LONG VS SHORT ONLY] Compare LONG (Buy) trade performance versus SHORT (Sell) trade performance: win rate, average PnL, profit factor, and total count for each direction. Detects if you have a directional bias problem.
Best for: Comparing buys vs sells, longs vs shorts, or diagnosing directional asymmetry. NOT for: Comparing asset classes (use get_edge_by_market instead!).
Example questions:
"Are my long trades performing better than my short trades?"
"Meri long trades short se better perform kar rahi hain kya?"
"Do I have a directional bias or weakness on shorts?"
"Compare my buy vs sell win rate and profit factor"
"Am I losing money on short positions?"
Inputs: account, date_to, date_from, account_id, +1 more.
get_edge_by_marketA
[ASSET CLASS & MARKET EDGE] Compare trading edge and profitability broken down by market type: Forex vs Crypto vs Stocks vs Futures vs PSX. Returns win rate, average PnL, profit factor, and trade count per asset class.
Best for: Evaluating which market/asset class is most profitable. NOT for: Long vs Short trade direction (use get_edge_by_direction instead!).
Example questions:
"Which market is my most profitable — Forex, Crypto, or Stocks?"
"Meri crypto trades forex se behtar hain ya buri?"
"Where do I have the strongest trading edge across different markets?"
"Should I stop trading crypto and focus only on forex?"
"Show my win rate and profit factor by asset class"
Inputs: account, date_to, date_from, account_id, +1 more.
get_emotion_pnlA
Analyse how emotional states (Fear, FOMO, Confident, Greedy, Calm, Anxious, Impatient) impact PnL and win rate. Groups trades by entry emotion to show average PnL and win rate per mindset.
Example questions:
"How do my emotions affect my trading results?"
"Which emotion costs me the most money?"
"What is my win rate when I feel FOMO vs Calm?"
"Show my emotion PnL breakdown for this month"
Inputs: account, date_to, date_from.
get_fee_leakageA
[FEE & DRAG AUDIT] Audit total trading cost leakage: commissions, overnight swap fees, slippage, and spread paid across all trades. Broken down by instrument and market type.
Best for: Identifying fee drag, broker costs, swap penalties, and spread leakage.
Example questions:
"How much money am I losing to broker commissions and swap fees?"
"Which instrument has the highest fee leakage?"
"Is swap fee eating into my swing trading profits?"
"Show total fees and commission paid this month"
Inputs: account, date_to, date_from, account_id, +1 more.
get_mae_mfe_statsA
[TRADE EXCURSION & EXIT TIMING] Analyse Maximum Adverse Excursion (drawdown while trade was active) and Maximum Favorable Excursion (peak unrealized profit before exit). Shows whether you leave money on the table (exiting too early) or let drawdowns run too deep.
Best for: Questions about trade management, holding duration, cutting winners early, or exit efficiency. NOT for: Long vs Short comparison (use get_edge_by_direction) or high-level win rate (use get_overview_stats).
Example questions:
"Am I holding winners long enough or leaving profit on the table?"
"Do I cut my winning trades too early?"
"How far do my trades move against me before turning profitable?"
"Walk me through my MAE and MFE trade excursion stats"
Inputs: account, date_to, date_from, account_id, +1 more.
get_mistake_auditA
Audit recurring execution mistakes (e.g. Overleveraging, FOMO, Revenge Trading, Moving Stop Loss, Chasing, Early Exit). Aggregates tags to calculate frequency, total financial damage, and win rate when mistakes occur.
Example questions:
"What are my most frequent and expensive trading mistakes?"
"How much has revenge trading or overleveraging cost me?"
"Audit my trading discipline mistakes on my FTMO account"
"Show mistake audit for the last 30 days"
Inputs: account, date_to, date_from.
get_overview_statsA
[EXECUTIVE KPI SUMMARY] Get high-level trading performance KPIs: overall win rate, total PnL, profit factor, average win vs average loss, expectancy, max drawdown, best/worst trading day, and streak metrics.
Best for: High-level overview or summary scorecard. NOT for: Direction comparison (use get_edge_by_direction), market comparison (use get_edge_by_market), or exit timing (use get_mae_mfe_stats).
Example questions:
"What is my overall win rate and profit factor?"
"How has my trading performed this month?"
"Give me an executive summary of my trading performance"
"What is my overall performance on account FTMO?"
Inputs: account, date_to, date_from, account_id, +1 more.
get_planned_rrA
Compare planned Risk-to-Reward ratio against actual realized R:R achieved. Evaluates target execution, whether you cut winners early, and the statistical distribution of R-multiples.
Example questions:
"Am I achieving my planned R:R target or cutting winners early?"
"What is my average planned RR vs actual RR?"
"What percentage of trades hit their full 2R or 3R target?"
"Show my planned vs realized RR stats"
Inputs: account, date_to, date_from.
get_playbookA
Fetch all saved playbook setups and trading strategies: names, setup descriptions, allowed timeframes, markets, manual win/loss record, and average R-multiple.
Example questions:
"List all my playbook trading setups and strategies"
"What strategies do I have saved in my playbook?"
"Show my saved setups and timeframes"
Inputs: no named parameters.
get_playbook_rulesA
Get the detailed written rules and execution guidelines for a specific playbook strategy by name (entry criteria, stop-loss rules, management rules, exit conditions).
Example questions:
"What are the exact entry and exit rules for my Breakout strategy?"
"Show the rules for strategy "
"What is the entry checklist for my ICT Silver Bullet setup?"
Inputs: strategy_name (required).
get_risk_checkA
[READ-ONLY] Check current real-time risk exposure against daily, weekly, and monthly loss limits. Calculates current loss vs allowed cap, percentage used, and warning status (OK, CAUTION, WARNING, BREACHED). Can filter by specific trading account.
Example questions:
"Am I close to hitting my daily or weekly loss limit?"
"Have I breached any risk rules today?"
"Check my real-time risk exposure before I take another trade"
"Check risk on my FTMO account"
Inputs: date, account.
get_risk_limitsA
[READ-ONLY] Fetch the configured risk management rules and loss thresholds for the TradeZylo account: daily loss cap, weekly loss cap, monthly loss cap, max drawdown %, max position size, max positions per day, max leverage, and max risk per trade %.
Example questions:
"What are my configured risk limits in TradeZylo?"
"What is my daily stop loss cap and max position size?"
"Show my risk management rules"
Inputs: no named parameters.
get_strategy_statsA
Cross-reference playbook strategies with actual trade data. For each setup tag/strategy in your trades, returns real win rate, average PnL, profit factor, total trades, and average actual RR in live execution.
Example questions:
"Which playbook strategy is performing best in live trading?"
"What is the real win rate of my Breakout or ICT strategy?"
"Compare live performance across all my strategies"
"Show win rate by strategy"
Inputs: date_to, date_from.
get_trade_calendarA
Get the trading calendar heatmap data for a given month or year. Returns per-day metrics: realized PnL, number of trades, win rate, and R-multiple.
Example questions:
"Show my trading calendar for this month"
"Which days this month were green vs red?"
"What was my PnL on each day last week?"
"Show my best and worst trading days in August"
Inputs: year (required), month (required).
get_trade_detailA
Get complete, deep details of a single trade by ID, including pre-trade notes, trade management commentary, post-trade review, lessons learned, emotions, checklist, MAE/MFE, and risk metrics.
Example questions:
"Walk me through my worst trade"
"Show all notes, management, and lessons from trade <trade_id>"
"Why did I exit that big losing gold trade?"
Inputs: trade_id (required).
get_tradesA
Fetch a paginated, filterable list of trades from TradeZylo with PnL, direction, instrument, setup tags, emotions, and notes. Supports filtering by account name or ID.
Example questions:
"Show me my last 10 trades"
"What trades did I take on EUR/USD this week?"
"List my losing trades on crypto"
"Show trades for my FTMO account"
Inputs: page, limit, search, sortBy, +8 more.
get_trade_screenshotsA
Get all chart screenshot URLs and image attachments attached to a specific trade.
Example questions:
"Show the chart screenshots for trade <trade_id>"
"Do I have any before/after chart images for this trade?"
Inputs: trade_id (required).
log_tradeA
[WRITE ACTION] Log a new trade entry into your TradeZylo journal with complete trade parameters. If account is omitted, automatically uses your currently active trading account. Returns the full populated trade record.
Example questions:
"Log a new LONG trade on EUR/USD: entry 1.0850, size 1 lot, SL 1.0820, TP 1.0910"
"Log a short trade on BTC at 64500 with 0.5 quantity"
"Record a trade on FTMO: buy XAUUSD at 2350, stop 2340, target 2370"
Inputs: quantity (required), direction (required), instrument (required), entry_price (required), +13 more.
pause_accountA
[WRITE ACTION] Pause / deactivate a specific trading account in TradeZylo to temporarily disable logging trades or running active risk checks on it (e.g. taking a break, challenge passed, drawdown caution). Returns the updated account record.
Example questions:
"Pause my FTMO Challenge account"
"Pause account Binance Futures"
"Deactivate account 01 for a few days"
Inputs: account (required), reason.
resume_accountA
[WRITE ACTION] Resume / reactivate a paused or frozen trading account in TradeZylo. Restores the account to active status, and if risk limits were locked at 0 from a previous freeze, restores daily allowed positions. Returns the updated account record.
Example questions:
"Resume my FTMO Challenge account"
"Reactivate my Binance Futures account"
"Unfreeze my account and let me start trading again"
Inputs: account, restore_daily_limit.
save_daily_reviewA
[WRITE ACTION] Save or append a daily journal review in TradeZylo for a specific date (morning prep, session notes, psychology reflection, lessons learned, and discipline rating). Returns full saved daily journal note.
Example questions:
"Save my daily review for today: morning prep was bullish EUR, session was disciplined, rating 8/10"
"Write a daily journal note for 2026-09-12: waited for NY open, followed all rules"
"Add evening reflection to today's journal note"
Inputs: date, append, content, morning_prep, +4 more.
search_notebookA
Search through your TradeZylo Notebook (saved trading rules, morning routines, psychology lessons, personal notes). Returns matching notes with titles and content.
Example questions:
"Search my notebook for risk management rules"
"Find notes about revenge trading or psychological triggers in my notebook"
"Search my notes for liquidity sweeps"
"What notes do I have about morning prep?"
Inputs: query (required).
switch_accountA
Switch the active trading account in TradeZylo by name or ID. Activates this account for future trades and overview analytics.
Example questions:
"Switch my active account to FTMO 2 Step"
"Activate account 01"
"Change my current trading account to my personal broker"
Inputs: account (required).
unfreeze_tradingA
[WRITE ACTION] Lift a trading freeze / disciplinary cooldown in TradeZylo. Restores max allowed positions per day, reactivates target trading account, and logs a cooldown completion note in your journal. Returns updated risk limits and active status.
Example questions:
"Unfreeze trading, my cooldown is over and I am calm"
"Lift trading freeze and restore daily limit to 5"
"I am ready to trade again, unfreeze my account"
Inputs: account, reflection, restore_daily_limit.
update_limitsA
[WRITE ACTION] Update configured risk management thresholds in TradeZylo (daily loss cap, weekly loss cap, monthly loss cap, max drawdown %, max position size, max positions per day, max leverage, max risk per trade %). Unspecified fields preserve current values. Returns full updated risk limits record.
Example questions:
"Update my daily loss limit to $750 and max risk per trade to 1.5%"
"Change my max positions per day to 4"
"Set weekly loss cap to $2000 and max drawdown to 8%"
Inputs: daily_loss, weekly_loss, max_drawdown, max_leverage, +4 more.
update_tradeA
[WRITE ACTION] Update fields of an existing trade record in TradeZylo: adjust Stop Loss or Take Profit, add post-trade notes, assign lessons learned, update execution rating, or tag mistakes. Returns full updated trade record.
Example questions:
"Update trade <trade_id>: move stop loss to breakeven at 1.0850"
"Add a note to trade <trade_id>: took partial profits at 2R"
"Tag mistake 'Exited Early' on trade <trade_id> and set execution rating to 6"
"Update lesson learned on trade <trade_id>"
Inputs: trade_id (required), notes, mistakes, quantity, +11 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Many analytical tools have clear boundaries, but significant overlap exists among account management and freeze-related tools. pause_account, freeze_trading, and unfreeze_trading operate on similar concepts (deactivating/reactivating), and resume_account overlaps with unfreeze_trading. get_risk_limits vs get_risk_check are distinct, but overall, an agent could easily misselect among the freeze/pause/resume tools.
Most tool names follow a consistent snake_case verb_noun pattern (get_, log_, update_, close_, add_, etc.). Minor inconsistencies include 'close_trade' vs 'log_trade' (different verbs for trade actions) and 'unfreeze_trading' vs 'resume_account' (both reactivation but different naming styles). Overall, the pattern is predictable and readable.
With 38 tools, the server is on the heavy side for an MCP server. While the domain (trading journal and analytics) is broad and each tool appears to have a purpose, the count likely exceeds what an agent can efficiently manage, and some tools (e.g., pause_account vs freeze_trading vs resume_account) seem redundant or could be consolidated.
The tool surface covers a wide range of trading journal operations: trade CRUD, analytics, risk management, account management, playbook strategies, and notebook. Minor gaps include no explicit tool to delete a trade, account, or strategy, and no tool to fetch a single account's full details (only get_accounts with filter). However, most core workflows are well-supported.
Maintenance
Related MCP Connectors
Trading journal, options risk checks, position sizing and Monte Carlo analytics for AI assistants.
AI trading partner and trading journal: trades, reports, journaling, market data.
Day Trade AI signals, analyses, journal and rule checks for your AI agent. Never places trades.
Free crypto-futures paper trading and live market data for AI agents. 31 tools; no key for data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform cryptocurrency trading analysis and execution with 38+ tools including real-time market data, technical indicators, risk management, and support for both paper trading and live execution on Hyperliquid.7MIT

AlgoChains MCP Serverofficial
AlicenseBqualityBmaintenanceEnables AI assistants to interact with a complete trading infrastructure, including live futures bots, real market data, backtesting, and copy-trading signals. Supports 503 tools across 20 domains, from market data to order execution, with zero synthetic data.1681MIT- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access options analysis data, market research tools, portfolio risk snapshots, and platform context via 32 tools.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to connect to a trading journal, analyze performance metrics, identify psychological biases, and receive continuous trading coaching.MIT