Stock Compass
Server Details
Watchlist, signals, trades and journal for HK, US and China A-share stocks. Records only; no orders.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- Stock-Compass/stock-compass-plugin
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 20 tools
Resource groups are cleanly separated: watchlist, trades, alerts, journal, strategies, signals, account. The only close pairs are get_strategy vs get_strategies (singular detail vs list) and get_journal vs get_journal_stats, both of which the descriptions disambiguate clearly.
A predictable verb_noun pattern dominates (get_*, edit_*, delete_*, record_trade, set_stop_target). Minor deviations are the three different creation verbs — add_to_watchlist, create_price_alert, record_trade — which reflect domain semantics rather than sloppiness.
20 tools spread across roughly eight distinct resources (watchlist, trades, alerts, journal, signals, strategies, account, dividends/events) means each tool maps to its own operation rather than being padding. It sits at the upper end of comfortable, but nothing looks redundant.
Watchlist, trades, and price alerts have full create/read/update/delete coverage, but dividends are read-only by design (recording and deleting are pointed to the website/REST API), and there is no tool to create or edit strategies or to look up a stock quote/price. Those are notable dead ends for a stock-tracking server.
Available Tools
20 toolsadd_to_watchlistAdd to watchlistAIdempotentInspect
Adds a stock to the watchlist. The stock has to exist at its market's quote source, and the plan's watchlist limit applies. A stock already on the watchlist is refused, so sending it twice adds it once. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: market (required), ticker (required), preview_id. Returns: name, note, tool, alert, +11 more
create_price_alertCreate a price alertAIdempotentInspect
Creates a price alert that fires when the price goes above or below the threshold. The same alert already set is refused, so sending it twice sets it once. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: market (required), ticker (required), direction (required), threshold (required), +2 more. Returns: id, note, tool, alert, +12 more
delete_price_alertDelete a price alertADestructiveIdempotentInspect
Deletes a price alert, as the alerts list on the page does. The signals it fired stay. The stop and target alerts that follow a holding's plan are refused: clearing the level with set_stop_target removes them. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: id (required), preview_id. Returns: note, tool, alert, error, +8 more
delete_tradeDelete a tradeADestructiveIdempotentInspect
Deletes a trade recorded by mistake, as the trade list on the page does: the cash it moved goes back, the holding is recomputed, and a buy's journal entry goes with it while it is still exactly that buy. A deleted sell does not reopen the journal entries it closed. A buy whose shares a later sell used is refused until that sell is changed. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: id (required), preview_id. Returns: cash, note, tool, alert, +13 more
edit_price_alertChange a price alertADestructiveIdempotentInspect
Changes a price alert's threshold or note, or re-arms one that fired so it watches again, as the alerts list on the page does. A new threshold or a re-arm counts only prices after it. The stop and target alerts that follow a holding's plan can be re-armed; their level changes with set_stop_target. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: id (required), note, rearm, threshold, +1 more. Returns: note, tool, alert, error, +8 more
edit_tradeCorrect a tradeADestructiveIdempotentInspect
Corrects a recorded trade's price, quantity or date, as the trade list on the page does: cash moves by the difference, the holding is recomputed, and the journal entry follows where it still matches. fees is what the broker charged; without it the fees are worked out again from the user's settings. The side and the ticker cannot change: that takes deleting the trade and recording the right one. Refused if a sell would then be of shares not held. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: id (required), fees, price, quantity, +2 more. Returns: cash, fees, note, tool, +14 more
get_accountCashARead-onlyInspect
The cash the user tracks in each market (hk, us, cn), in that market's currency, as the website's asset header shows it. amount is null where cash is not tracked. Recording a trade moves the cash of a market where it is tracked.
Inputs: no named parameters. Returns: cash, error, warnings
get_dividendsDividendsARead-onlyInspect
The dividends the user recorded, newest ex-dividend date first: the stock, ex-dividend and pay dates, the dividend per share, the shares, the amount, and what it added to cash. Recording and deleting dividends is done on the website or through the REST API.
Inputs: to, from, limit, market, +2 more. Returns: error, limit, total, offset, +3 more
get_eventsChange logARead-onlyInspect
The changes made through API keys and connected apps, newest first: what was done (such as trade.record or alert.delete), when, to which stock, through which key or app, and a summary of what changed. Changes made on the website itself are not in it.
Inputs: limit, since, until, action, +2 more. Returns: error, limit, total, events, +3 more
get_journalTrade journalBRead-onlyInspect
The trade journal, newest opened first, as the journal page shows it: each position opened, its price and shares, and once closed the close price and the realized return; what triggered the buy (a strategy signal with its strategy, a price alert, manual, imported, other); the thesis; the stop and target planned at entry and in force now, with the stop changes; the close reason, whether the plan was followed, and the lesson.
Inputs: to, tag, from, limit, +5 more. Returns: error, limit, total, offset, +3 more
get_journal_statsJournal statisticsBRead-onlyInspect
The journal page's figures for one market: closed trades, the total return after fees, the average holding time, and the win rate and average return of trades bought on a strategy signal, on a price alert and manually, with how they compare, all worked out from the user's own records.
Inputs: market (required), from, group_by. Returns: from, error, by_gut, by_tag, +9 more
get_price_alertsPrice alertsBRead-onlyInspect
Price alerts, with whether and when each fired. from_plan marks the stop and target alerts that follow a holding's plan.
Inputs: market. Returns: error, limit, total, alerts, +3 more
get_signalsSignalsARead-onlyInspect
Signals recorded on the watchlist by the strategy that was active in each market on each date, newest first: buy, add, exit, trim; price_alert for the user's own price alerts that fired. Buy and add are recorded once the daily bar is final (after the close); exit and trim during the session. A rule that stays true is recorded again on every bar: each signal says when that run began (active_since) and how many bars of it so far (occurrences). A strategy signal has strategy_id (see get_strategy), the indicator values on that bar and the conditions that matched. Pages of 25 by default: total and next_offset tell whether there is more.
Inputs: to, days, from, limit, +6 more. Returns: to, from, note, error, +6 more
get_strategiesStrategiesARead-onlyInspect
The user's own strategies: id, name, market, and which one is active in each market. A signal's strategy_id is one of these ids.
Inputs: market. Returns: error, limit, total, offset, +3 more
get_strategyStrategy rulesARead-onlyInspect
One strategy's rules: the buy, add, exit and trim conditions as the engine reads them, each with its words as the Strategies page shows them, and the same strategy in the page's Export JSON shape. A deleted strategy is still returned, since its old signals name it.
Inputs: id (required). Returns: error, rules, export, strategy, +1 more
get_tradesTradesARead-onlyInspect
Recorded buys and sells, newest first. fees is what the broker charged, when the user gave it (fees_source provided); otherwise fees is null and estimated_fees is the estimate from the user's own trading-cost settings, as their P&L counts it. executed_at is the time of the trade when it was recorded with one.
Inputs: to, tag, from, limit, +4 more. Returns: error, limit, total, offset, +3 more
get_watchlistWatchlist and holdingsARead-onlyInspect
The watchlist: each stock, whether it is held, the quantity and cost price, the stop and target in force on the open position, and how its exits are watched (exit_mode). A holding also has when it was opened, the stop and target set at entry, and every change of the stop since (stop_history). Pages of 100 by default: total and next_offset tell whether there is more.
Inputs: limit, market, offset, holding. Returns: error, items, limit, total, +3 more
record_tradeRecord a tradeADestructiveInspect
Records a buy or sell the user made, as the trade form on the page does: cash, the holding, the lots and the trade journal move, and fees are what the broker charged when given, otherwise worked out from the user's trading-cost settings. Places no order with any broker. The stock has to be on the watchlist, unless add_to_watchlist is true. A buy without trigger is filed as on a signal when the stock had a buy (for an add: add or buy) signal in the last 14 days, otherwise as manual. A sale to zero closes the journal with close_reason, or "other". A trade dated before trades already recorded in the stock would replay them, so it is refused with out_of_order unless allow_out_of_order is true. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: type (required), price (required), market (required), ticker (required), +16 more. Returns: cash, fees, note, tags, +33 more
remove_from_watchlistRemove from watchlistADestructiveIdempotentInspect
Removes a stock from the watchlist, with its price alerts. A stock still held is refused until its sale is recorded. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: market (required), ticker (required), preview_id. Returns: note, tool, alert, error, +10 more
set_stop_targetSet stop and targetADestructiveIdempotentInspect
Sets the stop and/or target in force on the open position, and how its exits are watched, as the position form on the page does. Sent without preview_id, it changes nothing and returns a preview of the change with a preview_id; sent again with the same arguments and that preview_id, it makes the change.
Inputs: market (required), ticker (required), stop, target, +2 more. Returns: note, stop, tool, alert, +12 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Stock technical signals and signal screening for US, HK and A-shares, your portfolios, earnings.
US/HK markets — 163 tools: quotes, options, orders, fundamentals, screener, IPO, alerts, DCA & grid
Access real-time and historical market data for China A-shares and Hong Kong stocks, along with ne…
Trade setups, market scans and your open positions for crypto and stocks. Drafts trades only.
Related MCP Servers
AlicenseBqualityBmaintenanceUS/HK markets — 110 tools: real-time quotes, options, orders, fundamentals, alerts, DCA & portfolio19316Apache 2.0- FlicenseBqualityDmaintenanceProvides real-time market data for A-shares, Hong Kong, and US stocks using the Tencent Finance API. It enables users to manage stock positions and watchlists through an AI assistant.121-
- FlicenseDqualityDmaintenanceProvides real-time stock data and AI-powered analysis for A-shares, Hong Kong stocks, and US stocks. Features sentiment analysis of financial news, deep research reports, and comprehensive market data through multiple integrated data sources.22177-
- FlicenseNot gradedqualityDmaintenanceProvides comprehensive stock market data across US, Hong Kong, and Chinese markets, combining real-time quotes, historical data, fundamentals, and financial statements from multiple sources including Yahoo Finance, Finnhub, Tushare, and Futu OpenAPI.-
Glama MCP Gateway
Add one secure layer between your agents and this server.