Skip to main content
Glama

국내 주식·채권 MCP (Korea Stocks & Bonds)

사업 지표 순위

business_rank
Read-onlyIdempotent

[국내 주식 + 채권 MCP FinQuest] 사업 지표로 회사들 줄 세우기 — 사업보고서 '사업의 내용' 표에서 계산한 지표: 수출 비중 · 최대 고객 매출 비중(고객 집중도) · 평균 가동률 · 판매가격 전년 대비 · 원재료 가격 전년 대비 · 수주잔고÷매출(몇 년치 일감) · 수주잔고 증가율 · 판매 물량/생산능력(증설)/생산실적 증가율 · 향후 투자 계획 금액·매출 대비 · 연구개발비/매출 · 당사 시장점유율. 시장·업종·테마로 좁힘. '수출 비중 높은 회사', '가동률 높은 반도체 회사', '판가 올린 회사', '수주잔고 많은 조선사', '증설 많이 한 회사' 같은 질문에. by 를 비우면 지표 목록.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "business_rank"
  }
}

Input Schema

NameRequiredDescriptionDefault
byNo지표
maxNo지표 값 상한
minNo지표 값 하한
limitNo
themeNo테마 — 사업 설명에 그 말이 나오는 회사만 (예: '방산', '2차전지', 'HBM')
marketNo
industryNo업종 이름 일부 (예: '반도체', '조선')
min_mcapNo시가총액 하한(억원)
ascendingNo낮은 순

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4/5.0
Behavior4/5

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

Annotations already cover read-only, idempotent, non-destructive, closed-world. The description adds substantive context beyond them: the data provenance (계산된 지표 from 사업보고서 '사업의 내용' 표) and inline metric semantics such as 수주잔고÷매출(몇 년치 일감), which tells the agent what the numbers actually mean. It omits coverage caveats (only companies disclosing such tables) and units.

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

Conciseness5/5

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

Purpose is front-loaded in the first clause, then the metric vocabulary, then the filtering scope, then examples, ending with the empty-`by` rule. The long enum enumeration earns its space because it defines the parameter domain; no filler sentences.

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

Completeness3/5

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

With 9 parameters, no output schema, and only light annotations, the description handles the metric vocabulary and filters well but never says what a result row contains (company + metric value + market + fiscal year?) or the default sort direction when `ascending` is omitted. Enough to call it, not quite enough to predict the response shape.

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

Parameters4/5

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

Schema coverage is 78%, so the baseline is 3, but the description meaningfully maps Korean metric concepts onto the `by` enum values (수출 비중, 최대 고객 매출 비중, 평균 가동률, 수주잔고÷매출, 연구개발비/매출, 당사 시장점유율) and explains that market/industry/theme are narrowing filters. It says nothing about `min`/`max`/`limit`/`ascending`, which the schema only partly documents.

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

Purpose4/5

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

States a specific verb and resource ('사업 지표로 회사들 줄 세우기') and enumerates the exact metric family drawn from 사업보고서 '사업의 내용' tables, which makes it clearly distinct from a generic price/valuation ranker. However, it never names the sibling `rank` or `screen` to draw the contrast explicitly, leaving the agent to infer the boundary.

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

Usage Guidelines4/5

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

Gives concrete example questions that should route here ('수출 비중 높은 회사', '수주잔고 많은 조선사', '증설 많이 한 회사'), plus a real usage rule: leaving `by` empty returns the metric list, which is a discovery pattern. It stops short of stating when NOT to use it (e.g. for price/valuation rankings use `rank`).

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources