PtData

io.ptdata由 ptdata.io 發布官方發布者v3.3.2更新於 Oct 30, 2026

Point-in-time US equity fundamentals for quants and AI agents. Free tier, no API key needed.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

遠端 MCP 伺服器，為助理提供時點（point-in-time）美股資料：基本面、指數成分股、SEC 申報中繼資料與財報事件。

可以做什麼
  • 依指定日期查詢某檔股票當時已知的基本面資料，含來源、知識時間與血緣資訊
  • 取得指定日期的指數成分股（如標普 500），不受存活者偏差影響
  • 列出某日期可取得的 SEC 申報文件，最新優先並標註修訂關聯
  • 取得財報事件，包括 8-K 接收時間戳、原始揭露數據與推算的股價反應
適用情境
適合量化研究、回測與 AI 代理工作流程，需要依歷史某日當時已知的資料而非今日修訂後的數據；也適合查核某一時點的申報文件或指數成分。
執行需求
遠端 streamable HTTP 端點 api.ptdata.io，無需本機安裝。可選 Authorization 標頭攜帶 Bearer API 金鑰以提升至 Pro/Scale 額度；留空則使用免費額度。
安裝前請注意
Authorization 標頭包含 API 金鑰，應視為機密。工具僅做唯讀查詢；結果完整度取決於資料供應商涵蓋範圍，無值的指標會以 unavailable 回傳而非省略。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 PtData，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.ptdata%2Fptdata/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "ptdata": {
      "type": "http",
      "url": "https://api.ptdata.io/mcp"
    }
  }
}

工具

4

get_index_constituents

Get index constituents

S&P 500 (or other index) constituents as understood on `as_of_date` (YYYY-MM-DD), survivorship-free. Point-in-time, with lineage.

輸入參數index必填as_of_date必填

get_fundamentals

Get point-in-time fundamentals

Point-in-time fundamentals for `ticker` as known on `as_of_date` (YYYY-MM-DD). Returns each available metric's value for the fiscal period with source + knowledge time + lineage under `metrics`. Any requested metric with no value appears under `unavailable` with `{reason, available_alternatives, docs_url}` instead of being silently dropped — e.g. asking a bank/broker/insurer for `revenue` explains that financials report an as-reported revenue FAMILY and lists the populated members (net_interest_income, noninterest_income, total_net_revenue, premiums_earned, net_investment_income, total_revenue). Check `unavailable` before concluding a figure does not exist.

輸入參數ticker必填metrics必填as_of_date必填fiscal_yearfiscal_period

get_filing_metadata

Get filing metadata

SEC filings for `ticker` available on `as_of_date`, newest first, with amendment linkage.

輸入參數ticker必填form_typeas_of_date必填

get_earnings_event

Get earnings event

Earnings event: 8-K acceptance timestamp, as-reported figures, and the derived realized price reaction. `fiscal_period` is FY or Q1..Q4.

輸入參數ticker必填fiscal_year必填fiscal_period必填

版本歷史

1
  1. v3.3.2最新Oct 29, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫，或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用，因此這裡不要求授權條款。此檢查項不計入百分比。