PrecisionBook a discovery call
Menu

Longbridge MCP for AI agents

Agents read Longbridge MCP at once. Changes and sends are held for a person's approval by default.

Book a discovery callBrowse all connectors

About Longbridge MCP

Longbridge MCP lets agents access authorized market data, account information, portfolio data, trading operations, and investment workflows through Longbridge OpenAPI.

What an agent can do in Longbridge MCP

Every Longbridge MCP action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in Longbridge MCP without asking first. 134 actions.

  • Account balanceGet account cash balance and asset summary. Returns balances[]{currency, total_cash, max_finance_amount, remaining_finance_amount, risk_level, margin_call}. Filter by currency (e.g. "USD", "HKD").
  • Ah premiumGet A/H share premium historical K-line data. Returns items[]{timestamp, open, high, low, close} representing the premium percentage over the given period.
  • Ah premium intradayGet A/H share premium intraday time-share data. Returns items[]{timestamp, premium_rate} showing the intraday A/H premium percentage minute by minute.
  • Alert listGet all configured price alerts.
  • AnomalyGet market anomaly alerts (unusual price/volume changes). market: HK/US/CN/SG. symbol: optional, filter to a specific stock. count: results per page (default 50, max 100).
  • Bank cardsList linked withdrawal bank cards for the current account. Returns cards[]{id, bank_name, account_number (masked), currency, status}.
  • Broker holdingGet top broker holding data for a symbol (HK stocks only; sourced from HKEX CCASS participant disclosure).
  • Broker holding dailyGet daily holding history for a specific broker (by broker_id) in a symbol (HK stocks only; sourced from HKEX CCASS participant disclosure).
  • Broker holding detailGet full broker holding detail list for a symbol (HK stocks only; sourced from HKEX CCASS participant disclosure).
  • BrokersGet broker queue (HK stocks only). Map broker IDs to names via participants.
  • Business segmentsGet current-period business segment revenue breakdown for a symbol (name, percent, total, currency)
  • Business segments historyGet historical business segment revenue trends (by period and category).
