跳到主要內容
Livermore
Livermore
中文EN

給 AI agent 的 MCP 伺服器

Livermore 讓 AI agent 取用跟網站相同的資料：SEC Form 4 的美股內部人交易，以及 SEC 13F 的機構持倉（包含精選的大師名單）。MCP 伺服器公開、免費、唯讀，不用註冊，也不用 API 金鑰。

MCP 端點

https://livermore.club/mcp

Streamable HTTP · 不用登入 · 唯讀 · 免費

概要

怎麼連上伺服器，以及可以期待什麼。

端點
https://livermore.club/mcp
傳輸
Streamable HTTP。請求用 POST；沒有 session，所以 GET、DELETE 回 405。
驗證
不需要
狀態
無狀態：不發 session ID，每個請求各自回答。
協定版本
2026-07-28，以及用 initialize 握手的 2025-11-25、2025-06-18、2025-03-26、2024-11-05、2024-10-07。
限速
每個 IP 每分鐘 60 次。超過時回 HTTP 429，附 Retry-After。
大小限制
每次最多 200 列（多數工具預設 25 列）；請求 body 最多 64 KB。
權限
唯讀。每個工具都標示 readOnlyHint 與 idempotentHint。

連線設定

Claude、Cursor、VS Code、其他客戶端與直接用 HTTP 的設定方式。

Claude Code

在終端機執行：

claude mcp add --transport http livermore https://livermore.club/mcp

Claude 桌面版與 claude.ai

打開設定（Settings），進入 Connectors，選 Add custom connector，網址填 https://livermore.club/mcp，OAuth 欄位留空。

只能跑本機（stdio）伺服器的客戶端，可以用 mcp-remote 這類橋接程式：

{
  "mcpServers": {
    "livermore": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://livermore.club/mcp"
      ]
    }
  }
}

Cursor

加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "livermore": {
      "url": "https://livermore.club/mcp"
    }
  }
}

VS Code

加到 .vscode/mcp.json：

{
  "servers": {
    "livermore": {
      "type": "http",
      "url": "https://livermore.club/mcp"
    }
  }
}

其他客戶端

新增一個 Streamable HTTP 類型的遠端 MCP 伺服器，網址 https://livermore.club/mcp，不用驗證。用 SDK 的客戶端照一般方式連線：官方 TypeScript SDK v2 可以協商 2026-07-28 版，舊版客戶端走 initialize 握手。

直接用 HTTP

伺服器無狀態，不先 initialize 也能直接呼叫工具。用 2025 年的協定版本時，回應是一則 Server-Sent Event：

curl -sN https://livermore.club/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -H "mcp-protocol-version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"NVDA","limit":1}}}'

回應（節錄）：

event: message
data: {"result":{"content":[{"type":"text","text":"{\"query\":\"NVDA\",…}"}],"structuredContent":{"query":"NVDA","stocks":[{"ticker":"NVDA","name":"NVIDIA Corp","url":"https://livermore.club/en/stock/NVDA"}],"institutions":[],"insiders":[]}},"jsonrpc":"2.0","id":1}

工具

9 個唯讀工具。先用 search 把公司、基金或人名換成代號或 CIK。

search
個股、13F 機構與內部人，附其他工具要用的代號或 CIK。
get_stock
個股總覽：公司資料、近 90 天內部人買賣、13F 持有概況與持有的大師。
get_insider_trades
Form 4 交易，可依代號、內部人、申報日期、交易代碼、職務、金額篩選。
get_insider_lists
預設清單：群聚買進、執行長與財務長買進、最大筆買進與賣出。
get_stock_13f_holders
某一季持有這檔股票的機構，以及跟上一季比的變化。
get_institution
一家 13F 機構：各季申報、某一季的持倉、清倉的部位、選擇權。
list_superinvestors
精選大師名單，附最新一季與前三大持股。
get_superinvestor_activity
大師某一季的買賣，全體彙總或單一大師。
get_data_coverage
資料範圍、已載入的 13F 季度、最近更新時間與使用限制。

search

個股、13F 機構與內部人，附其他工具要用的代號或 CIK。

找個股、13F 機構與公司內部人（Form 4 申報人）。代號完全相符或開頭相符，CIK 或 9 碼的 CUSIP 要完全相符，名稱至少 2 個字。大師也可以用基金或人物的中英文名字找。

個股的公司名稱在 name。機構的 detail 是大師的代表人物，一般機構是「13F filer」；內部人的 detail 是職稱與公司。內部人以 SEC 上的英文姓名列出，姓在前，例如「Cook Timothy D」。

參數

query字串，1 到 100 個字必填
代號、公司、基金、經理人或人名、CIK 或 CUSIP。
limit整數，1 到 20
每組最多幾筆，預設 5。

參數範例

{"query": "buffett", "limit": 2}

get_stock

