Quantustik

io.github.quantustik由 GitHub 帳號 quantustik 發布v2.2.0更新於 Oct 25, 2026

S&P 500 market data: filings, earnings, insider, Congress and institutional trades. No forecasts.

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

概覽

AI 產生的概覽

Quantustik 讓助理取得唯讀的標普 500 市場資料:恐懼與貪婪指數、財報日期、SEC 文件、內部人、機構與國會交易。

可以做什麼
取得市場情緒與事件日期:CNN 恐懼與貪婪指數,以及個股下一次和最近一次財報日期。彙整 SEC 文件:8-K 事件摘要、Form 4 內部人交易,以及 10-K/10-Q 風險因素與 MD&A 的同比或環比措辭變化。檢視持股與政治揭露:13F 機構持股變化、SC 13D/G 維權文件與 STOCK Act 國會交易。探索伺服器提供的工具及目前匿名或帶金鑰的配額。
適用情境
適合助理需要附來源與日期的標普 500 文件及交易活動背景做研究時,例如查看內部人買進、維權基金持股或公司風險揭露的變化。它只發布實測資料,不提供預測或建議。
執行需求
可使用遠端 streamable-HTTP 端點,或 npm 套件 @quantustik/mcp-server;後者是給僅支援 stdio 用戶端的輕量代理,需透過 npx 使用 Node.js。不需帳號或金鑰,匿名使用依 IP 每小時限流。選用免費金鑰可透過 QUANTUSTIK_API_KEY 或 Authorization Bearer 標頭提供以提高配額。需要能連線至託管端點的網路。
安裝前請注意
資料皆為唯讀,伺服器不會下單交易或修改任何內容。輸出僅供教育研究,不構成財務建議,伺服器不發布預測或推薦。選用 API 金鑰會以 Bearer 權杖送往託管端點,應視為機密。匿名請求依 IP 限流,stdio 代理會把每次工具呼叫即時轉送到遠端服務。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "quantustik": {
      "type": "http",
      "url": "https://quantustik.com/mcp"
    }
  }
}

README

Quantustik MCP server — S&P 500 market data

Quantustik is a market data service for the S&P 500 — prices, fundamentals, SEC filings, insider and Congress trades, macro indicators and market conditions — for investors and AI agents, through a dashboard, a REST API and an MCP server.

The hosted MCP server at https://quantustik.com/mcp (streamable-HTTP) needs no API key. It serves nine tools:

ToolWhat it returns
get_fear_greedCNN Fear & Greed index (0-100)
get_earnings_calendarNext and last earnings dates for a ticker
get_insider_pulseSEC Form 4 insider activity, per ticker or an S&P 500 screener
get_filings_digestSEC 8-K event digest, per ticker or a recent site-wide feed
get_filing_language_diffWhat changed in the prose between a ticker's two most recent 10-K or 10-Q filings
get_institutional_activity13F institutional ownership changes and SC 13D/G activist filings
get_congress_tradesSTOCK Act disclosures from the House Clerk and Senate eFD
list_capabilitiesDiscover all tools and resources
get_startedOnboarding: per-tier quotas and how a free API key raises them

Every value carries its source and as-of date. Quantustik publishes measured data only, with no predictions and no recommendations.

Educational research only — not financial advice. Nothing here is a recommendation to buy or sell any security.

Connect

Clients that support remote streamable-HTTP servers can point straight at https://quantustik.com/mcp. Clients that only support local stdio servers (Claude Desktop, Cursor, Windsurf and others) can use this package, described below. Anonymous use is allowed under a per-IP hourly quota; a free key from quantustik.com/developers raises it.

What this package is

A thin stdio proxy to Quantustik's hosted MCP server. It lets MCP clients that only support local stdio servers (Claude Desktop, Cursor, Windsurf, and others) reach the live, keyless, streamable-HTTP endpoint at https://quantustik.com/mcp.

This package does not implement an MCP server itself, run any model locally, or cache any data. It is a small wrapper around mcp-remote pointed at our hosted endpoint. Every tool call is forwarded live to quantustik.com and answered from the same data and quota system as the hosted endpoint.

If your MCP client supports remote streamable-HTTP servers directly, you don't need this package at all — just point it at https://quantustik.com/mcp. This wrapper exists only for stdio-only clients.

The full tool catalog lives at quantustik.com/developers.

Usage

Claude Desktop / Cursor / Windsurf

Add to your MCP client config (e.g. claude_desktop_config.json):

json
{  "mcpServers": {    "quantustik": {      "command": "npx",      "args": ["-y", "@quantustik/mcp-server"]    }  }}

Command line

bash
npx -y @quantustik/mcp-server

This starts a local stdio MCP server that proxies to https://quantustik.com/mcp. Anonymous use is allowed under a per-IP hourly quota; no setup required.

Optional: raise your quota with an API key

