Skip to main content
Glama
tossinvest-mcp

tossinvest-mcp

by clauzewitz

get_market_indicator_prices

Read-onlyIdempotent

Retrieve current KOSPI and KOSDAQ index values and Korean government bond yields across 2Y–30Y maturities to support market indicator analysis.

Instructions

국내 지수(KOSPI·KOSDAQ)와 한국 국채 금리(2·3·5·10·20·30년) 현재가를 조회한다.

국채 값은 수익률(%)이다. 해외 지수는 제공되지 않는다.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "symbols": "<symbols>"
    },
    "name": "get_market_indicator_prices"
  }
}

Input Schema

NameRequiredDescriptionDefault
symbolsYes지표 심볼 목록 (예: [KOSPI, KOSDAQ])

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, and openWorldHint, so safety/idempotency is covered. The description's addition that bond values are yields in percent (%) is genuinely useful behavioral context absent from schema and annotations. However, it says nothing about quote freshness (live vs. delayed vs. last close), which matters for a 'current price' tool.

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?

Three short sentences, front-loaded with the covered instruments, then the unit caveat, then the exclusion. Every line carries information and nothing is padded.

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 no output schema, the description should convey the return shape and quote timing. It does clarify the unit for bonds but leaves the response format (per-symbol mapping vs. list) and real-time/delay characteristics unspecified.

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 100% and the enum lists all eight symbols, so the baseline is 3; the description earns a bump by explaining that the KR_BOND_* symbols return yields (%) rather than prices, which is domain meaning the enum alone does not convey.

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?

The Korean description names a specific verb (조회한다) and precisely scopes the resource to domestic indices (KOSPI·KOSDAQ) and Korean bond yields (2/3/5/10/20/30Y). The explicit exclusion '해외 지수는 제공되지 않는다' separates it from siblings like get_prices (single stock quotes) and get_market_indicator_candles (historical series), though it never names those alternatives directly.

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

Usage Guidelines3/5

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

Usage is implied by scope: call it for current index levels or bond yields, and don't call it for overseas indices. There is no explicit when-to-use/when-not guidance against the closest siblings (get_prices, get_market_indicator_candles), so an agent must still infer which tool to pick for a time-series versus a snapshot.

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