Mopsfin MCP Server

即時解析 Mopsfin 首頁，列出可用指標代號、endpoint family、產業、金融機構與可選期間，並為每個指標提供官方語意、公式、值的口徑、適用業別與注意事項。未知 metric_code、industry_codes、institution_codes、可用期間，或需要正確解釋某項指標時，必須先呼叫本工具。回傳的 officialGuidance 說明 IFRSs 資料範圍、不同市場申報季度、報表／附註可用性、單季與累計口徑及平均數算法。目錄只在單一執行個體記憶體快取五分鐘，財務數據不快取。

查詢 1–20 家台股公司在明確 YYYY-MM-DD 起訖範圍內的官方重大訊息與法人說明會事件；含首尾最多 366 日，且公司×月份×event family 加上 recent snapshot 的 catalyst 查詢工作單位合計上限為 40，retry attempt 不重複計數。工具只以目前上市櫃 master 驗證 current identity、縮小近期重大訊息 snapshot 市場；歷史法說固定查上市與上櫃兩個 TYPEK，以免 current market hint 漏掉轉板前事件，不能把目前 master 冒充歷史母體。若代號不在目前 master 且範圍內也沒有官方…

查詢 1–20 家台股公司的 current official snapshot evidence：公司財測達成、財測重大差異名單、股東會排程與股利決議；as_of 固定 latest，不接受歷史日期。工具依目前上市櫃 master 縮小 current source routes，未匹配代號會安全探測雙市場；共享 full-market source failure 按 snapshotType×market 隔離，不能當成合法空值。sourceSnapshotDate 是官方出表日，不是 factDate、首次公告日或 firstKnownAt；pointInTimeHistoryAvai…

以公司代號或中英文名稱搜尋 Mopsfin 公司清單，回傳可供其他工具使用的正式 company_codes、公司名稱與上游顯示值。當使用者只提供公司名稱、簡稱、股票代號不確定，或其他工具回傳 NOT_FOUND 時，應先呼叫本工具；不要臆測公司代號，也不要把金融機構工具的 institution_code 當成股票代號。資料範圍包括上市、上櫃、興櫃、公開發行及部分未公開發行金融業，但不含 TDR 發行公司。搜尋無結果時可縮短名稱或改用已知代號重試；找到公司只表示它存在於 Mopsfin 清單，不保證每個指標、附註或季度都有資料。

從 TWSE 上市公司基本資料與 TPEx 上櫃股票基本資料官方 OpenAPI 建立可供財務與市場工具使用的目前公司母體。market=listed 只回上市公司且包含創新板，market=otc 只回上櫃公司，market=all 同時取得兩市場；任何必要來源失敗、同一來源出表日期不一致或筆數低於安全門檻時整體報錯。官方來源沒有 declared row count，因此 coverageVerification.status=heuristic；coverageComplete=true 僅代表必要來源、schema、單一出表日期、唯一代號與最低筆數 gate 通過，不可宣稱官方完整 r…

以各官方來源當下可取得的 latest 資料執行固定 balanced_financial_v1 研究分流。只接受目前上市櫃產業代號 17 中，股票四碼代號與 Mopsfin financial institution catalog 唯一 exact-code 對應、名稱 identity 一致且 subtype 為 holding、bank 或 bills 的公司；unmapped、duplicate、identity mismatch、保險、證券或 unknown subtype 明示排除，不 fuzzy mapping。粗篩以 latest 月營收／淨收益 proxy 與 P/B-le…

查詢公司財務趨勢、財務結構、償債／經營／獲利／成長能力及現金流指標。metric_code 必須取自 list_catalog 中 family=data；一次比較 1–10 家公司。每個公司 series 會回傳獨立 companyCode、companyName、displayName 與 seriesType，避免依 label 猜身份；逐點 valueStatus 區分 reported、missing、invalid_upstream，null 不可視為 0。coverage 會揭露 requested／returned／missing／no-valid-data 公司、逐公司缺期與…

以單一呼叫取得 1–100 家公司、1–8 個 list_catalog family=data 指標；每個成功解析 identity 的公司頁面都保留全部 requested metrics，不按指標拆頁。預設每家公司每項指標最多回自己的最近 12 期，也可指定最多 12 季的成對 start_period/end_period。basis 與 yoy_quarter 語意沿用 get_company_metric；本工具不提供產業平均或所選公司平均。每頁最多 20 家、comparison 與有界二分 failure isolation 合計最多 24 個上游工作單位。單一公司 ident…