個股總覽：公司資料、近 90 天內部人買賣、13F 持有概況與持有的大師。

一檔美國上市股票的總覽：SEC 名稱、CIK、交易所、SIC 產業與其他股別；近 90 天的公開市場內部人買賣（Form 4 代碼 P、S，非衍生），以申報份數與美元合計表示；最新完整季的 13F 機構持有概況，附上一季比較；以及持有這檔股票的大師。

「完整季」指已過 45 天申報期限、資料也已載入的季。不同股別（GOOG 與 GOOGL、BRK.A 與 BRK.B）是不同代號。

參數

ticker字串必填
代號，例如 AAPL、BRK.B（BRK-B 也可以）。

參數範例

{"ticker": "AAPL"}

get_insider_trades

Form 4 交易，可依代號、內部人、申報日期、交易代碼、職務、金額篩選。

一份申報裡同一種交易合計成一列：同一天的多筆成交合併（lots 是筆數），avg_price_usd 依金額加權，shares_owned_after 是最後一筆成交後的持股。ownership_change_pct 是內部人持股的變化，新建立的部位是 null。

給了 ticker 或 insider_cik 可以查 2021 年 7 月以來的全部紀錄。兩個都沒給就是全市場查詢，申報日期最多 30 天；沒給日期就查近 7 天，區間被縮短時 note 會說明。交易代碼的意思請看術語白話。

參數

ticker字串
只看這家公司（發行人的所有股別）。
insider_cik字串
只看這位內部人名列申報人的申報，跨公司。
from, toYYYY-MM-DD
申報日期區間，美東時間，兩端都含。
codes代碼陣列，或 "all"
要包含的交易代碼，預設 ["P", "S"]。
roles陣列：ceo、cfo、director、officer、owner10
主要申報人具有其中任一身分。
min_value_usd數字，0 以上
最低交易金額。
sortfiled、trade_date 或 value
依最新申報、最近交易日或最大金額排序，預設 filed。依金額排序時排除價格異常的列。
limit整數，1 到 200
每頁幾列，預設 25。
page整數，1 以上
第幾頁；看 has_more 判斷還有沒有下一頁。

參數範例

{"ticker": "NVDA", "codes": ["S"], "limit": 1}

get_insider_lists

預設清單：群聚買進、執行長與財務長買進、最大筆買進與賣出。

跟網站上的內部人清單相同。時間窗依 SEC 申報時間從現在往前算，只看非衍生交易，排除價格異常與沒有代號的發行人。群聚買進回在 companies，其他清單回在 trades（欄位同 get_insider_trades）。

cluster-buys
近 30 天至少 3 位不同的內部人在公開市場買進的公司，依買進總額排序。
ceo-cfo-buys
近 30 天執行長或財務長 2.5 萬美元以上的公開市場買進，新的在前。
top-buys-week
近 7 天申報的最大筆公開市場買進。
top-buys-month
近 30 天申報的最大筆公開市場買進。
top-sells-week
近 7 天申報的最大筆公開市場賣出。
top-sells-month
近 30 天申報的最大筆公開市場賣出。

參數

list上面其中一個清單必填
要看哪一個清單。
limit整數，1 到 200
列數，預設 25。

參數範例

{"list": "cluster-buys", "limit": 1}

get_stock_13f_holders

某一季持有這檔股票的機構，以及跟上一季比的變化。

每一列有股數、市值、pct_of_portfolio（這檔股票佔該機構 13F 組合的比重），以及跟上一個日曆季比的變化：action 是 new 新進、added 加碼、reduced 減碼、unchanged 不變或 sold_out 清倉，另有 share_change 與 share_change_pct。合計數字涵蓋全部持有人，不只這一頁。

上一季持有、這一季有申報但沒有部位的機構列在最後，算清倉；這一季還沒申報的機構不算清倉。

參數

ticker字串必填
代號。
quarter字串，例如 2026-q2
預設是最新完整季。
sortvalue、shares 或 change
依市值、股數或股數增加最多排序，預設 value。
limit整數，1 到 200
每頁幾列，預設 25。
page整數，1 以上
第幾頁。

參數範例

{"ticker": "AAPL", "limit": 1}

get_institution

一家 13F 機構：各季申報、某一季的持倉、清倉的部位、選擇權。

用 SEC CIK 查一家機構或精選大師：名稱（大師另附經理人與投資風格）、最近 12 季的申報、某一季的持倉與跟上一個日曆季比的變化，以及最大的 10 筆清倉與 10 筆選擇權部位。

組合總值只算多頭部位、不含選擇權。這家機構上一季沒申報時，不給變化與清倉。沒有代號的證券 url 是 null。

參數

cik字串必填
SEC CIK，例如 0001067983 或 1067983。
quarter字串
預設是這家機構最新申報的一季。
sortvalue、shares、change 或 pct
持倉的排序，預設 value。
limit整數，1 到 200
每頁幾筆持倉，預設 25。
page整數，1 以上
第幾頁。

