TradeZylo MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TRADEZYLO_TOKEN | Yes | Your TradeZylo MCP API key/token, starts with tzm_ | |
| TRADEZYLO_API_URL | Yes | The URL of the TradeZylo Fastify backend, e.g. http://localhost:3001 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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:
|
| 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:
|
| get_trade_screenshotsA | Get all chart screenshot URLs and image attachments attached to a specific trade. Example questions:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| add_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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| get_active_accountA | Get details of the currently active/selected trading account in TradeZylo (balance, equity, win rate, PnL, broker). Example questions:
|
| switch_accountA | Switch the active trading account in TradeZylo by name or ID. Activates this account for future trades and overview analytics. Example questions:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| pre_market_routine | Morning preparation routine to check daily risk limits, verify open positions, and review today's playbook setups before the trading session starts. |
| post_session_review | End-of-day reflection to review closed trades, score checklist discipline, audit execution mistakes, and draft a structured daily journal entry. |
| psychology_deep_dive | Deep-dive analysis into emotional trading leaks, recurring execution mistakes, and tilt triggers to protect capital and improve discipline. |
| strategy_playbook_audit | Analyze edge, win rate, expectancy, and holding efficiency (MAE/MFE) for your playbook strategies to optimize entry/exit rules. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.