查詢格式化的資產負債表、綜合損益表或現金流量表。資產負債表是指定期末存量；綜合損益表與現金流量表是各季累計金額，不是單季金額。period 預設 latest，服務會由上一個完成季度往前最多探測 12 季，並拒絕 Mopsfin 靜默回傳的錯誤季度。不同市場的申報頻率不同，因此 latest 可能不是最近曆季。表格以 offset/limit 分頁，回答前應確認 pagination 是否還有 nextOffset，並保留 unit 與 period。

查詢五類格式化財報附註：列入合併財報的子公司、資金貸與、背書保證、被投資公司與大陸投資。支援 latest 或 YYYYQn；服務會核對實際回應期別，並把 HTML rowspan/colspan 展開為可供 LLM 逐列解讀的完整二維表格。上市／上櫃／興櫃及部分金融機構通常申報附註；公開發行公司與部分未公開發行金融業可能僅自願申報，因此 NO_DATA 不代表公司不存在。回答前應確認 pagination.nextOffset，避免只讀到第一頁。

查詢 Mopsfin 產業統計或產業趨勢，measure 可選營業收入或稅後純益。statistics 是指定季度的產業累計金額，使用 period；trend 用來比較一個以上產業的時間序列，使用 history/start_period/end_period，且至少指定一個即時 catalog 的 industry_codes。產業分類與成分可能調整，不能把產業平均當成單一公司的表現；回答時應明確標示統計／趨勢模式、單位、期別及回傳 warnings。

查詢六項金融業資產品質或三項資本適足率。metric_code 必須取自 list_catalog 中 family=fin 或 adequacy，institution_codes 一次 1–10 家。include_industry_average 可加入該指標相應金融業別的 Mopsfin 產業平均；include_institution_average 可加入本次所選機構的簡單平均，兩者都不是市值加權。資產品質指標只適用銀行業，資料來自財報附註「資產品質」；資本適足率依指標只適用金控、銀行或票券業，而且通常只有 Q2、Q4 申報。部分公開發行金融機構依法不需申報，因此 NO_DATA …

以 full_universe_cursor_v1 建立 current listed/OTC company identity manifest，並用 stateless query/snapshot-bound cursor 每頁處理最多 5 家，依 isFinancial 路由到原封不動的 taiwan_stock_screen.v2 或 taiwan_financial_screen.v1。每頁把 candidate_limit 設為該 segment 本頁公司數，因此不再用全母體 top-10 deep／top-5 reaction 作總量截斷；每家公司必須恰好落入 candidat…

執行固定 balanced_market_v1 雙模型研究分流：在同一次 request 中分別原封不動執行 balanced_non_financial_v2 與 balanced_financial_v1，並完整保留 segments.nonFinancial、segments.financial 的 candidates、funnel、來源、warnings、model identity、bucket、within-model rank 與 evidence。caller 分別設定 non_financial_limit 與 financial_limit（各 1–5，預設 4／1）；q…

查詢單一四碼公司股票在指定起訖日期內的官方原始日線開高低收、成交量（股）、成交金額（TWD）、成交筆數與漲跌價差。服務按月份讀取 TWSE／TPEx，支援目前上市櫃、已下市櫃與上櫃轉上市歷史；轉板月份會合併兩市場並拒絕同日衝突。TWSE 個股月資料自 2010-01-04、TPEx 自 1994-01-01 起支援。每頁最多處理 12 個日曆月份，coverage.coverageComplete=false 時必須以完全相同的 company_code、start_date、end_date 帶回 nextCursor 繼續。官方 no-data response 若缺少 title/dat…

查詢最近完成交易日或指定 YYYY-MM-DD 的上市、上櫃或全部公司股票官方原始 OHLC、成交量（股）、成交金額（TWD）、成交筆數與漲跌價差。market=all 要求 TWSE／TPEx 資料日期一致；latest 不是盤中即時價，指定假日或未來日期不會靜默退回前一日。latest freshness 由各市場官方年度開休市日曆與 exact benchmark session、Asia/Taipei 13:33 completed-session guard 共同驗證；任一來源不可用、契約漂移或兩市場日期不一致時保守回 unknown，不猜測。company_codes 可選且最多 …

比較 1–50 家目前上市櫃公司與 TAIEX／櫃買 price index 在 5／20／60／120 個 exact benchmark sessions 的 reaction signals。stockReturnPercent 保留 raw_unadjusted close-to-close 稽核值；excessReturnPercentagePoints 只使用 TWSE／TPEx official actual-result 公司行動資料可重算的 factor，移除股數變動造成的機械價格斷點。現金股利價格效果刻意保留，因此 returnBasis=price_index_compa…

