Docs+
MCP overview
The 11 tools, the capability boundary, markets and known limits.
Updated 2026-10-21
usmart-mcp serves uSMART SG OpenAPI users with three groups of capabilities: authorization, order queries and trading. It provides no market data and does not resolve ticker names.
What it does and does not do
| Does | Does not |
|---|---|
| Credential self-check, OAuth, local logout | Quotes, candles, order book, news |
| Pre-trade check: board lot, tradable size, buying power | Ticker-name resolution (you confirm symbol and market) |
| Today's and historical orders, single-order detail | Deposits, withdrawals, password or KYC changes |
| Place, amend, cancel with explicit confirmation | A remote HTTP service (stdio only by default) |
The 11 tools
| Tool | Type | What it does |
|---|---|---|
| check_trade_credentials | Local read | Inspect local credentials and auth state, masked |
| clear_trade_session | Safe op | Drop the in-process token cache |
| oauth_login | Safe op | Start OAuth2 and return the authorization URL |
| oauth_login_status | Safe op | Poll or wait for the result, then store the session |
| oauth_logout | Safe op | Delete the local authorization session |
| preview_order | Upstream read | Board lot, max buy/sell size, buying power |
| list_today_orders | Upstream read | Today's orders and fill status |
| list_all_orders | Upstream read | Historical orders across date ranges |
| get_order_detail | Upstream read | Single order detail |
| place_order | Write | Submit a real order; requires confirmed=true |
| modify_order | Write | Amend or cancel; requires confirmed=true |
Markets and region
- Tradable: HK (0), US (5), Shanghai Connect (6), Shenzhen Connect (7)
- Query only: A-shares (67)
- Region: SG accounts only — the HK protocol is not wired up yet
Transport and deployment
- stdio by default, launched by the MCP client; credentials stay local
- Optional Streamable HTTP for containers and gateways; it carries no MCP-level auth, so it must sit behind an authenticating reverse proxy
- Health check: GET /healthz — status, name, version and transport only
Stuck?
Send us a screenshot and your client version and we will take a look.