stockmatrix-mcp

Official MCP server for StockMatrix (https://stockmatrix.co.kr).

Ask about Korean stock market themes in natural conversation with AI. Track 200+ KOSPI/KOSDAQ investment themes, get daily movers, look up which themes a stock belongs to, compare themes side-by-side, and see predictions — all through Claude, Cursor, or any MCP-compatible AI agent.

Powered by TLI (Theme Lifecycle Index) — a Bayesian-optimized scoring algorithm combining search interest, news momentum, market volatility, and stock activity into a 0-100 score with lifecycle stage classification.

11 tools + 4 one-click workflow prompts + live resources. Try the market_briefing slash command for an instant Korean market overview.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "stockmatrix": {
      "command": "npx",
      "args": ["-y", "stockmatrix-mcp"]
    }
  }
}

Cursor / Windsurf

Add to .cursor/mcp.json or .windsurf/mcp.json:

{
  "mcpServers": {
    "stockmatrix": {
      "command": "npx",
      "args": ["-y", "stockmatrix-mcp"]
    }
  }
}

VS Code / Claude Code

Add to .vscode/mcp.json:

{
  "servers": {
    "stockmatrix": {
      "command": "npx",
      "args": ["-y", "stockmatrix-mcp"]
    }
  }
}

Try Asking

After setup, just ask in natural language:

Available Tools

get_theme_ranking

Get theme rankings by lifecycle stage with limit and sort options.

get_market_summary

Get an AI-optimized market overview with top themes (includes themeId for chaining).

get_theme_changes

Get daily or weekly score movers, stage transitions, and newly emerging themes.

compare_themes

Compare 2-5 themes side-by-side with scores, stocks, sparklines, and similarity.

get_predictions

Get themes predicted to rise, peak, or cool based on historical analog matching.

search_themes

Search themes by keyword, stock name, or stock code.

search_stocks

Search stocks by company name or 6-digit code, with related theme preview. Automatically performs stock-to-theme lookup for 6-digit codes.

get_stock_themes

Reverse lookup — every theme a stock belongs to, ranked by theme score, each with lifecycle stage and the stock's relevance. Answers "is my stock in a hot theme?"

get_theme_detail

Get detailed analysis: score breakdown (4 components), stage, prediction, stocks, news, comparisons.

get_theme_history

Get 30-day score history for trend analysis.

get_methodology

Get TLI algorithm documentation — scoring, stages, stabilization, comparison, prediction, data sources, and more.

Tip: Use section=scoring to get just the scoring algorithm and save context tokens.

Workflow Prompts

One-click slash commands (in Claude Desktop, Cursor, and other MCP clients) that run complete multi-tool analyses for you — the fastest way to get real value:

Resources

Attachable read-only context (no tool call needed):

Scoring Algorithm

TLI scores (0-100) are a weighted sum of 4 components, optimized via Bayesian Optimization:

Scores are stabilized through Cautious Decay (3-signal majority vote), Bollinger Band Clamp (limits daily change), and Age-adaptive EMA (newer themes react faster).

Lifecycle Stages

Dormant -> Emerging -> Growth -> Peak -> Decline -> Dormant
                                          |
                                     Reigniting

Stage transitions require 2 consecutive days of the same candidate (hysteresis) and follow Markov transition constraints.

Data Coverage

• 200+ themes across KOSPI & KOSDAQ
• Daily updates — scores, news, stock mappings
• Stock ↔ theme lookup — by company name, 6-digit code, or reverse (stock → all its themes)
• AI market summary for first-call overview
• Predictions with historical analog matching
• Workflow prompts — one-click multi-tool analyses
• Sources: Naver DataLab, Naver Finance, Naver News

Configuration

License

MIT

Links

• Website
• Developer Guide
• llms.txt