查詢 TWSE／TPEx 官方 latest 或指定 YYYY-MM-DD 的上市、上櫃或全部公司本益比、股價淨值比、殖利率，以及來源可提供的收盤價、每股股利、股利年度與估值參考財報期。指定日採 exact-date，假日不退回前一交易日；上市自 2005-09-02、上櫃與 market=all 自 2007-01-02。latest freshness 由各市場官方年度開休市日曆與 exact benchmark session、Asia/Taipei 13:33 completed-session guard 共同驗證；任一來源不可用、契約漂移或兩市場日期不一致時保守回 unknown，…

分析單一目前上市櫃公司的 caller-supplied 觀察價格，相對於 TWSE／TPEx 官方最近完成交易日 raw_unadjusted 收盤價的絕對與百分比差異。caller 必須明示 observed_price_twd、含 Z 或 UTC offset 的 observed_at，以及 source_label；觀察值不會被冒充成官方、即時或 real-time 行情。工具以 market=all 目前公司 master 核對 identity；listed／otc 來源各自驗證 schema、coverage、reportDate 與 provenance，但不要求兩市場 re…

查詢單一四碼台股在含頭含尾 YYYY-MM-DD 範圍內的完整日線序列，最多 36 個日曆月份。price_basis=raw_unadjusted 只收集官方原始未還原權值 OHLC，完全不查公司行動；price_index_compatible_corporate_action_adjusted 則使用 TWSE／TPEx official actual-result 公司行動，以最後一根實際 raw bar 為 factor=1 的 backward anchor，並同時保留 raw 與 adjusted OHLC。現金股利價格效果刻意保留且 cash-only factor=1，因此不…

先完整執行既有 balanced_non_financial_v2／taiwan_stock_screen.v2 四柱篩選，再只對實際形成的 ordered screen.candidates（最多 5 家、包含任何 bucket）執行一次 batched current official catalyst snapshot 查詢；不查 notDeepScored、notReactionScored、excluded 或其他未形成 candidate 的公司。Snapshot families 可選公司財測達成、官方重大差異名單、股東會與股利決議；公司財測是發行人揭露，不是分析師 consen…

查詢上市、上櫃或全部公司在 latest 或 2013-01 起指定 YYYY-MM 的官方單月營收、月增率、年增率與累計營收年增率。latest 以 TWSE／TPEx OpenAPI 發現月份，再與同月或前一月 MOPS archive 核對共同有效月份；若同月不同出表日僅少量重疊公司數值不同，視為官方修訂、採較新 snapshot 並 warning，同出表日或大範圍衝突則報錯。meta freshness 的 within_expected_window 只證明本次 selected month 等於兩市場協調出的 latest common official month，不代表每家公…

查詢 1–100 家上市櫃公司、連續 3–24 個月的官方月營收序列，支援 latest 或 2013-01 起 exact YYYY-MM 終點。每個月份保留當月營收、去年同月營收、官方 MoM／YoY、公司 name／market、sourceIndustryName、sourceReportDate 與逐欄 valueStatus；缺月明確回 null，不補值。每家公司另提供可由 points 重算的最新 YoY、rolling 3／6 月營收 YoY、相較三個月前 YoY 加速度、正 YoY 月數、已申報 YoY 月數與連續正 YoY 月數；若相鄰有資料月份觀察到名稱或市場轉換，com…

為單一目前上市櫃非金融公司執行 deterministic、可重算的 market-implied FCFF reverse DCF。工具沿用同一次 get_valuation_model_inputs execution 的 current-master identity、TTM／historical FCFF proxy、cash、aggregate interest-bearing debt、issued common shares，以及 request-start authoritative resolver expectedAsOf 同日的 exact 單股 OHLC close；不…

以各官方來源當下可取得的 latest 資料，對目前上市櫃非金融公司執行固定 balanced_non_financial_v2 研究分流：先以最新月營收與估值粗篩，再對前 10 家做六個月營收趨勢及七項季度財務深篩，最後依 candidate_limit 對最多 5 家計算 5／20／60 benchmark-session reaction。七項財務需求以穩定 semantic roles 表達；每次先對即時 list_catalog 的 family=data 正式中文名稱精確解析，已知歷史代號只作 fallback，缺少、重複、名稱／代號衝突或 batch definition 漂移一…

為單一目前上市櫃非金融公司整理可重算的 valuation model input evidence：TTM revenue、營業利益 EBIT proxy、cash tax rate、D&A、只含 PPE acquisition 的 CapEx、ΔNWC、source/sign-normalized historical FCFF proxy、cash、有息負債、net debt、目前 issued shares、最近完成官方收盤、market cap 與 enterprise value。財報 TTM 嚴格採 Q4 FY 或 current YTD + prior FY - prior-y…