opendart-fss-mcp
This MCP server provides programmatic access to Korea's DART (Financial Supervisory Service) corporate disclosure system with 85 tools across 7 categories:
π Disclosure Tools (5) - Smart company search with Korean initial consonant matching (μ΄μ±), fuzzy typo correction, and exact/prefix/substring matching; search and retrieve public disclosures with date/company/type filtering; view company profiles; download original disclosure documents (ZIP files)
π° Financial Tools (7) - Access financial statements (single/multi-company, consolidated/separate); retrieve full statements (balance sheet, income statement, cash flow); analyze financial indicators and ratios; download XBRL files and query taxonomy structure
π Periodic Reports (28) - Stock information (capital changes, dividends, treasury stock, total shares); shareholder data (major/minority shareholders, ownership changes); executive details (directors, employees, individual/aggregate compensation); debt securities (bonds, commercial paper, convertibles); corporate investments; audit information (opinions, contracts); governance (outside directors, fund usage)
π₯ Shareholding (2) - Track major shareholder holdings (5%+ ownership) and executive stock ownership
π Major Events (36) - Monitor capital structure changes, securities issuance (convertible bonds, bonds with warrants, exchangeable bonds), M&A (mergers, splits, split-mergers, stock exchanges), asset transactions, stock transactions, treasury stock operations, corporate distress (defaults, business suspensions, rehabilitation, dissolution), creditor management, litigation, overseas listing/delisting, and contingent capital instruments
π Securities Registration (6) - Access registration statements for equity/debt securities, mergers, splits, depositary receipts, and stock exchange transfers
π οΈ Utilities (1) - Current date/time in Korea Standard Time (KST)
Key Features: Multi-company comparison (up to 20 companies), 6-tier intelligent Korean search with chosung matching ("γ γ γ γ " β μΌμ±μ μ), fuzzy typo correction ("μΌμ μ μ" β μΌμ±μ μ), mixed Korean/English search ("γ γ SDI" β μΌμ±SDI), flexible deployment as stdio or HTTP server, compatible with Claude Desktop, Claude Code, and any MCP client.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@opendart-fss-mcpGet the 2023 annual financial statements for Samsung Electronics"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
opendart-fss-mcp
MCP server for Korea's DART (Financial Supervisory Service) corporate disclosure API.
What is OpenDART?
DART (Data Analysis, Retrieval and Transfer System) is Korea's equivalent of the SEC's EDGAR system. It is the official electronic disclosure system operated by the Financial Supervisory Service (FSS) where all Korean corporations submit their financial reports, major event disclosures, and shareholding information.
OpenDART provides a public API to access this data programmatically.
Related MCP server: OpenDART MCP Server
Features
85 tools covering 7 categories β disclosure search, financial statements, periodic reports, shareholding, major events, securities registration, and utilities
Runs as a stdio or HTTP (Streamable HTTP) MCP server
Works with Claude Desktop, Claude Code, and any MCP-compatible client
Smart company search β 6-tier search with Korean initial consonant (chosung) matching and fuzzy typo correction
"μΌμ±μ μ"exact match,"μΌμ±"prefix,"μ μ"substring"γ γ γ γ "chosung β μΌμ±μ μ,"γ γ SDI"mixed β μΌμ±SDI"μΌμ μ μ"fuzzy β μΌμ±μ μ
Built on FastMCP and opendart-fss SDK
Prerequisites
Python 3.14+
uv (recommended package manager)
OpenDART API Key β get one free at opendart.fss.or.kr
Installation
uv pip install opendart-fss-mcpOr install from source:
git clone https://github.com/hypn4/opendart-fss-mcp.git
cd opendart-fss-mcp
uv syncConfiguration
Copy .env.example to .env and set your values:
cp .env.example .envVariable | Description | Default |
| OpenDART API key (required) | β |
| Transport protocol: |
|
| HTTP bind address |
|
| HTTP port |
|
| Log level: |
|
Usage
Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json):
From PyPI:
{
"mcpServers": {
"opendart": {
"command": "uvx",
"args": [
"--from", "opendart-fss-mcp",
"opendart-mcp"
],
"env": {
"OPENDART_API_KEY": "your_api_key_here"
}
}
}
}From source:
{
"mcpServers": {
"opendart": {
"command": "uv",
"args": [
"run",
"--directory", "/path/to/opendart-fss-mcp",
"opendart-mcp"
],
"env": {
"OPENDART_API_KEY": "your_api_key_here"
}
}
}
}Claude Code
From PyPI:
claude mcp add opendart -e OPENDART_API_KEY=your_api_key_here -- uvx --from opendart-fss-mcp opendart-mcpFrom source:
claude mcp add opendart -e OPENDART_API_KEY=your_api_key_here -- uv run --directory /path/to/opendart-fss-mcp opendart-mcpCLI
# stdio mode (default)
opendart-mcp
# HTTP mode
opendart-mcp --transport http --host 127.0.0.1 --port 8000FastMCP
fastmcp run src/opendart_fss_mcp/server.py:mcpExample Prompts
Show me Samsung Electronics' 2024 consolidated financial statements
Compare revenue and operating profit for Samsung, SK Hynix, and LG Electronics in 2023
Who are the largest shareholders of Hyundai Motor?
What dividends did Samsung pay last year?
Search for M&A-related disclosures from January to June 2024
Has Samsung announced any convertible bond issuances recently?
Show me the executive compensation for POSCO Holdings
What is the auditor's opinion on Kakao's financial statements?
Available Tools
85 tools organized into 7 categories:
Category | Prefix | Tools | Description |
Disclosure |
| 5 | Company search, disclosure list, document viewer |
Financial |
| 7 | Financial statements (single/multi account, XBRL) |
Report |
| 28 | Periodic report key items (compensation, capital, directors, etc.) |
Shareholding |
| 2 | Major shareholder and executive holdings |
Major Events |
| 36 | M&A, capital changes, stock events, lawsuits, and more |
Registration |
| 6 | Securities registration statement details |
Utility |
| 1 | Current date/time (KST) |
Development
# Install dev dependencies
uv sync
# Run tests
uv run pytest
# Lint & format
uv run ruff check .
uv run ruff format .
# Type check
uv run pyrightLicense
MIT
Links
OpenDART β Official OpenDART API portal
DART β Electronic Disclosure System
opendart-fss β Python SDK for OpenDART API
Available Tools
85 toolsdisclosure_companyBRead-only
κΈ°μ κ°ν© μ 보λ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description adds no further behavioral context (e.g., data freshness, pagination). With annotations present, a score of 3 is appropriate as the description does not contradict them but also adds minimal value.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that clearly states the purpose. No wasted words, front-loaded, and efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the single parameter, presence of output schema (not shown), and simple lookup nature, the description is sufficient. It could mention the output type but is not necessary if the output schema is available.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage; the parameter 'corp_code' is described in the schema as 'κ³ μ λ²νΈ (8μ리)' (unique number, 8 digits). The description does not add extra meaning beyond the schema, so baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it retrieves company overview information, distinguishing it from sibling tools focused on specific disclosures or events. However, it could specify what 'overview' includes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus the many sibling tools like disclosure_search or financial_full_statements. The description does not mention alternatives or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
disclosure_corp_codesBRead-only
κ³ μ λ²νΈ λͺ©λ‘μ λ‘λνκ³ μμ½ μ 보λ₯Ό λ°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint=true and openWorldHint=true, so the description is not required to add much. The description repeats the load-and-summarize functionality but does not add new behavioral insights beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no fluff. However, it could be slightly more informative without being verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero parameters and the presence of an output schema, the description provides sufficient information for an agent to understand the tool's purpose. It might benefit from hinting that it is used to obtain codes for subsequent queries, but overall adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
No parameters exist, so the description cannot add semantic meaning beyond the input schema. Schema description coverage is 100%, thus baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it loads a list of unique IDs and returns summary information, distinguishing it from other disclosure tools that search or retrieve specific records. However, the phrase 'summary information' is somewhat vague.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternative tools like disclosure_search or event_* tools. It does not provide context for preferred use cases or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
disclosure_documentARead-only
곡μ μλ¬Έ λ¬Έμλ₯Ό λ€μ΄λ‘λν©λλ€. ZIP νμΌμ λ°μ΄νΈλ₯Ό λ°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| rcept_no | Yes | μ μλ²νΈ (14μ리) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark the tool as read-only (readOnlyHint=true) and open-world. The description adds that the tool returns ZIP file bytes but does not disclose additional behavioral traits beyond what annotations provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short, front-loaded sentences with no redundancy. Every word is necessary and the description is efficiently structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple download tool with one parameter and an output schema, the description is complete. It covers the action, return format, and is supported by annotations and schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single parameter 'rcept_no', which is described as a 14-digit receipt number. The tool description adds no further semantic meaning to the parameter, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool downloads the original disclosure document and returns the bytes of a ZIP file. It uses a specific verb 'λ€μ΄λ‘λ' and resource '곡μ μλ¬Έ λ¬Έμ', distinguishing it from sibling tools that deal with search or company info.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not explicitly state when to use this tool versus alternatives like disclosure_search. It implies usage when a receipt number is known, but lacks when-not-to-use or explicit alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
disclosure_searchCRead-only
곡μ μ 보λ₯Ό κ²μν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | No | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) | |
| last_reprt_at | No | μ΅μ’ λ³΄κ³ μ κ²μμ¬λΆ (Y/N) | |
| pblntf_ty | No | 곡μμ ν (A~J) | |
| pblntf_detail_ty | No | 곡μμμΈμ ν | |
| corp_cls | No | λ²μΈκ΅¬λΆ (Y:μ κ°, K:μ½μ€λ₯, N:μ½λ₯μ€, E:κΈ°ν) | |
| sort | No | μ λ ¬ν€ (date, crp, rpt) | |
| sort_mth | No | μ λ ¬λ°©λ² (asc, desc) | |
| page_no | No | νμ΄μ§ λ²νΈ | |
| page_count | No | νμ΄μ§ λΉ κ±΄μ |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint and openWorldHint. The description adds no additional behavioral context such as pagination, sorting, or response structure. It does not contradict annotations, but fails to add value beyond them.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no wasted words. It is efficient but could be slightly expanded to include usage context without harming conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 11 parameters and an output schema, the description is too minimal. It does not clarify the tool's scope relative to siblings or mention pagination/open-world implications, leaving gaps for effective invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so all parameters are documented in the schema. The description adds no extra meaning; thus it meets the baseline but does not exceed it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Searches disclosure information' clearly states the tool's action and resource. However, it does not distinguish it from sibling tools like disclosure_company or disclosure_document, which also search disclosure-related data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. With many sibling tools covering specific disclosure types, the description should indicate that this is a general search for all disclosures.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
disclosure_search_companyARead-only
νμ¬λͺ λλ μ’ λͺ©μ½λλ‘ κ³ μ λ²νΈ(corp_code)λ₯Ό κ²μν©λλ€.
λ€λ₯Έ λꡬμμ corp_codeκ° νμν λ, λ¨Όμ μ΄ λκ΅¬λ‘ νμ¬λ₯Ό κ²μνμΈμ.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | νμ¬λͺ λλ μ’ λͺ©μ½λ (μ: 'μΌμ±μ μ', '005930') | |
| max_results | No | μ΅λ κ²°κ³Ό μ | |
| listed_only | No | μμ₯νμ¬λ§ κ²μ |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Description adds behavioral context beyond annotations by explaining that it is a lookup tool returning corp_code and serving as a preliminary step. Annotations already declare readOnlyHint=true, so no contradiction; description complements well.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the key purpose, and every word adds value. No redundancy or wasted text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With output schema present, description does not need to detail return values. It covers purpose, usage, and prerequisites sufficiently, leaving parameter details to schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so parameters are well-documented. The tool description does not add additional meaning to parameters beyond what schema provides, meeting baseline for high coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it searches for corp_code by company name or stock code, which is a specific verb-resource combination. It also distinguishes itself from siblings by noting it is a prerequisite for other tools needing corp_code.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says 'When you need corp_code from other tools, first search the company with this tool,' providing clear indication of when to use it. No explicit when-not or alternatives, but context is sufficient.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_asset_transferBRead-only
μμ μμλ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint and openWorldHint, so the description adds minimal behavioral context. It does not explain what the data represents or any side effects, but it does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, concise sentence that front-loads the purpose. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is minimal but an output schema exists; however, it could provide more context about the business transfer decision (e.g., what data fields are returned) to improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the description does not need to add extra parameter info. It offers no additional semantics beyond the schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('μ‘°νν©λλ€' = inquire) and the specific resource ('μμ μμλ κ²°μ ' = business transfer decision). It is distinct from sibling tools which cover other event types.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No indication of when to use this tool versus siblings or any context about prerequisites or typical scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_bond_with_warrantBRead-only
μ μ£ΌμΈμκΆλΆμ¬μ± λ°ν κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the description's verb 'μ‘°νν©λλ€' (inquire) is consistent but adds no new behavioral insight. The description does not disclose additional traits like rate limits, default date handling, or result pagination, but given the annotations, this is acceptable.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence that efficiently conveys the core purpose. No word is wasted, though it could be slightly expanded to include usage context without harming conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and annotations, the description covers the basic purpose but lacks usage guidelines to help the agent decide when to invoke this tool among many similar event tools. The completeness is adequate for a simple query but not fully robust.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All three parameters are described in the input schema with 100% coverage. The description itself adds no additional meaning or context about parameters (e.g., how date filters work), so it provides no value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('μ‘°νν©λλ€' = inquire) and the specific resource ('μ μ£ΌμΈμκΆλΆμ¬μ± λ°ν κ²°μ ' = decision to issue bonds with warrants). This precise resource name differentiates it from numerous sibling tools that deal with other financial events, achieving high distinctiveness.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. Given the large number of sibling tools for similar events (e.g., event_convertible_bond, event_bonus_issue), the description would benefit from indicating the appropriate context or conditions for use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_bonus_issueBRead-only
무μμ¦μ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint=true and openWorldHint=true. The description ('μ‘°νν©λλ€') is consistent but adds no additional behavioral context such as rate limits or data freshness.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single-sentence description is concise and front-loaded, with no unnecessary words. However, it is so brief that it may sacrifice completeness for conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the existence of an output schema and annotations, the description is minimally complete. However, for a tool with many siblings and three parameters, more context about the data scope or typical use could be beneficial.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so description need not repeat parameter details. However, it adds no extra meaning beyond the schema, meeting the baseline of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'μ‘°ν' (inquire) and the resource '무μμ¦μ κ²°μ ' (bonus issue decision), distinguishing it from sibling tools like event_paid_capital_increase or event_stock_exchange_decision.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. With many sibling event tools, the agent could benefit from usage context, but none is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_business_acquisitionBRead-only
μμ μμ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the description confirms a read-only operation. However, it doesn't add details beyond annotations (e.g., no mention of data source, rate limits, or that it queries historical decisions).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence that is front-loaded with the action. It is concise, but could add a bit more context without losing efficiency.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and the simplicity of the tool (query with corp_code and optional date range), the description is minimally sufficient. It does not explain what information is returned, but the output schema likely covers that.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so parameters are already well-documented. The description adds no additional meaning to the parameters (e.g., no hints on usage or format beyond the schema).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('μ‘°νν©λλ€' meaning 'query/retrieve') and a clear resource ('μμ μμ κ²°μ ' = business acquisition decisions), distinguishing it from sibling tools like 'event_business_disposal' or 'event_asset_transfer'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives (e.g., other event tools). The description only states what it does, not when or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_business_disposalCRead-only
μμ μλ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, which the description's 'μ‘°νν©λλ€' (inquiry) supports. However, the description adds no extra behavioral context beyond what annotations provide, such as data scope or limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence, which is concise but lacks detail. It is front-loaded with the action, but the brevity limits its informativeness. A slightly more elaborate description could improve clarity without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite the existence of an output schema and 100% parameter coverage, the description is very minimal. Given the large set of similar event_* sibling tools, more context about what a 'business disposal decision' entails or how results are structured would aid selection. The current description is incomplete for the complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers 100% of parameters with clear descriptions (e.g., 'κ³ μ λ²νΈ (8μ리)' for corp_code). The description does not add further meaning beyond the schema, so baseline score applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The Korean description 'μμ μλ κ²°μ μ μ‘°νν©λλ€' communicates that the tool is for inquiring about business transfer decisions. However, it does not explicitly distinguish itself from sibling tools like event_business_acquisition or event_asset_transfer, relying on the name for differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. There is no mention of context, prerequisites, or exclusions, leaving the agent to infer usage from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_business_suspensionBRead-only
μμ μ μ§λ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, so the description does not need to repeat that. It adds no extra behavioral context, such as data freshness or pagination, but given the annotations, the minimum is met without contradiction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise, consisting of a single sentence. While it is efficient, it could be slightly more informative, but it is not overly verbose. Front-loading is not an issue due to brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (three parameters, output schema exists, annotations cover read-only), the description is adequately complete for a basic lookup. However, it does not explain the context of 'business suspension' or what the output contains beyond what is in the output schema, leaving some room for improvement.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage for all three parameters, including format hints. The description does not add any additional meaning or context beyond what is already in the schema, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it inquires about business suspension, using a specific verb and resource. However, it does not distinguish this tool from many sibling event_* tools that also perform inquiries about various events, so it lacks differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus alternatives or any context about prerequisites. The description fails to indicate scenarios where this tool is appropriate compared to siblings like event_business_acquisition or event_business_disposal.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_capital_reductionARead-only
κ°μ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the description does not need to restate safety. However, it adds no additional behavioral context such as pagination, result count limits, or data source details. The description is adequate but does not enhance understanding beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one sentence, which is efficient and to the point. However, it could be slightly more informative without being verbose. Given the simplicity of the tool, this level of conciseness is acceptable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With full schema coverage and an output schema (not shown), the description does not need to explain returns. The description is complete enough for a basic query tool, though adding a note about typical use cases or result interpretation would improve it further.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all three parameters are already documented. The tool description does not add any new meaning or usage hints for the parameters beyond what the schema provides. Baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries capital reduction decisions. It uses a specific verb ('μ‘°νν©λλ€' meaning 'queries') and identifies the resource ('κ°μ κ²°μ '). This distinguishes it from siblings which handle other corporate events.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage when capital reduction decision data is needed, but it does not explicitly compare against sibling tools or state when not to use it. No exclusion criteria or alternative recommendations are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_convertible_bondARead-only
μ νμ¬μ± λ°ν κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description merely restates the query action, adding no extra behavioral context such as data scope or limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence that is perfectly concise and front-loaded. No unnecessary words, and it communicates the core purpose immediately.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description need not explain return values. It adequately covers the purpose, though it could briefly mention date range filtering for completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The description does not add any parameter semantics beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool queries convertible bond issuance decisions, with specific verb 'μ‘°ν' (query) and resource 'μ νμ¬μ± λ°ν κ²°μ '. It distinguishes from sibling tools like event_bond_with_warrant and event_exchangeable_bond.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool vs alternatives. The description only states what it does, leaving it to the agent to infer from the tool name and context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_creditor_management_startARead-only
μ±κΆμκ΄λ¦¬μ μ°¨ κ°μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds no behavioral details beyond what annotations already provide (readOnlyHint=true, openWorldHint=true). It confirms it's a read operation but does not disclose pagination, date range behavior, or error handling. No contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no fluff. It is appropriately sized and front-loaded, conveying the core purpose efficiently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, the description is minimally adequate. However, it does not explain the scope of the inquiry (e.g., which companies or time periods) or any constraints. More detail would be helpful given the large number of sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents all three parameters (corp_code, bgn_de, end_de). The description does not add any additional meaning or context to the parameters beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's specific purpose: 'Inquires the start of creditor management procedure.' It uses a specific verb ('μ‘°νν©λλ€' - inquires) and resource ('μ±κΆμκ΄λ¦¬μ μ°¨ κ°μ' - start of creditor management procedure), distinguishing it from its sibling tool 'event_creditor_management_stop' which handles the stop of the procedure.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, such as when to choose it over other event-related tools. There is no mention of prerequisites, context, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_creditor_management_stopBRead-only
μ±κΆμκ΄λ¦¬μ μ°¨ μ€λ¨μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description states 'μ‘°νν©λλ€' (inquires), which aligns with read-only behavior. However, it adds no further behavioral context beyond what annotations provide, such as auth needs or data freshness.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that front-loads the verb. It has zero wasted words and is appropriately sized for a simple query tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and 100% schema coverage, the description provides sufficient context about the tool's purpose. It could mention the date range filtering implied by parameters, but the schema handles that. Overall, it is adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters (corp_code, bgn_de, end_de). The description adds no additional meaning or constraints beyond the schema, achieving the baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool inquires about the suspension of creditor management procedures ('μ±κΆμκ΄λ¦¬μ μ°¨ μ€λ¨μ μ‘°νν©λλ€'). It uses a specific verb ('μ‘°νν©λλ€' = inquire) and identifies a distinct resource ('μ€λ¨' = suspension) that distinguishes it from siblings like event_creditor_management_start.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives such as event_creditor_management_start or other event tools. There is no mention of prerequisites, exclusions, or context for using the tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_default_occurrenceBRead-only
μ±λ¬΄λΆμ΄νμ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description adds no behavioral details beyond 'inquires,' but annotations cover the safety profile adequately.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence without redundancy. However, it could benefit from slight expansion for clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema provided, return values are documented. The description, while minimal, covers the basic purpose. No critical gaps given the tool's simplicity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and already describes parameters (corp_code, dates). The description adds no parameter-level meaning, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'μ±λ¬΄λΆμ΄νμ μ‘°νν©λλ€.' (Inquires about default) identifies the resource as default but is vague; it doesn't specify what type of default (e.g., debt default) or that it queries occurrences.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage context is provided. There are many sibling event tools (e.g., event_merger_decision) with no guidance on when to use this tool over others.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_dissolution_reasonCRead-only
ν΄μ° μ¬μ λ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, so the agent knows this is a read operation. However, the description adds no further behavioral details (e.g., scope, pagination, or response format) that would aid in tool selection.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, focused sentence with no wasted words. It is appropriately front-loaded and clear, though minimal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and the simplicity of the tool (3 parameters, no nested objects), the description is adequate but could be improved by mentioning what the output contains or the scope of the query.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers all three parameters with descriptions (corp_code, bgn_de, end_de) at 100% coverage. The description adds no additional meaning beyond what the schema provides, warranting the baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'ν΄μ° μ¬μ λ₯Ό μ‘°νν©λλ€' which clearly indicates the tool retrieves dissolution reasons. It distinguishes itself from sibling event_* tools by specifying the resource (dissolution reason) and action (inquiry).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives (e.g., other event query tools like event_merger_decision). There is no mention of context or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_exchangeable_bondBRead-only
κ΅νμ¬μ± λ°ν κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true. The description 'μ‘°νν©λλ€' is consistent with read-only, but it adds no additional behavioral traits (e.g., data scope, pagination, or permissions) beyond what annotations imply.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is concise and front-loaded with the core purpose. There is no redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema exists, the description does not need to detail return values. However, it lacks context about effective usage of the optional parameters and how the tool fits among many siblings, making it minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description does not add any extra meaning to the parameters beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'μ‘°νν©λλ€' (inquire) and the resource 'exchangeable bond issuance decision', which is specific and distinguishes it from siblings like event_convertible_bond. However, it does not explicitly differentiate usage from other similar event tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. The sibling list includes many event-related tools, but the description does not mention any context or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_litigationCRead-only
μμ‘μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description adds no behavioral context beyond confirming it's a read operation. No mention of pagination, rate limits, or data volume specifics.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence. It is concise but may be too minimal to convey adequate information about the tool's scope.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be explained. However, given the broad set of sibling tools, the description lacks context on what litigation events are included, making it only minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% (all three parameters described). The description does not add any meaning beyond the schema, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the tool queries litigation (μμ‘μ μ‘°νν©λλ€), which is a clear action and resource. However, it does not differentiate from many sibling event_* tools that also query specific events, so the purpose is generic.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool vs alternatives like other event queries. With many sibling tools, explicit usage guidance is missing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_merger_decisionCRead-only
ν©λ³ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, but the description adds no behavioral context beyond that. It does not mention potential limitations or response characteristics.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that gets to the point. It could be more informative without being verbose, but it efficiently states the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the large sibling set and the presence of a related tool (event_split_merger_decision), the description fails to provide sufficient context for an AI agent to reliably choose this tool. It does not explain the scope of 'merger decision' or differentiate from similar tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with descriptions for all parameters. The tool description does not add parameter-level meaning, which is acceptable given the schema already provides it. Baseline score of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'ν©λ³ κ²°μ μ μ‘°νν©λλ€.' (Inquires merger decision) clearly states the verb and resource, distinguishing it from siblings with different event types. However, it lacks specifics about what data is returned or how it relates to other merger-related tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool vs alternatives. The schema implies date range filtering, but the description offers no situational advice or exclusionary language.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_mixed_capital_increaseARead-only
μ 무μμ¦μ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations include readOnlyHint=true and openWorldHint=true, which indicate safe reading and possibly incomplete results. The description does not add behavioral details beyond stating it's an inquiry, but annotations already cover the safety aspect.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no extraneous information. It is concise and to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, good annotations, and full parameter descriptions, the description is adequate. It could benefit from specifying typical use cases but is otherwise complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage for all three parameters. The tool description adds no additional meaning beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'μ 무μμ¦μ κ²°μ μ μ‘°νν©λλ€.' clearly states the tool queries decisions on mixed capital increase, a specific corporate event. It is distinct from sibling tools like 'event_paid_capital_increase' and 'event_bonus_issue'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. No prerequisites, exclusions, or context are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_other_corp_stock_acquisitionARead-only
νλ²μΈ μ£Όμ λ° μΆμμ¦κΆ μμ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint and openWorldHint. The description adds no additional behavioral context (e.g., data freshness, permission needs, error states). It does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence that is concise and front-loaded. No unnecessary words; it efficiently communicates the tool's purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema exists, the description does not need to explain return values. However, it lacks any mention of scope, limitations, or typical use cases. Still, for a simple query tool, it is reasonably complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and parameters are well-documented in the schema. The description adds no extra meaning beyond what the schema provides, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it inquires decisions to acquire stocks/securities of other corporations, using a specific verb and resource. It distinguishes from siblings like event_other_corp_stock_disposal (disposal) and event_business_acquisition (different scope).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, no exclusions or context provided. The description only states what it does without helping the agent decide among many sibling event tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_other_corp_stock_disposalARead-only
νλ²μΈ μ£Όμ λ° μΆμμ¦κΆ μλ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true; description adds no behavioral details beyond confirming it is a retrieval. No contradiction, but minimal added value.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no waste. Efficiently conveys purpose, though could be slightly more informative without harming conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given output schema exists and annotations cover safety, description is adequate for a simple retrieval tool. It does not explain date range or corp_code necessity (covered by schema), but is complete enough.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers 100% of parameters with descriptions. The tool description adds no extra meaning for parameters; baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it retrieves decisions on disposal of stocks/equity in other corporations (νΉμ verb 'μ‘°ν' and resource). The name contrasts with sibling event_other_corp_stock_acquisition, distinguishing purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. The description only states what it does; usage context is implied by the name and sibling list, but not stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_overseas_delistingBRead-only
ν΄μΈμμ₯νμ§λ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, so the description does not need to disclose that. It adds no further behavioral context, but also does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence with no wasted words. It efficiently conveys the purpose, though it could be expanded slightly for better context.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and annotations, the description is minimally adequate. However, it lacks differentiation from sibling tools and does not clarify the scope of data (e.g., historical events, date range implications).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents all three parameters. The description does not add any additional meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it inquires overseas delisting (ν΄μΈμμ₯νμ§ μ‘°ν), which is a specific verb and resource. It is clear but does not differentiate from the sibling tool 'event_overseas_delisting_decision', which could cause confusion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage guidelines are provided. There is no guidance on when to use this tool versus alternatives like event_overseas_delisting_decision or event_overseas_listing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_overseas_delisting_decisionCRead-only
ν΄μΈμμ₯νμ§ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. Description adds no behavioral details beyond that, such as pagination or data freshness.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single short sentence clearly states the tool's purpose. While concise, it lacks detail for differentiation.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given full schema descriptions and annotations, the description is adequate but fails to distinguish from many sibling tools. No usage hints or return value explanation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema covers all parameters with descriptions (100% coverage). Description does not add extra meaning beyond schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it queries overseas delisting decisions, but does not differentiate from siblings like event_overseas_delisting or event_overseas_listing_decision. The purpose is clear but vague.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like event_overseas_delisting. No exclusion criteria or context provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_overseas_listingCRead-only
ν΄μΈμμ₯μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds no behavioral context beyond what annotations already provide (readOnlyHint=true, openWorldHint=true). It fails to disclose aspects like date range filtering or what entity is queried.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence with no wasted words. It is as concise as possible for the purpose conveyed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Although an output schema exists, the description is too minimalist given the context. It does not clarify what constitutes an 'overseas listing' or how results are structured, especially with many similar sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with descriptions for all 3 parameters. The description adds no extra semantic value beyond the schema, meeting the baseline for high coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Inquires overseas listing,' which is a specific verb+resource combination. However, it doesn't distinguish between this tool and sibling tools like 'event_overseas_listing_decision' or 'event_overseas_delisting,' so clarity is good but not excellent.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives, nor any prerequisites or exclusions. This is a significant gap given the large number of sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_overseas_listing_decisionBRead-only
ν΄μΈμμ₯ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, covering behavior. The description adds no behavioral details beyond the basic purpose.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no fluff, front-loaded. However, it may be too brief for a tool with many siblings.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Output schema exists, so return values are covered. Description is minimal but sufficient given the read-only nature. Lacks context on filtering or result format.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (all three parameters have descriptions). The description itself adds no parameter information, so baseline score applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'μ‘°νν©λλ€' (inquires) clearly indicating a read operation on 'ν΄μΈμμ₯ κ²°μ ' (overseas listing decisions). It distinguishes from siblings like event_overseas_listing and event_overseas_delisting_decision.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives among the many sibling event tools. No context on prerequisites or typical use cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_paid_capital_increaseBRead-only
μ μμ¦μ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds no additional behavioral context beyond the name. It doesn't mention pagination, return format, or any quirks. With annotations present, a 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence. It is front-loaded and efficient. However, it could include a bit more context without losing conciseness, so it's not a 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that an output schema exists, the description does not need to explain return values. However, it is very minimal and does not mention any details about the data scope or typical usage. For a tool with many siblings, it is complete enough but lacks richness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema coverage is 100%, and schema descriptions already explain corp_code as '8μ리' and dates as YYYYMMDD. The tool description does not add any parameter-level information beyond what the schema provides, so it meets the baseline without adding value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it queries paid-in capital increase decisions (μ μμ¦μ κ²°μ μ μ‘°ν). The verb and resource are specific, and the name distinguishes it from siblings like event_capital_reduction. However, it does not explicitly differentiate from similar tools, so it's not a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. Given the many sibling event tools, explicit context (e.g., 'Use for paid-in capital increase events only') is missing. There is no mention of prerequisites or related tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_rehabilitation_filingARead-only
νμμ μ°¨ μ μ²μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the agent knows this is a read operation with possibly changing results. The description adds no further behavioral context (e.g., auth needs, rate limits). It neither adds nor contradicts annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is concise and front-loaded. Every word is necessary; no waste.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present (context signals), the description does not need to explain return values. It covers the basic purpose and parameters, but could benefit from mentioning optional date filtering logic or output limitations. Still, it is mostly complete for a simple query tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with clear descriptions for each parameter (corp_code as 8-digit unique, dates format). The description does not add additional meaning beyond what the schema provides, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries rehabilitation procedure applications, using a specific verb ('μ‘°νν©λλ€') and resource ('νμμ μ°¨ μ μ²'). It is distinct from sibling tools which cover different corporate events.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. The description only states what it does without mentioning exclusions or comparative context among the many event_* sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_split_decisionBRead-only
λΆν κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, and the description's 'μ‘°νν©λλ€' is consistent. However, the description adds no further behavioral context (e.g., rate limits, data freshness) beyond what annotations provide. No contradiction exists.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence, which is appropriate for a simple tool. However, it could be more informative without becoming verbose, earning a 4 rather than a 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and complete parameter descriptions, the description does not need to explain return values. However, it lacks context about the tool's result interpretation or how it fits into the broader event tool set, making it only minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so each parameter is already documented. The tool description adds no additional meaning or usage hints for parameters like 'corp_code' or date ranges. Baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly specifies the verb 'μ‘°νν©λλ€' (inquires) and resource 'λΆν κ²°μ ' (split decision), indicating the tool's purpose. However, it does not distinguish itself from similar sibling tools like event_split_merger_decision, which could cause confusion for an AI agent.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description offers no guidance on when to use this tool versus alternatives. It does not mention any prerequisites, context, or exclusions, leaving the agent to infer usage solely from the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_split_merger_decisionBRead-only
λΆν ν©λ³ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint and openWorldHint, so the description does not need to reiterate read-only nature. It adds no behavioral context beyond what annotations provide, but no contradiction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence is concise and front-loaded. However, given the complexity of the domain and many siblings, it could include more context without being verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Presence of output schema reduces need for return value explanation, but description lacks context about what a 'split merger decision' entails and how it differs from related tools. Adequate for a query with good annotations, but not fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with clear descriptions for all three parameters. The description adds no additional parameter meaning, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool queries 'split merger decision' (λΆν ν©λ³ κ²°μ ), specifying both the resource and action. However, it does not differentiate from siblings like event_merger_decision and event_split_decision, leaving ambiguity about the exact scope.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives. With many related event tools (e.g., merger, split), the absence of usage context forces the agent to rely on the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_stock_exchange_decisionARead-only
μ£Όμμ ν¬κ΄μ κ΅νΒ·μ΄μ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, indicating a safe query operation. The description does not add behavioral context beyond what annotations provide, but it also does not contradict them. A neutral score is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single concise sentence in Korean that front-loads the core purpose. Every word is necessary, and there is no redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema (not shown but indicated), the description need not detail return values. The tool has a simple query structure with three parameters fully described in the schema. The description is minimal but adequate for a well-annotated, read-only tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with each parameter described (corp_code, bgn_de, end_de). The description adds no additional meaning beyond the schema, so baseline 3 is correct.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'μ‘°νν©λλ€' (queries) and the specific resource 'μ£Όμμ ν¬κ΄μ κ΅νΒ·μ΄μ κ²°μ ' (comprehensive stock exchange/transfer decision), distinguishing it from sibling event tools such as event_merger_decision or event_split_decision.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit when-to-use or when-not-to-use guidance is provided. The description only states the tool's function, leaving the agent to infer usage from the tool name and sibling context. Implicit guidance exists through the sibling list, but no direct alternatives or exclusions are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_tangible_asset_acquisitionBRead-only
μ νμμ° μμ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations readOnlyHint=true and openWorldHint=true already indicate the tool is a read-only query. The description ('μ‘°νν©λλ€.') aligns with this. No additional behavioral traits (e.g., pagination, result structure) are disclosed. Since annotations cover the basics, a 3 is fair.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that efficiently states the tool's purpose. No extraneous information. While very brief, it is appropriately concise for a simple query tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (3 parameters, output schema exists), the description is minimally adequate. It covers the basic purpose but omits details about output content or usage scenarios. It could be improved, so a 3 is reasonable.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%: each parameter (corp_code, bgn_de, end_de) has a clear description in the input schema. The tool description adds no extra parameter context. With high schema coverage, baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'μ νμμ° μμ κ²°μ μ μ‘°νν©λλ€.' clearly indicates the tool queries tangible asset acquisition decisions. The name matches this purpose. However, it does not differentiate from sibling tools like event_tangible_asset_disposal, so a 4 is appropriate.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. There are no contextual hints about prerequisites, exclusions, or related tools. This lack of usage direction earns a 2.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_tangible_asset_disposalARead-only
μ νμμ° μλ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, and the description confirms a read operation. However, no additional behavioral traits (e.g., date range constraints, required permissions) are disclosed beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence with no wasted words; highly concise and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present and annotations covering read-only behavior, the description is mostly complete. Minor gap: does not mention what data is returned or any special filtering beyond date range.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% with each parameter described. The tool description adds no further explanation, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb (μ‘°ν/query) and resource (μ νμμ° μλ κ²°μ /tangible asset transfer decision), distinguishing it from siblings like event_tangible_asset_acquisition.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives (e.g., event_tangible_asset_acquisition). No context or exclusions provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_treasury_stock_acquisitionBRead-only
μκΈ°μ£Όμ μ·¨λ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description does not add any behavioral context beyond these annotations, but does not contradict them. It neither enriches nor harms transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence in Korean, front-loading the core purpose. While minimal, it wastes no words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description omits any explanation of what a 'treasury stock acquisition decision' entails, or how the results are structured (though an output schema exists). Given the complexity of corporate event tools and the existence of many siblings, the description is too sparse for full contextual understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage for all 3 parameters (corp_code, bgn_de, end_de). The tool description adds no additional meaning beyond the schema; however, with high schema coverage, a baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('μ‘°νν©λλ€' - inquires) and resource ('μκΈ°μ£Όμ μ·¨λ κ²°μ ' - treasury stock acquisition decision). However, it does not differentiate from sibling tools like event_treasury_stock_disposal or event_treasury_trust_contract, which are also inquiry-based tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives (e.g., event_treasury_stock_disposal for disposal events). No context about prerequisites or typical usage scenarios is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_treasury_stock_disposalARead-only
μκΈ°μ£Όμ μ²λΆ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark this as read-only (readOnlyHint: true). The description aligns with this by using 'μ‘°ν' (inquire) but adds no further behavioral context such as authorization requirements, rate limits, or handling of empty results. It does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence with no unnecessary words. It is concise and to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, annotations for readOnly and openWorld, and 100% parameter coverage, the description is adequate. It could mention that the query filters by date range, but the parameters imply this. Overall, it is sufficiently complete for a simple lookup tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so parameter descriptions from the schema are sufficient. The tool description offers no additional semantic information beyond what is already in the schema for corp_code, bgn_de, and end_de.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: inquiring about treasury stock disposal decisions. It uses a specific verb ('μ‘°νν©λλ€') and resource ('μκΈ°μ£Όμ μ²λΆ κ²°μ '), which distinguishes it from sibling tools like event_treasury_stock_acquisition.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage guidelines are provided. The description does not indicate when to use this tool over alternatives or any prerequisites, leaving the agent without guidance on tool selection among many similar event tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_treasury_trust_contractARead-only
μκΈ°μ£Όμμ·¨λ μ νκ³μ½ 체결 κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, so the description's 'μ‘°νν©λλ€' confirms reading. No additional behavioral traits (e.g., pagination, data freshness) are disclosed beyond what annotations provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence with no wasted words. It is front-loaded with the core purpose, earning its place efficiently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simple nature of the tool and existence of output schema, the description is adequate but could mention that it queries a specific type of trust contract decision to aid sibling differentiation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so parameters are well-documented in the schema. The description adds no extra meaning beyond what the schema already provides, meeting the baseline expectation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the specific action ('μ‘°νν©λλ€' - inquires) and resource ('μκΈ°μ£Όμμ·¨λ μ νκ³μ½ 체결 κ²°μ ' - decision to enter into a trust contract for treasury stock acquisition). It effectively distinguishes from siblings like event_treasury_stock_acquisition and event_treasury_trust_termination.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. There are many sibling event tools, but the description does not help the agent select this one over others.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_treasury_trust_terminationARead-only
μκΈ°μ£Όμμ·¨λ μ νκ³μ½ ν΄μ§ κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint=true, making the description's claim of inquiry consistent. The description adds no extra behavioral context beyond what annotations offer; no contradictions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One short sentence, front-loaded with the core action, no wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple query tool with an output schema and safe annotations, the description is adequate. It could benefit from mentioning the return type or date range behavior, but not essential.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% description coverage, so baseline is 3. The description does not add extra meaning beyond the schema descriptions for the three parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool inquires about the decision to terminate a treasury stock acquisition trust contract. It is specific but does not explicitly distinguish from sibling tools like event_treasury_trust_contract.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied by the description (inquire about trust termination decisions), but there is no explicit guidance on when to use this tool versus alternatives, nor any when-not-to-use conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
event_write_off_contingent_capitalARead-only
μκ°ν 쑰건λΆμλ³Έμ¦κΆ λ°ν κ²°μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, so the description does not need to emphasize safety. The description adds that it retrieves 'issuance decisions', but does not disclose other behaviors such as default date ranges, pagination, or result structure. This is adequate given annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence with no wasted words. It is front-loaded with the key information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (3 parameters, no nested objects) and presence of an output schema, the description is minimal but sufficient. It could mention that results are filtered by date range or provide a brief note on the output.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema coverage is 100%, so the schema already documents all parameters. The description adds no additional meaning or context to the parameters beyond what is in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('μ‘°νν©λλ€' - inquires) and the specific resource ('μκ°ν 쑰건λΆμλ³Έμ¦κΆ λ°ν κ²°μ ' - write-off contingent capital issuance decisions). It distinguishes from siblings like 'report_contingent_capital_balance' by focusing on issuance decisions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. With many sibling tools (e.g., other event_ tools), the description lacks context for appropriate usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
financial_full_statementsBRead-only
μ 체 μ¬λ¬΄μ νλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) | |
| fs_div | No | μ¬λ¬΄μ νκ΅¬λΆ (CFS:μ°κ²°, OFS:κ°λ³) | CFS |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, indicating a safe read operation. The description adds no additional behavioral traits beyond what annotations provide, which is adequate but does not enhance understanding.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that is front-loaded and wastes no words. However, it could benefit from slight expansion for clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (4 parameters, many siblings) and presence of output schema, the description lacks important context such as what 'full' means and how it differs from similar financial tools. It is insufficient for an agent to correctly select and invoke the tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with descriptions for all parameters. The tool description adds no extra meaning beyond the schema, so baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it retrieves full financial statements using a specific verb and resource. However, it does not differentiate from sibling tools like financial_multi_account or financial_single_account, which have similar purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. No when-not-to-use or context for selection among many sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
financial_indicatorsBRead-only
볡μ κΈ°μ μ μ¬λ¬΄ μ§νλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (μΌν ꡬλΆ, μ΅λ 20κ°) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) | |
| idx_cl_code | No | μ§νλΆλ₯μ½λ |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint=true and openWorldHint=true. The description adds no further behavioral context beyond the purpose. With annotations, a 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence that is concise and front-loaded with the main action. No wasted words, though it could benefit from more structure.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description is too brief given the complexity of parameters (multiple corp_codes, optional idx_cl_code). It lacks context on how to use these parameters effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with descriptions for all 4 parameters. The description adds no extra meaning beyond the schema, so baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the verb 'retrieve' and resource 'financial indicators' with scope 'multiple companies.' This distinguishes it from siblings like financial_single_indicators.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives such as financial_single_indicators. The description only states what it does without usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
financial_multi_accountARead-only
볡μ κΈ°μ μ μ£Όμ μ¬λ¬΄ κ³μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (μΌν ꡬλΆ, μ΅λ 20κ°) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) | |
| fs_div | No | μ¬λ¬΄μ νκ΅¬λΆ (CFS:μ°κ²°, OFS:κ°λ³) | CFS |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the description carries less burden. However, it adds no behavioral context beyond what annotations provide, offering no specifics about data freshness, pagination, or what constitutes 'major' accounts.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is a single sentence without any redundant words. It efficiently conveys the core functionality.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the availability of an output schema and complete parameter documentation in the input schema, the description is adequately complete for a read-only retrieval tool. It lacks only minor contextual details like what 'major' means, but overall sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The description does not add any additional meaning to the parameters beyond what the schema already provides in Korean.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly specifies retrieving financial accounts for multiple companies, distinguishing it from siblings like financial_single_account. The verb 'retrieves' and resource 'major financial accounts of multiple companies' are explicit, though 'major' is somewhat vague.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit usage guidelines provided. The purpose implies use for multiple companies, but there is no when-not or alternative tool mention, which would be helpful given many sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
financial_single_accountBRead-only
λ¨μΌ κΈ°μ μ μ£Όμ μ¬λ¬΄ κ³μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) | |
| fs_div | No | μ¬λ¬΄μ νκ΅¬λΆ (CFS:μ°κ²°, OFS:κ°λ³) | CFS |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, indicating a safe read operation. The description adds no additional behavioral details (e.g., pagination, account types covered, or error conditions). It does not contradict annotations, but adds minimal value beyond them.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single concise sentence. No wasted words, but the description is very brief and could be restructured to include key details like the typical accounts returned. Given brevity, it scores above average.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Output schema exists, so return values need not be described. However, the description lacks context about what constitutes 'major financial accounts' (e.g., cash, revenue) and assumes Korean financial reporting knowledge. For a tool with 4 parameters and a specific domain, more context would help.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, providing clear parameter descriptions for corp_code, bsns_year, reprt_code, and fs_div. The description adds only the context that it queries 'major' financial accounts, which does not materially enhance understanding of parameters. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it queries major financial accounts of a single company. The verb 'μ‘°ν' (query) and resource 'μ£Όμ μ¬λ¬΄ κ³μ ' are specific. However, 'major financial accounts' is vague without listing examples, and the name 'single_account' suggests one account but description says multiple. It differentiates from sibling tools like financial_full_statements but not explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like financial_full_statements or financial_multi_account. No exclusions or prerequisites mentioned. The agent has to infer usage from the name and description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
financial_single_indicatorsBRead-only
λ¨μΌ κΈ°μ μ μ¬λ¬΄ μ§νλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) | |
| idx_cl_code | Yes | μ§νλΆλ₯μ½λ |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true. Description does not add additional behavioral context such as data freshness, required parameter details, or what 'indicators' means. Minimal added value beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence is concise and front-loaded with the core action. However, it lacks any structural elements like bullet points or examples that could improve usability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description does not explain what financial indicators are returned or how to interpret results. For a tool with 4 required parameters and many siblings, more context is needed for effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All parameters have descriptions in the input schema (100% coverage). The tool description does not add extra meaning or format constraints beyond what schema already provides, meeting the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it retrieves financial indicators of a single company. Verb 'μ‘°ν' (retrieve) and resource 'μ¬λ¬΄ μ§ν' (financial indicators) are specific. Among siblings, it distinguishes from multi-entity and full statement tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like financial_indicators or financial_multi_account. The description implies single-company use but doesn't explicitly state when not to use or provide criteria for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
financial_xbrl_downloadBRead-only
XBRL νμΌμ λ€μ΄λ‘λν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| rcept_no | Yes | μ μλ²νΈ (14μ리) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, so the description need not repeat. However, no additional behavioral context (e.g., file size limits, error handling) is provided, which would enhance transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very concise single sentence. It is front-loaded and contains no fluff, though it could be slightly more informative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given low complexity, annotations, and output schema, the description is minimally complete. It covers the basic purpose but lacks richer context about results or usage context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The tool description adds no extra meaning beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it downloads an XBRL file, which is a specific verb and resource. While it distinguishes from siblings by name, it lacks context on what XBRL is, but it is functional.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, such as 'financial_xbrl_taxonomy' or other financial tools. The description is purely declarative.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
financial_xbrl_taxonomyBRead-only
XBRL νμλ Έλ―Έλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| sj_div | Yes | μ¬λ¬΄μ νκ΅¬λΆ (BS:μ¬λ¬΄μνν, IS:μμ΅κ³μ°μ, CIS:ν¬κ΄μμ΅κ³μ°μ, CF:νκΈνλ¦ν, SCE:μλ³Έλ³λν) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, so the agent knows it is a safe read operation. The description adds no further behavioral traits (e.g., rate limits, response structure). Given annotations, a score of 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no unnecessary information, achieving high conciseness. It could be slightly more informative while remaining concise, hence not a 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema (not shown) and a simple parameter set, the description is minimally complete. However, it lacks context about what the taxonomy contains and how it relates to other financial tools, making it less useful for informed tool selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with a detailed description for the single parameter sj_div, listing allowed values. The tool description does not add any additional semantic meaning beyond what is already in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'XBRL taxonomeul johoehamnida' (Query XBRL taxonomy) clearly states the verb 'query' and resource 'XBRL taxonomy', making the purpose understandable. However, it does not differentiate itself from sibling tools like financial_xbrl_download, which might cause ambiguity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, nor does it mention any prerequisites or exclusions. With many sibling tools, this lack of guidance increases the chance of incorrect selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
registration_debt_securitiesBRead-only
μ±λ¬΄μ¦κΆ λ°ν μ κ³ μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint true and openWorldHint true, so the description's assertion of 'μ‘°ν' (inquiry) is consistent but adds minimal behavioral insight. It does not disclose pagination, response format, or any side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence that immediately conveys the tool's purpose. It is front-loaded and contains no unnecessary words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and annotations, the description adequately covers the core purpose. However, it omits details like required parameters or optional date filtering, though these are captured in the schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema description coverage, the input schema fully documents each parameter (corp_code, bgn_de, end_de). The description does not add any parameter-level meaning, meeting the baseline expectation but not exceeding it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries (μ‘°ν) debt securities issuance reports (μ±λ¬΄μ¦κΆ λ°ν μ κ³ μ), using a specific verb and resource. It implicitly differentiates from siblings like registration_equity_securities by specifying 'debt securities', but does not explicitly contrast with similar tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like registration_equity_securities or report_debt_securities_issuance. It does not specify prerequisites, date range behavior, or context for querying.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
registration_depositary_receiptARead-only
μνμ¦κΆ μ κ³ μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, so the description's 'μ‘°νν©λλ€' (query) is consistent. No additional behavioral details (e.g., rate limits, auth needs) are provided beyond the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no extraneous information, achieving maximum conciseness while conveying the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and full parameter descriptions, the description is adequate. It covers the essential function, though it does not explain what a depositary receipt report is. Overall complete enough for the given complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description does not add extra meaning beyond the parameter descriptions in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'μνμ¦κΆ μ κ³ μλ₯Ό μ‘°νν©λλ€.' clearly states the action (query) and resource (depositary receipt report). It is specific enough to differentiate from sibling tools like registration_debt_securities, but lacks further detail on scope.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus siblings. Usage is implied by the tool's name and description, but there are no when-not-to-use instructions or alternative tool mentions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
registration_equity_securitiesBRead-only
μ§λΆμ¦κΆ λ°ν μ κ³ μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description states 'inquires' which aligns with the readOnlyHint=true annotation. It does not provide additional behavioral context beyond what annotations already convey, but it does not contradict them either.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that immediately conveys the tool's purpose. It is efficient but could add a bit more context without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is minimal and adequate for a simple retrieval tool with a well-documented schema and an output schema present. However, it lacks differentiation from siblings and could mention the scope of data returned.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All three parameters are fully described in the input schema (100% coverage). The tool description does not add any extra meaning or context about the parameters beyond the schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('μ‘°νν©λλ€' - inquire) and the specific resource ('μ§λΆμ¦κΆ λ°ν μ κ³ μ' - equity securities issuance registration report). It distinguishes from sibling tools like registration_debt_securities by specifying equity securities.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives (e.g., registration_debt_securities) or when not to use it. There is no mention of prerequisites or context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
registration_merger_registrationCRead-only
ν©λ³ μ κ³ μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, but the description adds no extra behavioral information such as side effects, authentication needs, or rate limits. It merely restates the purpose.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence with no redundancy. It is front-loaded and appropriately sized for a simple tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
While an output schema exists, the description lacks contextual guidance for selecting this tool among many siblings. It does not explain the scope or limitations of the data returned.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so parameters are fully documented. The description adds no additional meaning beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Inquiry merger registration report', clearly indicating a read operation on merger registration data. However, it does not differentiate from sibling tools like registration_split_registration or event_merger_decision.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives, nor are there any exclusions or prerequisites mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
registration_split_registrationCRead-only
λΆν μ κ³ μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, but the description adds no additional behavioral context. It does not describe the scope of data returned, potential limitations, or side effects. With annotations present, the bar is lower, but the description contributes nothing beyond the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, short sentence with no wasted words. It is appropriately concise for a simple tool, though the structure could benefit from additional context without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity, 3 parameters, and presence of an output schema and annotations, the description provides a minimal but adequate summary. It does not explain return values or typical use cases, but the schema and output schema likely cover these. However, for a complete picture, more context would improve usability.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, meaning all three parameters are described in the input schema. The description does not add any extra meaning or context about parameters (e.g., clarifying the date format or default behavior). Baseline score of 3 is appropriate as the schema carries the full burden.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'μ‘°νν©λλ€' (inquire) and the resource 'λΆν μ κ³ μ' (split report), making the tool's purpose clear. However, it does not distinguish it from sibling tools with similar names (e.g., registration_split_decision), lacking specificity that sets it apart.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It does not mention required parameters, date range filtering, or any context for use. No exclusions or comparisons are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
registration_stock_exchange_transferBRead-only
μ£Όμκ΅νμ΄μ μ κ³ μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bgn_de | No | μμμΌ (YYYYMMDD) | |
| end_de | No | μ’ λ£μΌ (YYYYMMDD) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the description's 'inquires' is consistent but adds no extra behavioral context beyond what annotations provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence, which is concise and to the point. However, it lacks structure or front-loading of key information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (3 parameters, 1 required, has output schema) and existing annotations, the description is minimally adequate but could be more complete by distinguishing from siblings or noting return format.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with descriptions for all parameters. The description adds no new meaning beyond the schema's parameter descriptions, so baseline score of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'inquires about stock exchange transfer report,' providing a specific verb and resource. However, it does not differentiate from sibling registration tools like registration_debt_securities or registration_merger_registration.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage guidance is provided. The description does not indicate when to use this tool versus siblings such as event_stock_exchange_decision, and no exclusions or alternatives are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_auditor_opinionBRead-only
κ°μ¬ μ견μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint=true, and the description does not contradict this. However, the description adds no extra behavioral context (e.g., no mention of required permissions or rate limits), but the annotation covers the safety profile adequately.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one sentence long and directly conveys the purpose. It is concise without being overly minimal, but could benefit from slight expansion about usage.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With annotations covering read behavior and an output schema existing, the description is adequate but minimal. It does not mention any constraints or the nature of the output, so completeness is average.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with all three parameters described in the input schema. The description adds no additional parameter information beyond what the schema provides, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'μ‘°νν©λλ€' (inquire) and the resource 'κ°μ¬ μ견' (auditor opinion), making the purpose specific. The sibling 'report_audit_service_contract' is distinguishable as it deals with audit service contracts, not opinions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like other report_* tools. The description only states what it does, without context on prerequisites or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_audit_service_contractARead-only
κ°μ¬ μ©μ κ³μ½ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the behavioral profile is clear. The description adds no extra behavioral traits beyond the annotations, resulting in an adequate but uninformative score.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence with no extraneous words. It is front-loaded and efficiently communicates the tool's purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that the tool has an output schema and the input parameters are well-documented, the description provides the minimal necessary context. However, it lacks details about the nature of the status or any prerequisites, making it only adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers all three parameters with descriptions (corp_code, bsns_year, reprt_code), achieving 100% coverage. The description adds no additional meaning beyond what the schema already provides, so a baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action 'inquires the status' and the resource 'audit service contracts'. It is specific and aligns with the tool name, distinguishing it from siblings like report_non_audit_service_contract.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage guidelines provided. The description does not mention when to use this tool vs alternatives such as report_auditor_opinion or report_non_audit_service_contract, leaving the agent without contextual guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_commercial_paper_balanceBRead-only
κΈ°μ μ΄μ μμ‘μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, which cover the safety profile. The description only says 'μ‘°νν©λλ€', consistent with a read operation, but adds no extra behavioral context beyond what annotations already provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence with no wasted words. It is front-loaded and immediately clear.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple with three required parameters fully described in the schema and has an output schema. The description is adequate for a basic read tool, but adding a brief note on typical use cases or differentiation from siblings would improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with each parameter described. The description adds no parameter-specific information, so it does not increase understanding beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'μ‘°νν©λλ€' (inquire) and resource 'κΈ°μ μ΄μ μμ‘' (commercial paper balance), making the purpose clear. However, it does not differentiate from sibling report_* tools like report_corporate_bond_balance, which have similar purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. There are no prerequisites, exclusions, or alternative tool names mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_contingent_capital_balanceBRead-only
μ μ’ μλ³Έμ¦κΆ μμ‘μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the agent knows it's a safe read with variable availability. The description adds no significant behavioral context beyond what is in annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no wasted words. However, it could include more context without significant length increase.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With output schema present and annotations providing safety, the description is adequate for a straightforward balance query tool. No missing critical information.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the description does not elaborate on parameter values or formats beyond the schema. Baseline score applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'μ‘°ν' (query) and resource 'μ μ’ μλ³Έμ¦κΆ μμ‘' (contingent capital securities balance), making it clear what the tool does. However, it does not differentiate from similar sibling tools like 'report_hybrid_securities_balance', which may cause confusion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, such as other report tools or the event_write_off_contingent_capital tool. The description provides no context for invocation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_corporate_bond_balanceBRead-only
νμ¬μ± μμ‘μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true. The description adds no additional behavioral context, such as data freshness or pagination, but it does not contradict the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with no wasted words. It is appropriately front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that an output schema exists and annotations are present, the description is minimal but sufficient for a read operation. However, more context about the output or special behaviors could improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with descriptions for each parameter. The description adds no extra meaning beyond what the schema provides, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it inquires the balance of corporate bonds, using a specific verb and resource. However, it does not differentiate from similar sibling tools like report_short_term_bond_balance, which are also balance inquiries.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives such as report_commercial_paper_balance. There are no conditions or exclusions mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_debt_securities_issuanceBRead-only
μ±λ¬΄μ¦κΆ λ°νμ€μ μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations provide readOnlyHint and openWorldHint, so the description does not contradict them. However, it adds no extra behavioral context (e.g., no mention of pagination or scope). With annotations present, score 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no wasted words, front-loaded with purpose. Excellent conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema and readOnly annotations, the minimal description may suffice for a simple query. However, it lacks details on return format or limitations, so adequate but not complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with clear parameter descriptions. The description adds no additional meaning beyond the schema, so baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states 'Inquire about debt securities issuance performance' with a clear verb and resource. Although it could explicitly differentiate from sibling tools like report_corporate_bond_balance, the name and description are sufficiently distinct.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives. The description does not mention context, prerequisites, or related tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_director_compensationBRead-only
μ΄μ¬ 보μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint and openWorldHint. The description simply restates that it retrieves data, adding no further behavioral context beyond what annotations convey.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single short sentence; concise and front-loaded. However, it could include more useful information without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 3 required parameters and a complex domain (Korean corporate disclosures), the description is too brief. It does not explain what data is returned or any nuances, even though output schema exists.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema covers 100% of parameters. Description adds no additional meaning to parameters beyond what schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it inquires director compensation, which is a specific verb+resource. However, it does not differentiate from sibling tools like report_director_compensation_approval or report_director_compensation_by_type.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. The description lacks context, prerequisites, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_director_compensation_approvalBRead-only
μ΄μ¬ 보μ μΉμΈ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations provide readOnlyHint and openWorldHint, but the description adds no additional behavioral details (e.g., output format, pagination, rate limits). It repeats no contradictions but does not enrich the agent's understanding beyond what annotations already convey.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, focused sentence that states the purpose without extraneous text. It is front-loaded and efficient, though brevity limits depth.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema exists, the description need not detail return values. However, the tool deals with 'approval status' which could benefit from more context, but the description is minimally adequate for a well-structured schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with all parameters described adequately. The description does not add extra meaning beyond the schema, so baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool inquires about director compensation approval status. This specific verb and resource distinguish it from sibling tools like report_director_compensation, report_director_compensation_by_type, which cover other aspects of director compensation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. The description does not mention when not to use it or suggest other tools for related queries, leaving the agent without explicit direction.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_director_compensation_by_typeBRead-only
μ νλ³ μ΄μ¬ 보μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true. The description adds no behavioral context beyond that. With annotations covering safety, a 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no wasted words. Appropriately sized for a simple retrieval tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Tool has 3 required parameters and an output schema (not shown). The description does not elaborate on the output or what 'by type' means, but with output schema present, completeness is adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and each parameter has a description. The description adds no extra meaning beyond the schema, so baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it queries director compensation by type, but does not distinguish it from sibling tools like report_director_compensation or report_director_individual_compensation. Purpose is clear but lacks differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives (e.g., report_director_compensation, report_director_individual_compensation). The description only states the action.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_director_individual_compensationCRead-only
μ΄μ¬ κ°μΈλ³ 보μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the description's 'inquires' is consistent. The description adds no further behavioral context beyond the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence, but it is under-specified for the tool's complexity. It lacks sufficient detail to be fully helpful, especially given the many sibling tools.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has three required parameters, many sibling tools, and an output schema, the description is too brief. It does not explain how this tool relates to other compensation reports or what the output contains.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage for all three parameters. The tool description does not add any additional meaning or usage guidance beyond what the schema already provides, so baseline score is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the tool inquiries individual compensation of directors, which is a specific verb+resource. However, it does not differentiate from sibling tools like report_director_compensation or report_individual_compensation, leaving ambiguity about what 'individual' entails.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus similar report_* siblings. There is no mention of alternatives, prerequisites, or context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_dividendsCRead-only
λ°°λΉ μ 보λ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, indicating a safe, read-only operation with possibly incomplete results. The description adds no behavioral context beyond a generic inquiry term. It does not disclose any traits like data freshness, pagination, or error handling.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that efficiently conveys the tool's purpose. It is front-loaded and wastes no words. However, it could be slightly more informative without losing brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that an output schema exists and annotations provide basic behavioral guardrails, the description does not need to explain return values. However, it lacks context about the data source (Korean DART system) and any special considerations. The description is minimally adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, with each parameter having a clear description (e.g., 'κ³ μ λ²νΈ (8μ리)' for corp_code). The description does not add extra meaning beyond the schema, but the baseline is met because the schema already exhaustively documents the parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: 'Inquiry dividend information.' The verb 'μ‘°ν' (inquiry) and resource 'λ°°λΉ μ 보' (dividend information) are specific. While brief, it effectively distinguishes from sibling report tools that cover other topics like auditor opinions or employees.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. There is no mention of when not to use it, prerequisites, or related sibling tools. Users must infer usage from the tool name and input schema alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_employeesARead-only
μ§μ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=true, so the description aligns with a read operation. However, it adds no further behavioral details (e.g., whether results are paginated, what data is included). With annotations present, the bar is lower, but the description is minimal.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single, focused sentence with no extraneous words. Front-loaded with the core action and resource.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the existence of an output schema and rich sibling context, the description is adequate but could be more informative about the what 'employee status' entails (e.g., count, list, fields). It meets minimum completeness but leaves room for ambiguity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with good parameter descriptions. The tool description adds no additional meaning beyond the schema, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description specifies the verb 'μ‘°ν' (retrieve) and the resource 'μ§μ νν©' (employee status), clearly distinguishing from sibling report_* tools like report_executives or report_director_compensation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, or any prerequisites or contextual hints. The agent receives no information about typical use cases or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_executivesBRead-only
μμ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is clear. The description adds no additional behavioral context (e.g., rate limits, data scope) but does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, well-structured sentence that is front-loaded and contains no unnecessary words. Perfectly concise for the information it conveys.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has an output schema, annotations, and simple parameters, the description is adequately complete. It could mention the source (e.g., DART) or the meaning of 'status', but not essential.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with adequate parameter descriptions. The description does not add any new meaning for parameters beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries the status of executives, using a specific verb ('μ‘°ν') and resource ('μμ νν©'). However, it does not differentiate from sibling tools like report_outside_directors or report_employees, which may overlap.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives (e.g., report_outside_directors, report_director_compensation). No prerequisites or context for choosing this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_hybrid_securities_balanceBRead-only
쑰건λΆμλ³Έμ¦κΆ μμ‘μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description does not contradict these and does not add extra behavioral context such as side effects, auth requirements, or rate limits. With annotations present, the baseline is met.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence in Korean. It is front-loaded and without unnecessary words, but the minimalism does not detract from clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has an output schema, so return value documentation is external. However, the description is very brief and does not fully contextualize the report's scope or data, though it is sufficient for a simple lookup with three well-defined parameters.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, with each parameter described adequately in the schema. The description adds no additional meaning beyond what the schema provides, so baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('μ‘°νν©λλ€' = inquires) and the resource ('쑰건λΆμλ³Έμ¦κΆ μμ‘' = contingent capital securities balance). However, it does not distinguish this tool from sibling report_* tools like 'report_contingent_capital_balance', which may overlap or refer to similar data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It lacks information on prerequisites, exclusions, or context where this report is appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_individual_compensationCRead-only
κ°μΈλ³ 보μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
While annotations already indicate readOnlyHint and openWorldHint, the description adds no additional behavioral context (e.g., data scope, pagination, rate limits). It merely states 'queries', which is already implied by annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise (one short sentence) but at the cost of omitting critical distinguishing information. It is underspecified rather than efficiently informative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of multiple sibling tools and three required parameters, the description lacks essential context to disambiguate usage. An output schema exists, but the description does not leverage it to explain what data is returned.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with adequate parameter descriptions. The description adds no extra meaning beyond the schema, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'κ°μΈλ³ 보μλ₯Ό μ‘°νν©λλ€.' is vague; it does not specify whose compensation (e.g., all individuals vs. directors). The presence of a similar sibling 'report_director_individual_compensation' suggests a distinction, but the description fails to clarify this, leading to potential confusion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool over alternatives like 'report_director_individual_compensation' or other compensation-related tools. No context, prerequisites, or exclusions are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_non_audit_service_contractBRead-only
λΉκ°μ¬ μ©μ κ³μ½ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint and openWorldHint; description adds no further behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single concise sentence, front-loaded, no wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Minimal but adequate given schema, annotations, and output schema existence; lacks business context or usage scenario.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers parameter descriptions 100%; description adds no additional meaning beyond schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries non-audit service contract status, distinguishing it from sibling tools like report_audit_service_contract.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives, no context or exclusions provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_other_corp_investmentsBRead-only
νλ²μΈ μΆμ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint=true and openWorldHint=true, indicating a safe read operation. The description does not add any behavioral context beyond what the annotations convey. It does not mention data freshness, pagination, or any limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that directly states the tool's function. It is efficiently communicated with no wasted words, though it could be slightly enhanced with minimal structuring.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simple reporting nature, the description is adequate but lacks context about the output format or any restrictions. The presence of an output schema reduces the burden, but the description could still mention that it returns a list of investments.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, with each parameter well-documented (e.g., 'κ³ μ λ²νΈ (8μ리)'). The tool description does not add additional semantic value beyond the schema, so a baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'νλ²μΈ μΆμ νν©μ μ‘°νν©λλ€' (Inquire about the status of investments in other corporations). It uses a specific verb (μ‘°ννλ€) and resource (νλ²μΈ μΆμ νν©), distinguishing it from sibling tools like event_other_corp_stock_acquisition or report_hybrid_securities_balance.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no explicit guidance on when to use this tool versus alternatives. While the name suggests it's for reporting on other corporate investments, there is no mention of when not to use it or which siblings cover related but different scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_outside_directorsARead-only
μ¬μΈμ΄μ¬ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the description does not need to restate them. It adds no new behavioral context, but does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, concise sentence that immediately conveys the tool's purpose. No unnecessary words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has an output schema and 100% schema coverage. The description is minimal but sufficient for a straightforward read-only query. It could mention the output type, but the output schema compensates.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with descriptions for all three parameters. The description adds no additional meaning beyond what the schema provides, so baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb 'μ‘°νν©λλ€' (inquire) and identifies the resource 'μ¬μΈμ΄μ¬ νν©' (status of outside directors). It clearly distinguishes itself from sibling tools, none of which target outside directors.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. There is no explicit indication of prerequisites, context, or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_private_placement_fund_usageBRead-only
μ¬λͺ¨μκΈ μ¬μ© νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, so the description does not need to restate safety. The description adds no additional behavioral context (e.g., auth requirements, result format), but it does not contradict annotations. For a read tool with good annotations, this is acceptable but not enhanced.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that efficiently conveys the tool's purpose. There is no unnecessary detail or redundancy, fitting the principle that every word should earn its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that the tool has three required parameters, a clear purpose, an existing output schema, and annotations, the description is largely adequate. A minor gap is the lack of explanation about the relationship to the sibling tool, but overall it provides sufficient context for a focused query operation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already clearly defines the three parameters with Korean descriptions for each (corp_code, bsns_year, reprt_code). The description does not add any additional meaning beyond what the schema provides, so it meets the baseline but does not exceed it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'μ‘°νν©λλ€' (inquire), indicating it is a read operation. It specifies 'μ¬λͺ¨μκΈ μ¬μ© νν©' (private equity fund usage), which clarifies the resource. However, it does not explicitly distinguish itself from the sibling tool 'report_public_offering_fund_usage', which could cause ambiguity. The name helps but the description could be more explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. The sibling tool 'report_public_offering_fund_usage' exists for similar purposes but for public offerings, yet the description does not mention this distinction or provide usage context. The agent receives no help in decision-making.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_public_offering_fund_usageARead-only
곡λͺ¨μκΈ μ¬μ© νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true and openWorldHint=true, so the description does not need to reiterate these. The description adds no extra behavioral context beyond stating it is a query. Given that annotations adequately cover the safety profile, the description provides minimal additional value.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence in Korean that effectively conveys the tool's purpose. It is appropriately sized and front-loaded. While it could potentially include a bit more context without being verbose, it is efficient and free of unnecessary information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that the tool has an output schema and the parameter schema is fully described, the description is adequate for a simple query tool. It does not need to explain return values because the output schema exists. However, for a tool among many similar financial report tools, slightly more context about the output might be beneficial, but overall it is sufficiently complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with each parameter having a brief description (e.g., 'κ³ μ λ²νΈ (8μ리)' for corp_code). The tool description does not add any additional meaning or context to the parameters beyond what the schema already provides, so it meets the baseline of 3 as per the rule for high coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states it inquires about public offering fund usage status ('곡λͺ¨μκΈ μ¬μ© νν©μ μ‘°νν©λλ€'). The tool name also clearly indicates its function. Among sibling tools, it is distinguished from 'report_private_placement_fund_usage' which handles private placement. This provides a specific verb and resource that differentiates it effectively.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not provide explicit guidance on when to use this tool versus alternatives or prerequisites. While the name implies it is for public offering fund usage, and a sibling exists for private placement, no usage context or exclusions are given. The guidance is implied but not explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_short_term_bond_balanceBRead-only
λ¨κΈ°μ¬μ± μμ‘μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, so the tool is known to be a read operation with potentially varying results. The description adds no additional behavioral details beyond the annotations, but it does not contradict them.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that directly states the tool's function. It is front-loaded and contains no unnecessary words, earning full marks for conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has an output schema and clear parameters, the description is minimally complete. However, with many similar sibling tools, additional context about the specific 'short-term bond' scope would improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All three parameters (corp_code, bsns_year, reprt_code) are fully described in the input schema with 100% coverage. The description provides no extra information about parameters, so it meets the baseline but does not enhance understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries short-term bond balance ('λ¨κΈ°μ¬μ± μμ‘μ μ‘°νν©λλ€'), providing a specific verb and resource. However, it does not differentiate from siblings like 'report_corporate_bond_balance', making it slightly less than perfect.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives such as other bond balance reports. There are no explicit context statements or exclusions, leaving the agent to infer usage from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_stock_changesBRead-only
μ¦μ/κ°μ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true. The description adds no additional behavioral context, so it meets baseline but does not exceed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single concise sentence that efficiently communicates the tool's purpose. No extra words, though slightly minimal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the existence of many sibling tools with similar themes, the description fails to clarify the exact scope or when to use this instead of specific event tools. An output schema exists, but the description is too vague.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description does not add any parameter-level information beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it inquires about capital increase/reduction status. However, among siblings like event_paid_capital_increase and event_capital_reduction, it does not differentiate itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs. similar event_* tools. The description lacks any context about prerequisites or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_total_stock_quantityBRead-only
μ£Όμ μ΄μ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations (readOnlyHint, openWorldHint) already declare behavioral traits. The description adds no further context about what the output contains or any limitations, so it is adequate but not enriched.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no unnecessary words. Highly concise and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, the description does not need to detail return values. However, it could mention the scope of the query (e.g., total shares for a specific corporation). It is minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with parameter descriptions in the schema. The description adds no additional meaning beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it retrieves total stock quantity with specific verb and resource. However, it does not differentiate from sibling tools like report_stock_changes or report_treasury_stock.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. The description gives no context about prerequisites or typical scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_treasury_stockBRead-only
μκΈ°μ£Όμ νν©μ μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, covering safety and response behavior. The description adds no additional behavioral traits beyond the obvious query nature, but does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence is concise and front-loaded. However, it is extremely brief and could be slightly expanded to include context without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 3 required parameters, output schema, and annotations, the description is adequate but does not explain the concept of treasury stock status or what the output represents. It meets minimum viability.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema description coverage, the schema already explains each parameter. The description adds no extra meaning or constraints beyond what is in the input schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it inquires treasury stock status (μκΈ°μ£Όμ νν©μ μ‘°νν©λλ€), using a specific verb and resource. This distinguishes it from sibling event tools like event_treasury_stock_acquisition, which involve actions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when or when not to use this tool, nor does it mention alternatives. It is a minimal one-liner without usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
report_unregistered_executive_compensationBRead-only
λ―Έλ±κΈ° μμ 보μλ₯Ό μ‘°νν©λλ€.
| Name | Required | Description | Default |
|---|---|---|---|
| corp_code | Yes | κ³ μ λ²νΈ (8μ리) | |
| bsns_year | Yes | μ¬μ μ°λ (YYYY) | |
| reprt_code | Yes | λ³΄κ³ μμ½λ (11011:μ¬μ , 11012:λ°κΈ°, 11013:1λΆκΈ°, 11014:3λΆκΈ°) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate read-only behavior. The description adds that it inquires about compensation, but no further behavioral traits are disclosed (e.g., filtering logic, rate limits). With annotations covering safety, a score of 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence. While appropriate, it could benefit from slightly more structure or a brief explanation of the output without losing brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the existence of an output schema and moderate complexity, the description provides minimal context. It lacks information on how this tool differs from other compensation tools, making it less complete for selecting the correct tool among many siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so parameters are fully documented in the schema. The description does not add additional meaning beyond what the schema provides, so baseline score of 3 is justified.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries unregistered executive compensation. While the name is specific, the description could better differentiate it from sibling tools like report_director_compensation by explicitly stating 'unregistered' as the key distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus similar compensation-related tools. The description lacks context for selection, such as prerequisites or example scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
utility_get_current_dateARead-only
νμ¬ λ μ§μ μκ°μ νκ΅ νμ€μ(KST) κΈ°μ€μΌλ‘ λ°νν©λλ€.
λ μ§κ° νμν λ€λ₯Έ λꡬλ₯Ό νΈμΆνκΈ° μ μ μ΄ λꡬλ₯Ό λ¨Όμ μ¬μ©νμΈμ.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Description adds that the output is in KST, which is beyond the readOnlyHint annotation. However, it does not specify format or precision (e.g., seconds included?), but for a simple date tool this is adequate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences convey purpose and usage without any extraneous text. Efficient and to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no parameters and an output schema, the description covers all necessary information: what it does (returns current KST datetime) and when to use it (before other date-dependent tools).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
No parameters exist, so the description does not need to add parameter details. The output schema likely provides return format information.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it returns current date and time in KST. It is a utility function distinct from the sibling tools which are specific data retrieval functions for disclosures, events, financials, etc.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly advises to use this tool before calling other tools that require a date, providing clear usage context and prioritization.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
1 tool update
v0.3.0- Added
utility_get_current_date
84 tool updates
v0.1.0- First observed
disclosure_company - First observed
disclosure_corp_codes - First observed
disclosure_document - First observed
disclosure_search - First observed
disclosure_search_company - First observed
event_asset_transfer - First observed
event_bond_with_warrant - First observed
event_bonus_issue - First observed
event_business_acquisition - First observed
event_business_disposal - First observed
event_business_suspension - First observed
event_capital_reduction - First observed
event_convertible_bond - First observed
event_creditor_management_start - First observed
event_creditor_management_stop - First observed
event_default_occurrence - First observed
event_dissolution_reason - First observed
event_exchangeable_bond - First observed
event_litigation - First observed
event_merger_decision - First observed
event_mixed_capital_increase - First observed
event_other_corp_stock_acquisition - First observed
event_other_corp_stock_disposal - First observed
event_overseas_delisting - First observed
event_overseas_delisting_decision - First observed
event_overseas_listing - First observed
event_overseas_listing_decision - First observed
event_paid_capital_increase - First observed
event_rehabilitation_filing - First observed
event_split_decision - First observed
event_split_merger_decision - First observed
event_stock_exchange_decision - First observed
event_stock_related_bond_acquisition - First observed
event_stock_related_bond_disposal - First observed
event_tangible_asset_acquisition - First observed
event_tangible_asset_disposal - First observed
event_treasury_stock_acquisition - First observed
event_treasury_stock_disposal - First observed
event_treasury_trust_contract - First observed
event_treasury_trust_termination - First observed
event_write_off_contingent_capital - First observed
financial_full_statements - First observed
financial_indicators - First observed
financial_multi_account - First observed
financial_single_account - First observed
financial_single_indicators - First observed
financial_xbrl_download - First observed
financial_xbrl_taxonomy - First observed
registration_debt_securities - First observed
registration_depositary_receipt - First observed
registration_equity_securities - First observed
registration_merger_registration - First observed
registration_split_registration - First observed
registration_stock_exchange_transfer - First observed
report_audit_service_contract - First observed
report_auditor_opinion - First observed
report_commercial_paper_balance - First observed
report_contingent_capital_balance - First observed
report_corporate_bond_balance - First observed
report_debt_securities_issuance - First observed
report_director_compensation - First observed
report_director_compensation_approval - First observed
report_director_compensation_by_type - First observed
report_director_individual_compensation - First observed
report_dividends - First observed
report_employees - First observed
report_executives - First observed
report_hybrid_securities_balance - First observed
report_individual_compensation - First observed
report_largest_shareholder_changes - First observed
report_largest_shareholders - First observed
report_minority_shareholders - First observed
report_non_audit_service_contract - First observed
report_other_corp_investments - First observed
report_outside_directors - First observed
report_private_placement_fund_usage - First observed
report_public_offering_fund_usage - First observed
report_short_term_bond_balance - First observed
report_stock_changes - First observed
report_total_stock_quantity - First observed
report_treasury_stock - First observed
report_unregistered_executive_compensation - First observed
shareholder_executive_stock - First observed
shareholder_major_stock
TDQS
Scored across 85 tools
Many tools are clearly separated by domain prefixes (financial_, report_, event_, etc.), but within groups there are overlapping concepts like report_director_compensation vs report_director_compensation_approval vs report_director_individual_compensation vs report_director_compensation_by_type, and event_asset_transfer vs event_business_acquisition vs event_business_disposal which could confuse an agent. The descriptions are terse and similar, making selection harder.
The naming convention is largely consistent: domain prefix (financial_, report_, event_, disclosure_, registration_, shareholder_, utility_) followed by a descriptive noun phrase. However, there are minor inconsistencies such as 'financial_multi_account' vs 'financial_single_account' vs 'financial_single_indicators' and 'report_largest_shareholder_changes' vs 'report_largest_shareholders' which break the pattern slightly.
85 tools is far beyond the typical well-scoped MCP server. While the domain (Korean financial disclosure) is broad, the tool count is excessive and will overwhelm agents. Many tools could be consolidated with parameters (e.g., a single event_decision tool with an event_type parameter).
The tool surface covers a wide range of financial disclosures: financial statements, XBRL, reports, events, registrations, and shareholder data. There are some minor gaps like no explicit tool for updating or deleting data, but for a read-only public disclosure API, the coverage is quite comprehensive. The inclusion of utility_get_current_date and disclosure_search_company helps agents navigate the API.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Powerful OpenDART API-based Korean corporate disclosure tools for accounting professionals
75 MCP tools: SEC financials, FRED economics, IRS 990, FDA, FX, UK Companies House.
The Octagon MCP server provides specialized AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It enables users to analyze public market data (SEC filings, earnings transcripts, financial metrics, and stock data for 8000+ companies), private market data (3M+ companies, 500k+ funding rounds, 2M+ M&A/IPO transactions), and conduct deep research including web scraping capabilities. The server also features autonomous research agents that search hundreds of sources and return fully cited reports in approximately one minute.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceMCP Server for public disclosure information of Korean companies, powered by the dartpoint.ai API.3Apache 2.0- AlicenseBqualityDmaintenanceProvides natural language access to South Korean corporate disclosure data, financial statements, and shareholder information through the DART Open API. It enables users to query 83 different tools for real-time reporting and regulatory filings from Korean listed companies.833MIT
- AlicenseAqualityDmaintenanceMCP server for Korea's DART (Data Analysis, Retrieval and Transfer) electronic disclosure system, operated by the Financial Supervisory Service (FSS). Exposes company disclosures, company profiles, and financial statements via the OpenDART public API.310MIT
- FlicenseNot gradedqualityCmaintenanceMCP server that searches and filters DART electronic disclosures for Korean companies, enabling AI agents to create investor briefing summaries.-
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/hypn4/opendart-fss-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server