Show all 134
  • Calc indexesCalculate financial indexes for symbols. Pass symbols, and optionally indexes (e.g. ["PeTtmRatio","PbRatio","LastDone","TurnoverRate"]). When indexes is omitted or empty, defaults to ["LastDone","Chan
  • CandlesticksGet candlestick data (OHLCV). Only symbol is required; period defaults to day, count to 100 (max 1000), forward_adjust to false, trade_sessions to all. period: 1m/5m/15m/30m/60m/day/week/month/year. t
  • Capital distributionGet capital distribution for a symbol. data_available is false for symbols with no capital-flow data (e.g. indices) — the other fields are still present but meaningless zeros in that case.
  • Capital flowGet capital inflow/outflow time series. Returns items[]{timestamp, inflow, outflow, net_flow} for the symbol (same-day data).
  • Cash flowGet cash flow records (deposits, withdrawals, dividends). Returns items[]{transaction_type, amount, currency, balance, created_at, remark}. start_at/end_at in RFC3339.
  • CompanyGet company overview. US accounts querying a .US symbol get a US-specific variant (intro, market_cap, top_rank_tags, sharelist, detail_url). The region is detected from the account automatically.
  • ConsensusGet financial consensus estimates for upcoming periods. US accounts querying a .US symbol get a US-specific variant (ai_summary plus a details[] list per period, instead of items[]). The region is det
  • ConstituentGet the constituents of an index or the asset allocation of an ETF. For an index (e.g. HSI.HK, .DJI.US) returns constituents[]{symbol, name, last_done, change_rate, market_cap, weight}. For an ETF (e.
  • Corp actionGet corporate actions (splits, buybacks, name changes).
  • Dca checkCheck whether given symbols support DCA recurring investment.
  • Dca historyGet execution history records for a DCA plan by plan_id.
  • Dca listList DCA recurring investment plans. Filter by status (Active/Suspended/Finished) or symbol.
  • Dca statsGet DCA investment statistics.
  • DepositsList deposit history for the current account. Returns items[]{id, amount, currency, status, created_at, updated_at}. states: comma-separated (Pending/Finished/Failed). currencies: comma-separated code
  • DepthGet order book depth for a symbol. Up to 10 price levels.
  • DividendGet dividend history for the symbol. US accounts querying a .US symbol get a US-specific variant (e.g. dividend_yield_ttm is a percent value: 0.34 means 0.34%). The region is detected from the account
  • Dividend detailGet detailed dividend distribution scheme.
  • Estimate max purchase quantityEstimate maximum buy/sell quantity for a symbol. Only symbol is required; side (case-insensitive Buy/Sell) defaults to Buy, order_type (case-insensitive) defaults to LO, and price is optional.
  • Exchange rateGet exchange rates for all supported currencies. Returns list[]{from_currency, to_currency, rate, timestamp} covering USD, HKD, CNY, SGD and others.
  • ExecutiveGet company executive and board member information.
  • FilingsGet regulatory filings (8-K, 10-Q, 10-K, etc.). Returns items[]{id, title, type, language, filing_date, url} for the symbol.
  • Finance calendarFinance calendar by category: report (earnings) / dividend / split / ipo / macrodata (CPI, NFP, rates) / closed (holidays). start and end (YYYY-MM-DD) are optional, default today plus 7 days; keep ran
  • Financial reportGet financial reports (income statement, balance sheet, cash flow). kind: IS/BS/CF/ALL. report_type: af (annual), saf (semi-annual), q1/q2/q3, qf (quarterly full).
  • Financial report latestGet the latest financial report summary for a security.
  • Financial report snapshotGet financial report snapshot: report_desc (text summary), fo_revenue/fo_ebit/fo_eps (actual vs forecast with yoy/cmp), fr_* financial ratios (ROE, margins, assets, cash flow). report: qf/saf/af.
  • Financial statementGet financial statements (income statement, balance sheet, or cash flow) for a security. kind: IS/BS/CF/ALL. report: af (annual, default), saf (semi-annual), qf (quarterly full), q1/q2/q3.
  • Forecast epsGet EPS forecast and analyst estimate history.
  • Fund holderGet funds and ETFs that hold a given symbol.
  • Fund positionsGet current fund positions.
  • Grid detailFull detail for one grid order: rule parameters, status, embedded child orders (grid_sub_orders) and lifecycle history (grid_order_history). Supports history_id cursor + limit paging.
  • Grid listList grid trading orders. Filter by symbol or comma-joined status (e.g. "Performing,Suspended"); supports page/limit and sort_by/sort_order.
  • Grid list by idsFetch specific grid orders by their IDs.
  • Grid symbol infoPre-trade grid setup info for a security (takes a symbol, not an order_id): security name, last price, board lot sizes (buy/sell), price-step (bid_size) table, and channel/authorization info (strategy
  • Grid trigger historyTrigger history for one grid order: each triggered child order with price, quantity, executed price/qty, and trigger time. Supports page/limit.
  • History candlesticks by dateGet historical candlestick data by date range. Only symbol is required; period defaults to day (1m/5m/15m/30m/60m/day/week/month/year), forward_adjust to false, trade_sessions to all.
  • History candlesticks by offsetGet historical candlestick data by offset from a reference time. Only symbol is required; period defaults to day (1m/5m/15m/30m/60m/day/week/month/year), count to 100, forward_adjust/forward to false,
  • History executionsGet historical trade executions between dates. Returns executions[]{order_id, symbol, side, quantity, price, trade_done_at}. start_at/end_at in RFC3339.
  • History market temperatureGet historical market temperature time series.
  • History ordersGet historical orders between dates (excludes today). Returns orders[]{order_id, symbol, side, status, quantity, price, submitted_at}. start_at/end_at in RFC3339. US accounts only: us_page, us_limit p
  • Industry peersHierarchical sub-sector tree for an industry group. Accepts BK counter_id from industry_rank (e.g. BK/US/IN00258). Each node shows stock count, daily change, and YTD change.
  • Industry rankIndustry ranking list by market (US/HK/CN/SG) and indicator (0=领涨/1=今日走势/2=人气/3=市值/4=营收/5=营收增长率/6=净利润/7=净利润增长率). sort_type: 0=单级 1=多层. Returns items[]{counter_id(BK/US/IN00258), name, chg, lists[]}. P
  • Industry valuationGet industry valuation comparison for peers.
  • Industry valuation distGet industry PE/PB/PS valuation distribution.
  • Institutional viewsGet monthly institutional rating distribution timeline.
  • Institution ratingGet institution rating summary.
  • Institution rating detailGet detailed historical institution ratings and target price history.
  • Institution rating historyGet institution rating history.
  • Institution rating industry rankGet peers ranked by institution analyst ratings in the same industry. Paginated.
  • IntradayGet intraday minute-by-minute price/volume data. trade_sessions: "intraday" (default, regular hours) or "all" (include pre-market and post-market)
  • Invest relationGet investor relations events and announcements.
  • Ipo calendarShow the IPO calendar.
  • Ipo detailShow IPO detail for a symbol.
  • Ipo listedList recently listed IPO stocks (HK+US).
  • Ipo order detailShow detailed information for a specific IPO order by order_id.
  • Ipo ordersList IPO orders (active+history). Filter by symbol, market, or status.
  • Ipo profit lossShow IPO profit/loss summary and per-stock breakdown. period: all/ytd/1y/3y.
  • Ipo subscriptionsList IPO stocks in subscription/pre-filing stage (HK+US).
  • MacrodataGet historical observations for one macro-economic indicator. Use indicator_code from macrodata_indicators; start_date/end_date accept YYYY-MM-DD. Supports offset/limit pagination.
  • Macrodata indicatorsList macro-economic indicators. Filter by keyword and country (US/CN/HK/EU/JP/SG). Use the returned indicator_code with macrodata. Supports offset/limit pagination.
  • Margin ratioGet margin ratio for a symbol.
  • Market statusGet current market trading status for all markets.
  • Market temperatureGet current market sentiment temperature. market: HK/US/CN/SG.
  • NewsGet latest news articles for a symbol. Returns items[]{id, title, source, publish_time, summary, url, related_symbols[]}.
  • News detailGet one news article's full detail by id (from news/news_search).
  • News searchSearch news articles by keyword. Returns news_list[]{id, title, description, source_name, publish_at (RFC3339), score}. Paginate with score+publish_at_timestamp+id cursors.
  • NowGet current UTC time as an RFC3339 string (e.g. "2025-01-15T08:30:00Z"). Use to determine current date/time before making date-based queries.
  • OperatingGet company operating metrics (HK stocks only).
  • Option chain expiry date listGet option chain expiry dates for a symbol (e.g. AAPL.US). Returns expiry_dates[] as "yyyy-mm-dd" strings. Use with option_chain_info_by_date to get strikes and Greeks.
  • Option chain info by dateGet option chain for an expiry date. Returns strikePrices[]{strike_price, call{symbol, last_done, iv, delta, gamma}, put{symbol, last_done, iv, delta, gamma}}.
  • Option quoteGet option quotes (max 500 symbols). Symbols must be option contract symbols (e.g. "AAPL230317P160000.US"), NOT plain stock symbols — obtain valid ones from option_chain_info_by_date's call.symbol/put
  • Option volumeGet real-time option call/put volume stats for a US stock. Returns {call_volume, put_volume, put_call_ratio, call_oi, put_oi} and top active contracts.
  • Option volume dailyGet daily historical option stats for a US stock. Returns items[]{date, call_volume, put_volume, put_call_vol_ratio, call_oi, put_oi, put_call_oi_ratio}.
  • Order detailGet detailed information about a specific order. To look up such a leg by its own ID instead, pass it as order_id with is_attached=true: the response is then that leg, with charge_detail null.
  • ParticipantsGet HK market participant broker information. Returns participants[]{broker_ids[], name_en, name_cn, name_hk}. Use broker_ids to interpret broker queue data.
  • Profit analysisGet portfolio profit and loss analysis summary. start/end: optional date range in yyyy-mm-dd format. Both must be provided together — passing only one returns empty results.
  • Profit analysis detailGet detailed profit and loss analysis for a specific symbol. start/end: optional date range in yyyy-mm-dd format. Both must be provided together — passing only one returns empty results.
  • Quant runRun a quant indicator script against historical K-line data on the server. Executes the script server-side and returns the computed indicator/plot values as JSON. Periods: 1m, 5m, 15m, 30m, 1h, day, w
  • QuoteGet latest price quotes. Returns per symbol: last_done, prev_close, open, high, low, volume, turnover, change_rate, change_value, trade_status, timestamp.
  • Rank categoriesGet rank tab category configurations for the popularity leaderboard. Pass a second_tags key (e.g. `hot_all-us`) to rank_list.
  • Rank listGet ranked stock list by leaderboard tab key. key: from rank_categories second_tags[].key (e.g. "hot_all-us", "hot_up-hk", "trade_heat-us"). market: inferred from key suffix (-us/-hk) or pass explicit
  • Screener indicatorsGet all available screener indicator keys with units and default value ranges. Technical indicators include a tech_values field showing available options (e.g. macd_day: {category:[goldenfork,deadcros
  • Screener recommend strategiesList platform-preset screener strategies. market: US|HK|CN|SG (default: US). Pass id to screener_search strategy_id to run, or screener_strategy to inspect filter conditions.
  • Screener searchScreen stocks. market: US|HK|CN|SG (Mode B required; Mode A uses strategy's market). Mode A: strategy_id from screener_recommend_strategies — auto-runs saved strategy.
  • Screener strategyInspect a screener strategy's filter conditions before running it. Use screener_search strategy_id to execute the strategy.
  • Screener user strategiesList the current user's saved screener strategies. market: US|HK|CN|SG (default: US). Pass id to screener_search strategy_id to run, or screener_strategy to inspect conditions.
  • Security factsList a security's fact (catalyst) events — anomaly detections, factor readings, data sources and natural-language summaries — filtered by time range and count. Facts are what strategies react to: a si
  • Security listGet security list for a market. Supports market: US, HK, CN, SG. category: "Overnight" (default). page: 1-based page number (default 1). count: records per page (default 50).
  • ShareholderGet institutional shareholders for a symbol.
  • Shareholder detailGet a single shareholder's holding and trade history. Requires object_id from shareholder_top. Note: trading_details[] is empty for institutional (13F) holders — it is only populated for insider/indiv
  • Shareholder topGet Top 20 major shareholders (institutions, individuals, insiders) across reporting periods. Use object_id with shareholder_detail to drill into a holder's full trade history.
  • Sharelist detailGet community sharelist detail by id.
  • Sharelist listList user's own and subscribed community sharelists.
  • Sharelist popularGet popular/trending community sharelists.
  • Short marginGet short margin deposit details for the current account. Returns short positions with margin_amount, margin_rate, interest_rate, symbol, quantity per position.
  • Short positionsGet short interest history (open short positions) for HK or US stocks. Market inferred from symbol suffix. count: 1–100 (default 20). Unified data[]{timestamp(RFC3339), short_shares(open short positio
  • Short tradesGet daily short-sale volume history for HK or US stocks. Market inferred from symbol suffix. last_timestamp: unix seconds (omit for latest). page_size: 1–100 (default 20). US source: FINRA/NASDAQ dail
  • Signal detailGet one signal by ID (from `signals`). Same fields as the list, plus `analysis` — the full strategy analysis: fit scores, valuation scenarios, evidence sources and related fact IDs.
  • SignalsQuery strategy signals — a strategy's take on a security, triggered by a catalyst. Filter by symbol, strategy, catalyst and time range; page with limit/offset. The full strategy analysis is omitted he
  • Statement exportGet a pre-signed download URL for a statement data file (obtained from statement_list).
  • Statement listList available account statements (daily/monthly). Use the id with statement_export to download.
  • Static infoGet static info for securities. Returns per symbol: symbol, name_cn, name_en, exchange (e.g. NASDAQ), type (e.g. US_Stock), lot_size, listed_date, delisted (bool). US accounts only: .BKKT crypto symbo
  • Stock positionsGet current stock positions across all channels. US accounts only: an additional us_asset_overview field {cash_list, stock_list, option_list, crypto_list, cash_buy_power, overnight_buy_power} is inclu
  • Today executionsGet today's trade executions (fills). Returns executions[]{order_id, symbol, side, quantity, price, trade_done_at}. Pass symbol or order_id to filter.
  • Today ordersGet orders placed today. Returns orders[]{order_id, symbol, side, order_type, status, quantity, price, submitted_at, executed_quantity, executed_price, attached_orders[]}, where attached_orders[] hold
  • TopicGet discussion topics for a symbol. Returns items[]{id, title, author, created_at, like_count, comment_count, content_summary}.
  • Topic detailGet discussion topic detail by topic_id.
  • Topic repliesGet replies to a discussion topic, paginated (page default 1, size default 20, range 1-50)
  • Topic searchSearch community topics/posts by keyword. Returns id, author, time, and excerpt.
  • Top moversGet stocks whose price fluctuation exceeds the 20-trading-day standard deviation, with correlated news reasons. markets: comma-separated HK/US/CN/SG (omit=all). sort: 0=time 1=change-magnitude 2=popul
  • TradesGet recent trades (max 1000). Returns trades[]{price, volume, timestamp, trade_type, direction} for the symbol.
  • Trade statsGet trade statistics (buy/sell/neutral volume distribution). Returns items[]{price_range, buy_volume, sell_volume, neutral_volume} for price-volume profile.
  • Trading daysGet trading days for a market between dates. market: HK/US/CN/SG.
  • Trading sessionGet trading session schedule for all markets. Returns market_sessions[]{market, trade_sessions[]{beg_time, end_time, trade_session_type}}.
  • ValuationGet valuation overview with peer comparison. US accounts querying a .US symbol get a US-specific variant (ai_summary plus a metrics.pe object with different sub-fields). The region is detected from th
  • Valuation comparisonStock valuation comparison. Mode A (single): pass only symbol — server returns stock + auto-selected industry peers.
  • Valuation historyGet detailed valuation history time series.
  • Valuation rankGet daily valuation rank (PE/PB/PS/dividend yield industry percentile) for a security over a date range. start/end in yyyymmdd format.
  • Warrant issuersGet HK warrant issuer information. Returns issuers[]{id, name_en, name_cn}. Use id in warrant_list issuer filter.
  • Warrant listGet filtered warrant list for an underlying symbol. Returns warrants[]{symbol, name, last_done, change_rate, implied_volatility, expiry_date, strike_price, leverage_ratio, outstanding_ratio}.
  • Warrant quoteGet warrant quotes. Returns last_done, prev_close, open, high, low, volume, turnover, implied_volatility, delta, leverage_ratio, effective_leverage per symbol.
  • WatchlistGet all watchlist groups and their securities. Returns groups[]{id, name, securities[]{symbol, market, name, watched_price, watched_at}}.
  • WithdrawalsList withdrawal history for the current account. Returns items[]{id, amount, currency, status, created_at, bank_name, account_number (masked)}.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 27 actions.

  • Alert addAdd a price alert. condition: price_rise/price_fall (absolute price) or percent_rise/percent_fall (relative %). frequency: once/daily/every. Returns created alert object.
  • Alert deleteDelete a price alert by alert_id (numeric string from alert_list). Returns upstream API response on success; errors if alert_id is invalid.
  • Alert disableDisable a price alert by alert_id. Use alert_list to find the numeric alert_id.
  • Alert enableEnable a price alert by alert_id. Use alert_list to find the numeric alert_id.
  • Cancel orderCancel an open order by order_id. Returns plain text "order cancelled" on success; errors if the order is already filled or cancelled. TWO-STEP CONFIRMATION IS MANDATORY: this tool is a DRY RUN unless
  • Create watchlist groupCreate a new watchlist group. Optionally pass securities (e.g. ["AAPL.US", "700.HK"]) to pre-populate.
  • Dca createCreate a DCA recurring investment plan. frequency: Daily/Weekly/Monthly. day_of_week (Weekly): Mon/Tue/Wed/Thu/Fri. day_of_month (Monthly): 1-28.
  • Dca pausePause (suspend) a DCA plan by plan_id. The plan stops executing until resumed. Returns upstream API response. Use dca_resume to restart.
  • Dca resumeResume a suspended DCA plan by plan_id. Resumes automated execution on the configured schedule. Returns upstream API response.
  • Dca stopPermanently stop a DCA plan by plan_id. This cannot be undone. To temporarily pause, use dca_pause instead. Returns upstream API response.
  • Dca updateUpdate an existing DCA plan by plan_id. Can change amount, frequency (Daily/Weekly/Monthly), day_of_week (Mon-Fri), or day_of_month (1-28). Returns updated plan.
  • Delete watchlist groupDelete a watchlist group by id (numeric). Set purge=true to also remove its securities from all other groups.
Show all 27
  • Grid cancelCancel (terminate) a grid order by order_id. TWO-STEP CONFIRMATION IS MANDATORY: this tool is a DRY RUN unless you pass the confirmation_code its own dry run returned. Call it first without execute, s
  • Grid replaceReplace an existing grid order's rule by order_id. Accepts the same grid rule fields as grid_submit. Overwrites the order's entire rule. TWO-STEP CONFIRMATION IS MANDATORY: this tool is a DRY RUN unle
  • Grid restartRestart (resume) a suspended grid order by order_id. TWO-STEP CONFIRMATION IS MANDATORY: this tool is a DRY RUN unless you pass the confirmation_code its own dry run returned. Call it first without ex
  • Grid submitSubmit a grid trading order. DRY RUN unless execute is the confirmation_code from its own dry run: call once without execute, show the preview, then re-call quoting the code only after the user confir
  • Grid suspendSuspend (pause) a running grid order by order_id. Resume with grid_restart. TWO-STEP CONFIRMATION IS MANDATORY: this tool is a DRY RUN unless you pass the confirmation_code its own dry run returned. C
  • Replace orderModify an open order's quantity, price, trigger_price, or trailing params. Returns "order replaced" on success. Only open/pending orders can be modified. TWO-STEP CONFIRMATION IS MANDATORY: this tool
  • Sharelist addAdd securities to a community sharelist by id. Provide symbols (e.g. ["AAPL.US", "700.HK"]) to add. Returns upstream API response.
  • Sharelist createCreate a new community sharelist with a name and optional description.
  • Sharelist deleteDelete a community sharelist by id (own lists only; subscribed lists cannot be deleted). Returns upstream API response on success.
  • Sharelist removeRemove securities from a community sharelist by id. Provide symbols to remove. Returns upstream API response on success.
  • Sharelist sortReorder securities in a community sharelist by id. Provide symbols in the desired new order. Returns upstream API response on success.
  • Submit orderSubmit a buy/sell order. DRY RUN unless execute is the confirmation_code from its own dry run: call once without execute, show the preview to the user, then re-call quoting the code only after they ex
  • Topic createCreate a new discussion topic. topic_type="post" (default) is plain text; "article" requires a non-empty title and accepts Markdown body.
  • Topic create replyCreate a reply to a discussion topic. Pass reply_to_id to nest under another reply; omit for a top-level reply.
  • Update watchlist groupUpdate a watchlist group by id. Can rename (name param) or modify securities (securities + mode: add/remove/replace).

Changes wait in Needs you

Changes and sends in Longbridge MCP are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

Longbridge MCP questions

Can an agent change data in Longbridge MCP on its own?

Not by default. Changes and sends in Longbridge MCP are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in Longbridge MCP?

This connector lists 134 read actions. Reads run at once, without waiting for approval.

How does Longbridge MCP connect?

It connects with dcr oauth. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring Longbridge MCP to your agents.

Book a discovery call