Get a free key at quantustik.com/developers, then set it as an environment variable:

json
{  "mcpServers": {    "quantustik": {      "command": "npx",      "args": ["-y", "@quantustik/mcp-server"],      "env": {        "QUANTUSTIK_API_KEY": "your-key-here"      }    }  }}

Environment variables

VariablePurposeDefault
QUANTUSTIK_API_KEYSent as Authorization: Bearer <key> to raise the anonymous per-IP hourly quota.none (anonymous)
QUANTUSTIK_MCP_URLOverride the remote endpoint (mainly for local development against a non-production instance).https://quantustik.com/mcp

Any additional CLI arguments you pass are forwarded to the underlying mcp-remote proxy (e.g. --debug).

How it works

npx @quantustik/mcp-server runs a small Node script (bin/quantustik-mcp.js) that spawns mcp-remote against https://quantustik.com/mcp using the http-only transport (our endpoint is streamable-HTTP, not SSE). mcp-remote speaks stdio to your MCP client on one side and streamable-HTTP to our server on the other — this package just pins the URL, transport, and optional auth header so you don't have to remember them.

Source

Server implementation (Python, FastMCP): the hosted endpoint's source lives in mcplafed/autoevolve (app/mcp_server.py, server.json). This wrapper repo only contains the thin npm client shown above.

Disclaimer

Market data returned by the Quantustik MCP server is for educational and research purposes only and does not constitute personalized financial advice. Always consult a qualified financial professional before making investment decisions.

License

MIT — see LICENSE.

來源:README.md,提交 dbddaee

工具

8

get_fear_greed

Get the latest Fear and Greed index value. Sourced from the CNN Fear and Greed model, cached and refreshed periodically. Values range 0 (Extreme Fear) to 100 (Extreme Greed). Returns a dict with value (0-100), label (e.g. "fear"), and timestamp, plus `current` ({score, rating, updated_at}), `history`, and the per-component `sub_indicator_scores`.

無需輸入參數。

get_earnings_calendar

Get the earnings calendar (next + last report) for one S&P 500 ticker. Earnings are a scheduled event. This tool surfaces the next-upcoming and last-reported earnings dates and the days until the next one. When no data is available (cold cache + no live source), `available` is false and `next`/`last` are null; treat that as "unknown", not "no earnings". Args: ticker: Stock ticker symbol (e.g. "AAPL", "MSFT", "NVDA"). Case-insensitive. Returns a dict with available, next, last, days_until_next, as_of and disclaimer embedded in the payload.

輸入參數ticker必填

get_insider_pulse

Get SEC Form 4 insider-trading activity — per-ticker detail or S&P 500 screener. Surfaces already-ingested Form 4 filings (the same Form 4 feed behind the market model's `form4` stage) pre-chewed into analytical context so you don't have to parse raw XBRL yourself: buyer role (officer / director / 10% owner), transaction size vs that SAME insider's own historical buy pattern (`size_vs_own_median`, `is_unusually_large` when >=2x their own median), and cluster-buy detection (`is_cluster` — 3+ distinct insiders buying the same ticker within a 10-day window, historically the stronger signal vs a single insider's trade). Every transaction links to its source SEC filing via `accession_url` — verify anything before acting. Two modes: - ticker set: per-ticker view — up to 40 most-recent Form 4 transactions over the trailing year plus `cluster_buy_active`. - ticker omitted: S&P 500 (top-100) screener — tickers with a cluster buy or an unusually-large buy in the last 30 days. An empty `results` list is a valid, honest answer; most weeks most tickers show nothing notable. Read-only surfacing: this is information, not a recommendation. Args: ticker: Optional. Stock ticker for the per-ticker view (e.g. "AAPL"). Omit for the S&P 500 screener. Case-insensitive. Returns per-ticker: ticker, transactions, cluster_buy_active, generated_at, disclaimer. Screener: tickers_scanned, results, generated_at, disclaimer.

輸入參數ticker

get_filings_digest

