# io.github.SheldonZhuang/stock-sentinel (npm · stock-sentinel-mcp)

US stock attack/defense macro signals: 4-dimension framework, 26-year backtested. Research only.

- Trust score: 66/100 (medium)
- Change this week: +20
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `stock-sentinel-mcp`: 66/100 (this document), [markdown](https://verifymcp.io/servers/sheldonzhuang-stock-sentinel/stock-sentinel-mcp.md), [page](https://verifymcp.io/servers/sheldonzhuang-stock-sentinel/stock-sentinel-mcp)

## Channel facts

- Registry: `npm`
- Package: `stock-sentinel-mcp`
- Version: `1.0.3`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 19 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (fair).
  - Tool/resource definitions use about 645 tokens (~107/item across 6 items; 6 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add sheldonzhuang-stock-sentinel -- npx -y stock-sentinel-mcp
```

### Codex

```bash
codex mcp add sheldonzhuang-stock-sentinel -- npx -y stock-sentinel-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sheldonzhuang-stock-sentinel": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "stock-sentinel-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sheldonzhuang-stock-sentinel --command npx --arg -y --arg stock-sentinel-mcp
```

### Hermes

```yaml
mcp_servers:
  sheldonzhuang-stock-sentinel:
    command: "npx"
    args: ["-y", "stock-sentinel-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "sheldonzhuang-stock-sentinel": {
      "command": "npx",
      "args": [
        "-y",
        "stock-sentinel-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 65, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] Schema quality: unverified → fair
- [functional] Licence: MIT

### 2026-08-01 (score 21, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 28, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (6)

### `get_current_signal` (~169 tokens)

获取美股当前进攻/防守信号。返回四档最终信号（attack进攻/neutral观望/reduce减仓观望/defense全面防守）、四个维度（AI供需/货币/财政/行政）各自的宽松/中性/收紧状态、以及全部参考指标（联邦基金利率、萨姆规则、联邦支出、WTI油价、EPU不确定性指数、AI模型调用量等）。判定规则：进攻=四维全宽松且无锁；仅单维收紧=减仓观望；双维以上收紧或衰退锁激活=全面防守。仅供研究参考，不构成投资建议。

### `get_signal_history` (~67 tokens)

获取信号历史存档（公开可验证的 track record）：每日的最终档位与四维状态，按日期倒序。可用于回看信号在近期市场事件中的表现。

Input parameters:

- `limit` (integer): 返回天数，默认90，最大365

### `get_ai_chain` (~104 tokens)

获取AI产业链资金流向状态：六个环节（AI大模型→云厂商→AI芯片→存储/光模块→设备封装→电力）按30天相对SPY强弱的排名、当前市场隐含的卡点环节、以及泡沫监测三指标（模型调用量趋势/云厂商资本开支/半导体产出同比，按现金流向排序）。

### `get_stock_percentile` (~145 tokens)

查询个股或ETF：当前价格在历史区间中的百分位（≥80%高位/≤20%低位）、真实市盈率P/E与市销率P/S（SEC EDGAR财报口径）。支持指数别名：US10Y(10年美债收益率)、VIX、SPX、NDX。

Input parameters:

- `endDate` (string): 区间终点 YYYY-MM-DD，默认今天
- `startDate` (string): 区间起点 YYYY-MM-DD，默认3年前
- `symbol` (string, required): 股票代码，如 NVDA、AAPL、QQQ、US10Y

### `get_backtest_summary` (~112 tokens)

获取信号系统的历史回测核心结论：26年月度重放，覆盖6场危机（2000互联网泡沫/2008金融危机/2020新冠/2022加息熊/2025关税战/2026美伊战争）的捕获情况与8段大规模上涨期的捕获率，以及"仅全面防守离场"策略与买入持有的全期对比（年化/最大回撤）。

### `get_daily_report` (~48 tokens)

获取AI生成的每日信号解读（中英双语）：今日档位、由哪些维度和数据驱动、距离进攻/防守的条件差距。

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/sheldonzhuang-stock-sentinel/stock-sentinel-mcp#diagnostics

## Score history

- 2026-08-03: 66
- 2026-08-02: 65
- 2026-08-01: 21
- 2026-07-31: 28
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/stock-sentinel-mcp
- Socket report: https://socket.dev/npm/package/stock-sentinel-mcp
- Repository: https://github.com/SheldonZhuang/StockSentinel
- Changelog RSS feed: https://verifymcp.io/servers/sheldonzhuang-stock-sentinel/stock-sentinel-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/sheldonzhuang-stock-sentinel/stock-sentinel-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/sheldonzhuang-stock-sentinel/stock-sentinel-mcp