參數範例

{"cik": "0001067983", "limit": 1}

list_superinvestors

精選大師名單，附最新一季與前三大持股。

每位大師的組合總值（多頭部位、不含選擇權）、持股檔數、申報日與前三大持股，依組合總值排序，中文名稱在 name_zh 與 manager_zh。最新一季是用前身 CIK 申報時，source_cik 會有值。

參數

沒有參數。

參數範例

{}

get_superinvestor_activity

大師某一季的買賣，全體彙總或單一大師。

拿一季跟上一個日曆季比較，只比兩季都有申報的大師。加碼、減碼看股數，不看市值；證券依代號合併（沒有代號的依 CUSIP）。

沒給 superinvestor_cik 時，回最多大師買進（most_bought）、最多大師賣出（most_sold）的股票與每位大師的動作次數（by_superinvestor）；給了就回那位大師依動作分組的變動。

參數

quarter字串
預設是能比較的最新完整季。
superinvestor_cik字串
只看這位大師的變動。
limit整數，1 到 50
每個清單幾列，預設 25。

參數範例

{"limit": 1}

get_data_coverage

資料範圍、已載入的 13F 季度、最近更新時間與使用限制。

Form 4 的申報日期範圍、全市場都有資料的 13F 季度與最新完整季、大師人數、最近成功更新的時間、更新排程，以及伺服器的使用限制。要確認某個日期或季度有沒有資料時先呼叫它。

參數

沒有參數。

參數範例

{}

回傳格式

所有工具共用的慣例。

每個工具都回兩份一樣的 JSON：一份是文字區塊（給只讀文字的客戶端），一份是 structuredContent（符合工具的輸出 schema）。

  • 金額單位是美元、股數單位是股，都是 JSON 數字。
  • _pct 結尾的欄位是百分比：12.5 表示 12.5%。
  • 日期是 YYYY-MM-DD，時間點是 UTC 的 ISO 8601。filed_date 是美東時間的申報日，也就是 SEC 用的日期。
  • 季度寫成 2026-q2，period 是季末日期（2026-06-30）。季度參數也接受 2026Q2、Q2 2026 或 2026-06-30。
  • 每一筆都附 livermore.club 的網址（url，英文版），中文版把 /en/ 換成 /zh/。呈現資料時請附上出處。
  • null 表示沒有這項資料，例如申報沒有價格。
  • 13F 的市值是機構申報的季末市值。13F 最晚在季末後 45 天申報，只含在美國上市證券的多頭部位。

限制與錯誤

請求太大或出錯時會怎樣。

  • 參數有問題（查無代號、CIK 或季度格式不對、那一季沒有資料）時，回一般的工具結果，isError 為 true，並用一句話說明該怎麼改。不符合 schema 的參數（例如 limit 超過 200）也一樣。
  • 超過 5 秒的查詢會被取消，錯誤訊息會請你縮小範圍。
  • 資料庫出錯時回通用訊息，不帶內部細節。
  • 呼叫不存在的工具會回 JSON-RPC 錯誤（-32602）。

傳輸層的錯誤用 HTTP 狀態碼回應，body 是 JSON-RPC 錯誤：

400
JSON 格式錯誤
405
用了 GET 或 DELETE
406
Accept 標頭沒有 application/json 與 text/event-stream（2025 年的協定版本）
413
body 超過 64 KB
415
Content-Type 不是 application/json
429
超過限速，看 Retry-After

資料範圍

伺服器有哪些資料、有多新。get_data_coverage 回的是同樣的數字。

Form 4 內部人交易
申報日 2021/7/1 到 2026/9/25
13F 持倉
2021 年第 1 季 起全部申報機構；最新完整季 2026 年第 2 季
大師
精選 47 位

最近一次成功更新（美東時間）

SEC 申報
2026/9/25 23:50 ET
股票代號與公司名稱
2026/9/25 22:45 ET
CUSIP 與代號的對照
2026/9/26 09:19 ET

新的 Form 4 與 13F 申報每天美東晚上 11:30 後載入一次；股票代號清單每天更新，CUSIP 與代號的對照每週全面補查。

數字怎麼算、有哪些限制，請看關於資料。

給 AI agent 的其他資源

語言模型使用本站的其他方式。

  • llms.txt 是給語言模型看的純文字網站簡介：資料內容、網址規則與 MCP 伺服器的位置。
  • 本站允許 GPTBot、ClaudeBot、PerplexityBot 這類 AI 爬蟲讀取頁面，robots.txt 只排除搜尋結果頁與內部 API。
  • 每一頁都有英文版（/en/）與繁體中文版（/zh/），表格內容直接在 HTML 裡，會讀網頁的 agent 拿到的也是同樣的資料。