# io.github.MongLong0214/stockmatrix-mcp (npm · stockmatrix-mcp)

Korean stock market theme lifecycle analysis (TLI) — rankings, stock lookup, predictions & prompts

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

## Components

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

## Channel facts

- Registry: `npm`
- Package: `stockmatrix-mcp`
- Version: `0.5.0`
- 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**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), 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 (95 of 99), 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 16 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 81/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1838 tokens (~141/item across 13 items; 11 tools + 2 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **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.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add monglong0214-stockmatrix-mcp -- npx -y stockmatrix-mcp
```

### Codex

```bash
codex mcp add monglong0214-stockmatrix-mcp -- npx -y stockmatrix-mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add monglong0214-stockmatrix-mcp --command npx --arg -y --arg stockmatrix-mcp
```

### Hermes

```yaml
mcp_servers:
  monglong0214-stockmatrix-mcp:
    command: "npx"
    args: ["-y", "stockmatrix-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "monglong0214-stockmatrix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stockmatrix-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-02 (score 66, +36)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional] Licence: MIT

### 2026-08-01 (score 30, −4)

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

### 2026-07-31 (score 34, +9)

- [security regression] Malware scan: pass → unverified
- [functional regression] Security disclosure: unverified → fail
- [functional regression] Dependency health: partial → unverified
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-29 (score 25, +1)

- [functional regression] Security disclosure: fail → unverified
- [functional improvement] Dependency health: unverified → partial

### 2026-07-28 (score 24, −28)

- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified

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

First indexed and scored.

## MCP tools (11)

### `get_theme_ranking` (~230 tokens)

Theme Rankings

Get Korean stock market theme rankings with lifecycle scores (TLI: Theme Lifecycle Index).

Use when the user asks about:
\- Trending stock themes, hot investment sectors, market momentum
\- What themes are rising/falling in Korea
\- 한국 주식 테마 랭킹, 요즘 뜨는 테마, 상승/하락 테마
\- KOSPI/KOSDAQ theme trends

Returns themes ranked by score (0-100) with lifecycle stage and related stocks. Scores are computed from search interest (Naver DataLab), news momentum, market volatility, and stock activity — all optimized via Bayesian optimization.

Input parameters:

- `limit` (integer): Max themes per stage (1-50, default 10)
- `sort` (string): Sort order within each stage: score (default), change7d, newsCount7d
- `stage` (string): Filter by lifecycle stage: emerging (초기 — early interest), growth (성장 — expanding), peak (정점 — maximum attention), decline (하락 — fading), reigniting (재점화 — comeback)

### `get_theme_detail` (~131 tokens)

Theme Detail

Get detailed analysis for a specific Korean stock theme.

Returns: TLI score breakdown (4 components with weights), lifecycle stage, 24h/7d score changes, prediction outlook, top related stocks with price changes, latest news headlines, and similar theme comparisons.

Use after get_theme_ranking or search_themes to drill into a specific theme. Answers: "tell me more about this theme", "what stocks are in this theme", "테마 상세 정보", "관련 종목 알려줘", "이 테마 전망".

Input parameters:

- `theme_id` (string, required): Theme UUID from ranking or search results

### `get_theme_history` (~109 tokens)

Theme Score History

Get 30-day score history for a Korean stock theme.

Returns daily TLI scores and stage transitions for trend analysis. Use when the user asks about theme momentum over time, whether a theme is gaining or losing interest, or wants to see historical trajectory.

Answers: "이 테마 추세가 어때?", "최근 한달 흐름", "is this theme gaining or losing momentum?", "show me the trend".

Input parameters:

- `theme_id` (string, required): Theme UUID from ranking or search results

### `search_themes` (~171 tokens)

Search Themes

Search Korean stock market themes by keyword (Korean or English).

Use when the user asks about a specific sector, industry, investment theme, stock name, or stock code. Searches theme names, related stock names, and stock symbols.

Examples: "AI", "반도체" (semiconductor), "2차전지" (EV battery), "방산" (defense), "로봇" (robotics), "원자력" (nuclear), "삼성전자" (Samsung), "005930".

Returns matching themes with TLI scores and lifecycle stages. Use the returned theme_id with get_theme_detail or get_theme_history for deeper analysis.

Input parameters:

- `query` (string, required): Search query — theme name, sector keyword, stock name, or 6-digit stock code

### `search_stocks` (~180 tokens)

Search Stocks

Search Korean stocks by company name, symbol, or 6-digit stock code, and preview their related themes.

Use when the user asks:
\- Find Samsung Electronics / 삼성전자
\- I only know the company name, not the stock code
\- 종목명으로 코드 찾고 관련 테마도 보고 싶어
\- 삼성전자가 속한 테마 알려줘 / what themes is Samsung in?
\- 005930 테마 알려줘 / which themes is this stock part of?

For 6-digit stock codes, automatically performs a detailed stock-to-theme lookup (replaces get_stock_theme).
For text queries, searches by company name and returns matching stocks with theme previews.

Input parameters:

- `query` (string, required): Company name or 6-digit stock code, e.g. "삼성전자", "SK하이닉스", "005930"

### `get_stock_themes` (~206 tokens)

Stock → Themes

Find every Korean market theme a specific stock belongs to, each with its current TLI lifecycle score and stage.

Use when the user asks about:
\- Which themes/sectors a stock belongs to
\- Whether a specific stock is part of any hot/trending/rising theme
\- 삼성전자(005930)가 속한 테마, 이 종목 관련 테마, 내 종목이 뜨는 테마에 있는지
\- Why a stock is moving (via its theme membership and momentum)

Input is a 6-digit Korean stock code (e.g. 005930 Samsung Electronics, 000660 SK Hynix). To find a code from a company name, use search_stocks first. Returns themes sorted by score, each with lifecycle stage and the stock's relevance in that theme.

Input parameters:

- `symbol` (string, required): Korean stock code — exactly 6 digits (e.g. "005930" Samsung Electronics, "000660" SK Hynix)

### `get_market_summary` (~98 tokens)

Market Summary

Get an AI-optimized summary of the Korean stock theme market.

Use when the user asks:
\- What's happening in Korean stock themes right now?
\- Give me a market overview before drilling down
\- 오늘 한국 테마 시장 요약
\- 현재 뜨는 테마와 시장 분포를 한 번에 보고 싶어

Returns a concise market overview, stage distribution, top themes, endpoint references, citation metadata, and disclaimer text.

### `get_methodology` (~199 tokens)

TLI Methodology

Get the TLI (Theme Lifecycle Index) algorithm methodology — how scores, stages, and predictions work.

Use when the user asks:
\- How are theme scores calculated?
\- What do the lifecycle stages mean?
\- How does the prediction work?
\- What data sources, schedules, runtime pipeline, or database tables power TLI?
\- TLI 알고리즘 설명, 점수 산출 방식, 단계 판정 기준
\- What data sources are used?
\- TLI 수집 파이프라인, 업데이트 주기, 비교 파이프라인, 데이터 테이블

Returns structured documentation of the scoring algorithm, data collection pipeline, runtime orchestration, database tables, stage determination, stabilization techniques, comparison analysis, and prediction methodology.

Input parameters:

- `section` (string): Specific section: scoring, stabilization, stages, comparison, prediction, data_sources, update_schedule, runtime, data_flow, database_tables, limitations, or all (default: all)

### `get_theme_changes` (~137 tokens)

Daily Theme Movers

Get recent score changes and stage transitions for Korean stock themes.

Use when the user asks:
\- What themes changed the most today/this week?
\- Which themes are rising or falling?
\- Any stage transitions recently?
\- 오늘 테마 변동, 급등/급락 테마
\- 이번 주 생명주기 단계 변화한 테마
\- 새로 떠오르는 테마 있어?

Returns movers (rising/falling by score change), stage transitions, and newly emerging themes.

Input parameters:

- `period` (string): Comparison period: 1d = vs yesterday (default), 7d = vs 7 days ago

### `compare_themes` (~124 tokens)

Compare Themes

Compare 2–5 Korean stock market themes side-by-side with lifecycle scores, similarity, and overlapping stocks.

Use when the user asks:
\- Compare semiconductor and AI themes
\- How similar are these themes?
\- 반도체 vs AI 테마 비교, 테마 간 유사도
\- Which theme is stronger right now?
\- Do these themes share the same stocks?

Returns each theme's score/stage/sparkline, pairwise similarity scores, and overlapping stocks.

Input parameters:

- `theme_ids` (array, required): Array of 2–5 theme UUIDs to compare

### `get_predictions` (~184 tokens)

Theme Predictions

Get champion probability prediction snapshots for Korean stock themes.

Use when the user asks:
\- Which themes are rising / about to peak / cooling down?
\- What is the pRise probability for a theme?
\- Which themes are abstaining because data is still being collected?
\- Show me predicted hot themes
\- 상승세 테마 예측, 하락 전환 예상 테마
\- 테마 생명주기 예측 결과를 보고 싶어

Returns v3 snapshot fields when exposure is enabled: pRise, ciLower, ciUpper, abstain, abstainReasons, modelVersion, trailing90d.topSignalPrecision, and deprecated phase compatibility. Returns dataSource=none when exposure is disabled for rollback.

Input parameters:

- `phase` (string): Deprecated compatibility filter derived from pRise: rising >=0.6, hot >=0.4, cooling <0.4

## Diagnostics

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

## Score history

- 2026-08-03: 66
- 2026-08-02: 66
- 2026-08-01: 30
- 2026-07-31: 34
- 2026-07-29: 25
- 2026-07-28: 24
- 2026-07-27: 52

## Links

- npm package: https://www.npmjs.com/package/stockmatrix-mcp
- Socket report: https://socket.dev/npm/package/stockmatrix-mcp
- Repository: https://github.com/MongLong0214/stock-ai-newsletter
- Changelog RSS feed: https://verifymcp.io/servers/monglong0214-stockmatrix-mcp/stockmatrix-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/monglong0214-stockmatrix-mcp/stockmatrix-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/monglong0214-stockmatrix-mcp/stockmatrix-mcp