Skip to main content
Glama
Juuuuuuni

Stock MCP Server

by Juuuuuuni

screen_kr_breakout

Screen Korean stocks in accumulation or near breakout using volume spikes, VCP contraction, and stage 1 transition filters, excluding stocks that have already rallied significantly.

Instructions

한국 주식에서 '곧 달릴 말' — 매집/돌파 직전 단계 종목을 필터링합니다.

screen_kr_momentum과 반대 컨셉. 이미 크게 오른 종목을 배제하고 중간권에서 매집 중인 종목 / 변동성 수축 국면 / Stage 1 말기 종목을 찾습니다.

[시드] 네이버 거래량상위 + 상승률상위 + 급등 합집합 [사전필터] 순차 적용: · 거래대금 · 당일 과열 제외 (exclude_if_up_pct) · 최근 N일 누적 상승률 < max_cumulative_return_pct (아직 안 달림) · 52주 밴드 (고점 × high_ceiling 이하 AND 저점 × low_floor 이상) · 거래량 급증 (기본 2x — momentum의 3x보다 약해도 매집 시그널로 인정) [전략] Breakout 전용 7개

  • 재사용: 눌림목 매수 · 거래량 폭발 · MACD 다이버전스 · BB 스퀴즈

  • 신규: VCP 변동성 수축 · 조용한 매집 · Stage 1 말기 전환

Args: market: 'KOSPI' | 'KOSDAQ' | 'ALL' top_n: 시드 후보 상한 min_trade_value: 최소 거래대금(원) exclude_if_up_pct: 오늘 이 % 이상 오른 종목 제외 (None 미적용) max_cumulative_return_pct: 최근 N일 누적 상승률 상한(%) (기본 30) cumulative_return_days: 누적 상승률 계산 기간 (기본 30) high_ceiling: 52주 고점 대비 상한 비율 (0.85 = 고점의 85% 이하) low_floor: 52주 저점 대비 하한 비율 (1.20 = 저점의 120% 이상) lookback_days: 거래량 급증 룩백 spike_threshold: 거래량 급증 배율 (기본 2.0) baseline_days: 비교 기준 기간

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
marketNoALL
top_nNo
min_trade_valueNo
exclude_if_up_pctNo
max_cumulative_return_pctNo
cumulative_return_daysNo
high_ceilingNo
low_floorNo
lookback_daysNo
spike_thresholdNo
baseline_daysNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description bears full burden. It details the filtering pipeline and logic extensively, but does not explicitly state that the tool is read-only, nor mention any rate limits or side effects. Adequate but not fully covering runtime behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is quite long due to detailed logic and parameter explanations. It is well-structured with sections (seed, pre-filters, strategy) and bullet points, but could be slightly more concise. Still, every sentence earns its place given the tool's complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 11 optional parameters, no annotations, and presence of output schema, the description is comprehensive. It covers input purpose, filtering steps, strategy types, and sibling differentiation. The output schema is present so return values need not be described.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description compensates fully. Every parameter, including market, top_n, thresholds, and periods, is explained with typical values and purpose in the 'Args' section, adding significant meaning beyond the bare schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it filters Korean stocks in the 'breakout-ready' phase, contrasting with screen_kr_momentum. It details the seed sources, pre-filters, and strategies, making the purpose specific and distinct from siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly contrasts with screen_kr_momentum ('반대 컨셉'), explicitly excludes already-strong stocks, and lists dedicated breakout strategies. Provides clear context for when to use this tool over alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Juuuuuuni/stock-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server