Skip to content

Tool Catalog

Mofesto edited this page Aug 7, 2026 · 1 revision

工具總覽

目前 Server discovery 到 72 個 tools。除 get_market_overview 外,工具的 MCP input 皆以 args 包住業務參數:

{
  "args": {
    "symbol": "2330"
  }
}

表格中的「參數」指 args 內部欄位;? 表示選填。完整巢狀結構請依分類頁面為準。

風險標記

標記 意義
READ 不呼叫下單、改單或刪單 API
ACCOUNT-READ 唯讀,但會存取真實帳戶、庫存、損益或委託資料
WRITE 會建立、修改或取消真實委託/條件單

市場資料(28)

Tool 參數摘要 標記 說明
historical_candles symbol, from_date, to_date, timeframe?, adjusted?, fields?, sort? READ 歷史 K 線與 SQLite 快取
get_capital_changes start_date, end_date, sort? READ 資本變動
get_dividends start_date, end_date READ 除權息
get_listing_applicants start_date, end_date, sort? READ 申請上市櫃公司
get_intraday_tickers market, type?, exchange?, 狀態篩選 READ 股票/指數清單
get_intraday_ticker symbol, type? READ 商品基本資料
get_intraday_quote symbol, type? READ 個別即時報價
get_intraday_candles symbol READ 盤中 K 線
get_intraday_trades symbol, type?, offset?, limit? READ 成交明細
get_intraday_volumes symbol READ 分價量
get_snapshot_quotes market, type? READ 市場快照
get_snapshot_movers market, direction?, change?, 門檻, type? READ 漲跌幅排行
get_snapshot_actives market, trade?, type? READ 成交量/值排行
get_historical_stats symbol READ 52 週統計
get_realtime_quotes symbol READ SDK 即時行情
query_symbol_snapshot account, market_type?, stock_type? ACCOUNT-READ 帳戶介面的商品快照
margin_quota account, stock_no ACCOUNT-READ 資券配額
daytrade_and_stock_info account, stock_no ACCOUNT-READ 現沖券與商品資訊
query_symbol_quote account, symbol, market_type? ACCOUNT-READ 商品漲跌幅報表
get_market_overview READ 台股市場概況
get_intraday_futopt_products type?, exchange?, session?, contractType?, status? READ 期貨/選擇權商品清單
get_intraday_futopt_tickers type, exchange?, session?, product?, contractType? READ 合約代碼清單
get_intraday_futopt_ticker symbol, session? READ 合約基本資料
get_intraday_futopt_quote symbol, session? READ 合約即時報價
get_intraday_futopt_candles symbol, session?, timeframe? READ 合約 K 線
get_intraday_futopt_volumes symbol, session? READ 合約成交量
get_intraday_futopt_trades symbol, session?, offset?, limit? READ 合約成交明細
get_trading_signals symbol, from_date?, to_date? READ 多因子技術訊號

詳見 市場資料工具

交易與委託(24)

Tool 參數摘要 標記 說明
place_order 帳戶、買賣別、商品、價格、數量與委託屬性 WRITE 普通下單
cancel_order account, order_no?order_res?, unblock? WRITE 取消委託
modify_price account, 委託識別, new_price?price_type?, unblock? WRITE 改價/價別
modify_quantity account, order_no, new_quantity WRITE 改量
batch_place_order orders[] WRITE 平行批次下單
place_condition_order 日期、單一條件、主單、tpsl? WRITE 單一條件單
place_multi_condition_order 日期、多條件、主單、tpsl? WRITE 多條件單
place_daytrade_condition_order 日期、多條件、當沖主單 WRITE 當沖條件單
place_daytrade_multi_condition_order 多條件、主單、回補、tpsl? WRITE 當沖多條件單
place_time_slice_order 日期、拆單設定、主單 WRITE 分時分量單
place_tpsl_condition_order 條件、主單、TPSL WRITE 停損停利條件單
cancel_condition_order account, condition_no WRITE 取消一般條件單
get_condition_order account, condition_status? ACCOUNT-READ 條件單清單
get_condition_order_by_id account, guid ACCOUNT-READ 依 GUID 查條件單
get_daytrade_condition_by_id account, condition_no ACCOUNT-READ 查當沖條件單
get_trail_order account ACCOUNT-READ 有效移動鎖利
place_trail_profit 帳戶、日期、停止條件、trail WRITE 建立移動鎖利
get_time_slice_order account, batch_no ACCOUNT-READ 查分時分量
get_order_results account ACCOUNT-READ 當日委託結果
get_order_history account, start_date, end_date? ACCOUNT-READ 歷史委託
get_filled_history account, start_date, end_date? ACCOUNT-READ 歷史成交
get_order_results_detail account ACCOUNT-READ 委託與修改明細
get_trail_history account, start_date, end_date ACCOUNT-READ 移動鎖利歷史
get_condition_history account, 日期, condition_history_status? ACCOUNT-READ 條件單歷史

詳見 交易工具

帳戶(8)

Tool args 欄位 標記 說明
get_account_info account? ACCOUNT-READ 全部或指定帳戶基本資料
get_inventory account ACCOUNT-READ 庫存
get_bank_balance account ACCOUNT-READ 銀行餘額
get_maintenance account ACCOUNT-READ 維持率
get_settlement_info account, range?=0d ACCOUNT-READ 交割資訊,0d3d
get_realized_pnl account ACCOUNT-READ 已實現損益
get_realized_pnl_summary account ACCOUNT-READ 已實現損益摘要
get_unrealized_pnl account ACCOUNT-READ 未實現損益

主動回報(5)

這五個 tools 的 args 為空物件 {},資料來自目前 server process 的 callback buffer。

Tool 標記 說明
get_all_reports ACCOUNT-READ 一次回傳四種 buffer
get_order_reports ACCOUNT-READ 最新委託回報
get_order_changed_reports ACCOUNT-READ 最新改價/改量/刪單回報
get_filled_reports ACCOUNT-READ 最新成交回報
get_event_reports ACCOUNT-READ 最新系統/連線事件

唯讀量化分析(7)

Tool 參數摘要 標記 說明
calculate_portfolio_var 帳戶、信賴水準、期間、方法、lookback ACCOUNT-READ VaR/CVaR
run_portfolio_stress_test 帳戶、明確指定的情境 ACCOUNT-READ 價格衝擊壓力測試
optimize_portfolio_allocation 帳戶/symbols、目標、lookback、限制 ACCOUNT-READ 長倉全額配置最佳化
calculate_performance_attribution 帳戶、benchmark、period ACCOUNT-READ 成交現金流與損益貢獻
detect_arbitrage_opportunities 股票組合/期貨對、類型、lookback、Z 門檻 READ 統計與跨月價差
generate_market_sentiment_index symbols、technical/volume、lookback READ 技術與成交量狀態
analyze_stock symbol, account? READ 正式日 K 個股分析

MCP prompts(12)

Prompts 是引導 MCP Host 組合工具的模板,不會因「取得 prompt」本身執行交易:

trading_analysisrisk_assessmentmarket_opportunity_scannerportfolio_rebalancingtrading_strategy_builderperformance_analyticsadvanced_risk_managementportfolio_optimizationmarket_sentiment_analysisalgorithmic_strategy_builderfutures_spread_analyzervolatility_trading_advisor

Prompt 產生的文字仍需由 Host 決定後續 tool calls;應在 Host policy 層阻止未授權的 WRITE tools。

Clone this wiki locally