Get SEC 8-K event digest — per-ticker detail or a site-wide recent feed. New EDGAR ingestion (unlike get_insider_pulse's Form 4 data, which was already ingested): polls 8-K filings and pre-chews each one so you don't have to parse raw filing HTML yourself. Event type comes from the filing's OWN structured SEC Item number(s) — GROUND TRUTH, never LLM-guessed (e.g. Item 5.02 = exec departure/appointment, Item 2.02 = earnings results, Item 2.01 = M&A completion, Item 4.02 = restatement). The `summary` field is a one-line AI narration grounded in the actual filed document text (`summary_source: "llm"`), or a factual sentence built purely from the Item label(s) when no document excerpt was available (`summary_source: "item_labels"`) — never fabricated content either way. Every filing links to its source SEC filing via `accession_url` — verify anything before acting. Two modes: - ticker set: per-ticker view — up to 15 most-recent 8-Ks over the trailing ~6 months. - ticker omitted: site-wide feed — up to 30 most-recent 8-Ks across the S&P 500 (top-100) universe in the trailing ~2 weeks. An empty `filings` list is a valid, honest answer on a quiet news day. Read-only surfacing: this is information, not a recommendation. Args: ticker: Optional. Stock ticker for the per-ticker view (e.g. "AAPL"). Omit for the site-wide recent feed. Case-insensitive. Returns per-ticker: ticker, filings, generated_at, disclaimer. Feed: tickers_scanned, filings, generated_at, disclaimer.

輸入參數ticker

get_filing_language_diff

Get the "Lazy Prices" 10-K/10-Q language diff for one ticker. Compares the two most recent 10-K (year-over-year, default) or 10-Q (quarter-over-quarter) filings' Risk Factors (Item 1A) and MD&A (Item 7 for 10-K, Item 2 for 10-Q) sections, pre-chewed so you don't have to parse raw filing HTML yourself: a real TF-IDF cosine similarity score between the two extracted section texts, plus the top added/removed sentences from a real sentence-level diff, plus a one-line AI summary grounded strictly in those diffed sentences (`summary_source: "llm"`), or a factual sentence built purely from the computed similarity/counts when no LLM is available (`summary_source: "computed"`) — never fabricated either way. Every result links to BOTH source filings via `filings[].accession_url` — verify anything before acting. Cites a known academic finding: Cohen, Malloy & Nguyen (2020), "Lazy Prices", Journal of Finance — YoY changes in 10-K Risk Factors/MD&A language are historically return-predictive. This is a third-party academic result cited for context, NOT a claim or backtest result of this app. An empty `sections` dict is a valid, honest answer when the ticker has fewer than 2 filings of the requested form on file, or a section couldn't be reliably extracted from both filings (known gap: this extractor targets the common modern EDGAR HTML filing format used by large-cap names; older/non-standard filing formats may not extract). Read-only surfacing: this is information, not a recommendation. Args: ticker: Stock ticker (e.g. "AAPL"). Case-insensitive. form: "10-K" (year-over-year, default) or "10-Q" (quarter-over-quarter). Returns: ticker, form, filings (the two compared filings with accession_url), sections (keyed by "risk_factors"/"mda", each with similarity, added_sentences, removed_sentences, summary, summary_source), generated_at, disclaimer.

輸入參數formticker必填

get_institutional_activity

Get 13F whale summaries + SC 13D/G activist alerts for one ticker. Final slice of the SEC EDGAR AI-digest layer. Two surfaces in one payload: `whale_summary` — QoQ (quarter-over-quarter) change in institutional ownership across a curated ~50-filer 13F universe (activist funds, quant shops, mega index managers, tiger cubs, sovereign wealth, etc.): new positions opened, positions closed, and the largest increases/decreases by dollar value between the two most recent 13F quarters on file. Pure computed deltas — no LLM narration, just real numbers. Institutional filer names come from SEC's own submissions data (ground truth), and every filer row links to its source 13F accession via `accession_url`. When there's genuinely nothing to compute (ticker not held by any tracked filer, or fewer than 2 quarters on file), the `narration` field says so plainly instead of a fabricated result. A filer only ever appears in `closed_positions` when there is an actual filing from that filer covering the latest quarter that omits this ticker's cusip; a filer simply absent from the latest snapshot with no filing on file for that quarter at all lands in `no_recent_filing` instead — never treated as a sale. Absence of a filing is not evidence of a sale. `activist_alerts` — recent Schedule 13D (activist/control intent) and 13G (passive >5% stake) filings. 13D entries carry a one-line AI summary grounded STRICTLY in the filing's own Item 4 ("Purpose of Transaction") text when it can be confidently extracted (`summary_source: "llm"`) — never an invented intent; otherwise a factual fallback sentence (`summary_source: "item_label"`). 13G entries get a structured, non-AI note (`summary_source: "structured"`) since 13G is reserved for passive filers with nothing to narrate beyond the threshold crossing. Every alert links to its source filing via `accession_url`. Read-only surfac

輸入參數ticker必填

list_capabilities

List all available Quantustik MCP tools and resources. Use this as the entry point when a user asks what can you do with Quantustik, or to discover the full surface area of the server. Returns a structured description of every tool and resource.

無需輸入參數。

get_started

Onboard to the Quantustik API/MCP: anonymous access and quotas. No API key is needed — every tool is callable right now under an anonymous per-IP hourly cap. Returns the live keyless/free-key request quotas (pulled live from server config) plus the optional key-issuance URL and auth header format. Pure informational — no auth required to call it.

無需輸入參數。

版本歷史

2
  1. v2.2.0最新Oct 25, 2026
  2. v2.0.4Sep 16, 2026

評分

已滿足適用檢查項的 100%

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

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