MT-MCP Docs
Tool Reference

Journal

2 tools — auto-generated from the MCP server's tool schemas.

Generated

This page is generated from packages/server/mcp/src/tools/*.ts by pnpm docs:generate-tools. Do not edit it by hand — edit the tool's description/schema in source and regenerate.

query_journal

Queries trade journal entries, newest first. Filters: ticket, tag, setup, from_date/to_date (ISO), and search (case-insensitive text match). Entries linked to closed trades include realized_pnl when the terminal is connected (null otherwise). Available at Free+ tier.

Parameters

NameTypeRequiredDefaultDescription
ticketintegerNo
tagstringNo
setupstringNo
from_datestringNoISO date
to_datestringNoISO date
searchstringNo
limitintegerNo20
offsetintegerNo0
terminal_idstringNo

write_trade_note

Persists a trade journal entry: rationale, setup label, and tags, optionally linked to a position/order ticket. Entries are append-only and immutable — to correct one, write a new note with amends_entry_id pointing at the original. Use at order time to capture WHY a trade was taken; query later with query_journal for post-trade review and per-setup statistics. Free tier stores up to 100 entries. Available at Free+ tier.

Parameters

NameTypeRequiredDefaultDescription
textstringYes
ticketintegerNo
tagsarrayNo[]
setupstringNo
amends_entry_idstringNo
terminal_idstringNo

On this page