{"report":"{\"v\":1,\"package\":\"@backtest-kit/mcp\",\"version\":\"23.7.0\",\"ranAt\":\"2026-11-16T11:44:43.142Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-HEx3R/zNBH4uvq8CvTjjjWR/10uaItl8oDyDoV1xhbpE3e1cwKVifQhYcZePoKOr8K6N3kvyScK7tAM+67eEAA==\",\"deps\":123,\"scripts\":[],\"bins\":[\"backtest-kit-mcp\"],\"license\":\"MIT\",\"repository\":\"https://github.com/tripolskypetr/backtest-kit\",\"bin\":\"backtest-kit-mcp\"},\"start\":{\"ok\":true,\"ms\":238,\"serverName\":\"trading-signals-mcp\",\"serverVersion\":\"1.0.0\",\"protocol\":\"2025-06-18\"},\"tools\":[{\"name\":\"get_status\",\"description\":\"Read the trading portfolio. The only read path: every other tool writes.\\nPAPER TRADING ONLY: virtual capital, real market prices. No exchange account, no real order, no real money at risk. Fees and slippage are real, so results are meaningful — the balance is not.\\nDO NOT CALL MORE OFTEN THAN ONCE PER 90 SECONDS. The engine applies queued commands once a minute; calling sooner returns the same snapshot, because the tick that would change it has not run. After issuing a command wait 90s before checking — one tick plus margin. Tight polling wastes context and invites the false conclusion that a command failed, followed by a resubmission that duplicates it.\\nRETURNS: a header summarising open position count, total invested and total unrealized PnL in USD (dollars lead — entry prices differ, so percents are not comparable across positions); then one message per traded symbol.\\nA symbol holding a position reports effective entry price (averaged over DCA entries, each listed separately), current price, unrealized PnL in USD and percent, peak profit and max drawdown with minutes since each, open time and its age, remaining hold time, invested balance, signal id, and the description it was opened with. A flat symbol states plainly that no capital is invested.\\nEach symbol also shows two queue slots: the entry order waiting to open and the close order waiting to execute. Empty slots are stated explicitly, so nothing has to be guessed. A queued close carries BOTH the entry and the exit description.\\nSIGNAL ID ties a trade together across the active position, every event about it and its history row — follow that, not the symbol, which repeats over time.\\nNO TAKE-PROFIT EXISTS: positions never close themselves on profit, which is why no TP/SL levels appear. The engine holds only a distant emergency stop and a hold timeout. Every real exit is yours via close_position.\\nCall before every decision: before opening (is the symbol free), before closing (PnL and behaviour), and after any command (did it land).\",\"params\":[]},{\"name\":\"open_position\",\"description\":\"Open a PAPER trading position at market price. One position per symbol.\\nPAPER TRADING ONLY: virtual capital, real market prices. No exchange account, no real order, nothing here loses real money. Trade it as seriously as the real thing anyway — the deliverable is an honest record, and a sloppy paper trade produces a worthless one.\\nYOU CONTROL: symbol, direction (long or short), and the description explaining why. Nothing else. The engine computes the entry cost and sets a distant emergency stop that only caps a catastrophic loss. You cannot size the position, pick an entry price or set your own stop — reasoning about those levels is wasted effort.\\nNO WORKING TAKE-PROFIT EXISTS. The position never closes itself on profit. Left alone it dies at the emergency stop or the hold timeout — both bad outcomes. Every real exit is a deliberate close_position call.\\nTHE DESCRIPTION IS THE MEMORY OF THE TRADE, not a label. It is the only record of why this position exists, and it returns to you later — in get_status while open, and in the event log after it closes. A future call with no memory of this moment reads it to decide whether to hold, average or exit. Write for that reader: the setup, the evidence, the levels watched, and what would prove the idea wrong. Markdown renders. A one-liner leaves nothing to reason from; an undescribed trade is invisible in the event log entirely.\\nTIMING: the order is queued, not filled instantly. The engine drains the queue once a minute, so the position appears in get_status on the next pass. Until then it sits under 'Entry queue' and both notify_user and average_position will refuse it. Do NOT resubmit — you risk a duplicate once the queue drains.\\nAFTER IT OPENS: confirm via get_status, note the signal id, and use notify_user for anything the entry description could not yet know.\\nFails if the symbol is not enabled for trading, or already holds a position or a queued order. Symbols are independent — several can be opened in the same minute.\",\"params\":[\"symbol\",\"position\",\"description\"]},{\"name\":\"close_position\",\"description\":\"Close the active PAPER position of a symbol at market price.\\nPAPER TRADING ONLY: virtual capital, real market prices. No exchange account, no real order; the realized result is recorded, not paid out.\\nTHIS IS THE ONLY REAL EXIT. Nothing else takes profit or cuts a loss on purpose — the position has no working take-profit, and the only automatic ends are the distant emergency stop and the hold timeout, both meaning the trade got away from you. Deciding when to call this IS the job.\\nYOU CONTROL: the symbol and the description. The engine resolves which position closes and executes at market price. No partial close, no exit price to name.\\nTHE DESCRIPTION IS THE EXIT REASON, STORED SEPARATELY FROM THE ENTRY REASON. The event log shows this trade twice: once as opened, carrying the entry description, and once as this close request, carrying what you write here. Write nothing meaningful and the log shows a trade opened for a stated reason and closed for none — which reads later as an idea still worth trying. That is exactly how the same losing trade gets re-entered. State what happened to the thesis, how price actually behaved, and what made you exit NOW rather than earlier or later. Markdown renders.\\nTIMING: the close is queued, not immediate. The engine drains the queue once a minute, so the position stays visible in get_status until the next pass, showing a 'Close queue' slot with both descriptions. Do NOT resubmit during that window.\\nAFTER IT EXECUTES the trade moves to the history with its realized result, close reason and holding time, and the symbol becomes free again.\\nFails if the symbol is not enabled for trading, or has no active position — including when its entry order is still queued. Symbols are independent; several can be closed in the same minute.\",\"params\":[\"symbol\",\"description\"]},{\"name\":\"average_position\",\"description\":\"Add a DCA (dollar-cost averaging) entry to the active PAPER position of a symbol at market price.\\nPAPER TRADING ONLY: virtual capital, real market prices. No exchange account, no real order.\\nWHAT IT DOES: invests the configured entry cost again into the same position, same direction. The effective entry becomes the cost-weighted average of all entries, so the position needs a smaller move to recover — while the money at risk grows by the same amount. get_status then lists every entry separately alongside the new average and raised balance.\\nYOU CONTROL: only the symbol. The engine picks the position, price and amount — no size to choose, no limit price.\\nWHEN IT IS RIGHT: price moved against a thesis you still believe in, and the reason for believing it still holds. Averaging a broken thesis does not rescue the trade, it doubles the loss — and with no working take-profit, a bigger position just means more capital stuck awaiting an exit you must still call yourself. If the reason is gone, close_position is the correct tool.\\nTHIS COMMAND CARRIES NO DESCRIPTION, so the DCA event inherits the description the position was OPENED with, explaining nothing about why you averaged. Call notify_user right after: where price sits relative to the original entry, why the thesis survives, and what would stop you averaging again.\\nREQUIRES AN ALREADY-ACTIVE POSITION. An entry order still in the queue cannot be averaged into. Confirm via get_status first.\\nTIMING: queued, drains on the engine's once-per-minute pass, so the new average appears on the following pass. An unchanged average right after the call is expected — do NOT resubmit, or the position takes two extra entries instead of one.\\nFails if the symbol is not enabled for trading or has no active position. May also be refused when the schema does not grant the averaging permission — that refusal is final; retrying cannot change it.\",\"params\":[\"symbol\"]},{\"name\":\"notify_user\",\"description\":\"Attach a note to the active PAPER position of a symbol. Changes nothing about the trade — it only records reasoning.\\nWHY IT EXISTS: open_position records why a trade started, close_position why it ended. Everything in between — price behaved unexpectedly, the thesis shifted, a level was reached, an averaging needs justifying — has no other place to live. Without notes a later call sees an open position, a number, and no idea what it was meant to be doing.\\nWRITE FOR A READER WITH NO MEMORY. Later calls recall nothing of this moment; they read exactly what is stored. State what is observed NOW, how it changes or confirms the original thesis, and which levels decide the exit from here. Markdown renders.\\nUSE IT AFTER AVERAGING: average_position takes no description of its own, so the DCA event inherits the entry text and explains nothing about why the position was doubled. A note right after is the only record of that reasoning.\\nREQUIRES AN ALREADY-ACTIVE POSITION. An entry order still in the queue cannot hold a note. Confirm via get_status first.\\nTIMING: queued like every command, drains on the engine's once-per-minute pass, surfacing on the following pass. Do NOT resubmit while waiting — a duplicated note buries the rest of the history under repetition.\\nNotes follow the signal id, so symbols are annotated independently and a note never leaks onto another trade.\\nFails if the symbol is not enabled for trading, or has no active position.\",\"params\":[\"symbol\",\"description\"]}],\"toolsHash\":\"ea0fe608f87f8d058d988aa59d9739c3f6a795b4e52991a0d59b5dbae301441b\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:44:50.807Z\",\"calls\":[{\"tool\":\"get_status\",\"ok\":false,\"ms\":11,\"bytes\":0,\"error\":\"tool reported an error: Failed to fetch status: fetch failed\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmUyZDM3Y2U5NTZkM2FiYTM1OGY1Y2FlYWUzMDBhM2U4ZWQ5MTVlOGY4ZWIxMjExYmQ4NmE3NTMwMzQ1YzY2YmQiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTk0NSIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTc5NywiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk0OTcsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiNjY3YjhhZjItZTE2ZS00NGYwLTlmZjEtZDQwYjQ4ZTkxZWQ4IiwibmJmIjoxNzk0ODI5MTk3LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.rtpFYHLF9nV2R6SYCkd88GECg1KnJBvMjwmfbx_e1bTJwr2YaumTuOYqLhYHiTgo4LGipR5TVpsm9-xcBjetBdri86y4YOzX89AmFxBGpzGq9YpwQ7-Ks3yKiH_MtDw_F2KRAeL8ah3PNxRYajKerZCuokmgutTOBPFcyzkVIPzVdNTwhAJe2oRCzdXAcVtcGRGitCLj9wOkkqq9SjULCmQiRqVtYM5s26TiQLxt0NOBSgvEgXGQ9Yv1nONs4nxj2QZfbNp21MCcRb_hkTWQAwNLkKO8Vd__fxTo42YJ9Wjc4ZhMcd8rLGurFvx34IxpTz72d6-cO-4b1OMjLkegoQ"}