接入指南
在 LangChain、自建 gateway 或企業 agent 平台上做金融 agent 的團隊。
讓 agent 拿到的每個數字可溯源、可驗證,而且不知道的時候會說不知道。
以下每一步都標明它由哪一個介面提供,以及今天能不能做。標「今天就能做」的每一步,都在 2026-08-21 對線上 API 實際探測過;其餘的會說清楚缺什麼。沒有任何一項因為在規劃中就被寫成現在式。
連線位址是 https://mcp.twmarketdata.com/mcp——路徑要帶上,只打主機會回 404。任何支援 MCP 的框架都能直連;連上後伺服器會自己列出可用工具(目前 24 個,涵蓋查詢、研究、申報書檢索與 inclusion proof)。
工具層就吃 as_of,所以 agent 問歷史問題時不會看到未來。揭露型資料集是用揭露日期過濾的。
coverage.missing 明確列出「要了但沒回」的項目與原因。把它餵給 agent 當作不可回答的判準——空的資料陣列配上有內容的 missing 清單,是對「你有什麼」的完整正確答覆,不是要 agent 去補值的邀請。
twmd_verify_proof.py 只用 Python 標準函式庫,不 import 我們任何程式碼,也不裝任何 PyPI 套件。從 /twmd_verify_proof.py 下載後在你的環境跑——需要我們的程式碼才能跑的驗證器,等於要你先信任我們的程式碼。
一次資料存取回一張簽章收據,綁住 as_of、查詢與回傳列,存進 LangSmith 或 Langfuse 當附件,就是那次決策的資料側證據。
沒有可公開呼叫的收據端點——探測過的位址都不存在。引擎側目前的版本是 v0,不是 v1;在它成為可呼叫的介面之前,這裡不寫成已提供。
CrewAI / AutoGen 的封裝,以及把收據嵌進 trace 的逐框架指南。
尚未提供。
收據與證明說的是「用了哪一批資料、在什麼時點、有沒有被竄改、涵蓋到什麼程度」。它們不證明 agent 的結論是對的——那是模型與推理層的事,不在資料供應商能擔保的範圍。
證明機制如何對應到已發布的標準,見標準與相容性。