Skip to main content
Glama

get_usage_stats

Read-onlyIdempotent

MyDART MCP의 get_usage_stats 도구는 도구 사용량 집계를 반환합니다 — 어떤 도구가 얼마나 쓰였는지.

[Purpose]

  • Per-tool call counts·popularity·latency·error rate·cache hits, plus daily trends.

[Usage]

  1. "사용량 통계 보여줘" → {} (default 30 days)

  2. "최근 90일 도구별 순위" → days=90

  3. "전체 기간 누적" → days=0

[Response]

  • Common: { period, overview:{total_calls, unique_users, error_rate}, by_tool:[{tool, calls, errors, avg_ms, cache_hits, cache_hit_rate, share_pct}], by_day[] }

  • Operator identity (local stdio, or the HTTP key matching the server operator's) additionally gets by_company·users·viewer — decided by requester identity, NOT selectable by parameter.

[Rules]

  • public responses have no by_company / per-user detail — do not promise them to general callers.

  • Local stdio may show total_calls>0 with unique_users=0 (single local user — not a contradiction).

  • error_rate is a 0~1 decimal; share_pct is a percentage — different units.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
daysNoTrailing window in days. 0 = the entire retained period.

TDQS

A4.4/5.0
Behavior5/5

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

Beyond the readOnly/idempotent/destructive annotations, the description discloses critical behavioral nuances: response content depends on requester identity (operator gets extra fields, public callers don't), local stdio may show total_calls>0 with unique_users=0, and error_rate uses a 0-1 decimal while share_pct is a percentage. These are non-obvious but essential for correct interpretation, making the tool much safer to use.

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

Conciseness4/5

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

The description is well-structured with clear [Purpose], [Usage], [Response], and [Rules] sections, front-loading the core purpose. Though verbose, every section adds necessary detail for a tool with conditional behavior; a slight over-length is justified by complexity, but it could be tightened.

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

Completeness5/5

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

With no output schema, the description carries the full burden of explaining response structure, which it does thoroughly: including common fields, conditional operator-specific fields, and important rules about units and edge cases. An agent has everything needed to call the tool and interpret results correctly.

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

Parameters3/5

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

The schema already fully explains the 'days' parameter (trailing window, 0=entire period, default 30). The description adds only usage examples, not new semantic meaning. With 100% schema coverage, the description's contribution here is minimal, 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.

Purpose5/5

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

The description clearly states the tool returns tool usage aggregates ('도구 사용량 집계를 반환합니다') and specifies exactly what metrics are included: per-tool call counts, popularity, latency, error rate, cache hits, and daily trends. This is distinct from sibling tools focused on financial data, audits, or documents, leaving no ambiguity about its purpose.

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

Usage Guidelines4/5

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

The [Usage] section provides three concrete examples mapping natural language requests to parameter values: default 30 days, days=90 for recent trends, and days=0 for all-time cumulative. While it doesn't explicitly contrast with alternatives, no sibling tool serves this purpose, and the examples give clear when-to-use context.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.7/5.0
Disambiguation5/5

Every tool targets a distinct aspect of the DART disclosure domain: full text, attachments, financial figures, audit facts, audit narrative, ICFR, going concern, company profile, events, periodic report sections, XBRL, valuation, usage stats, and two search entry points. Overlaps are resolved by explicit cross-references and clear purpose statements (e.g., get_audit_profile vs get_audit_report vs get_internal_control). No ambiguity remains.

Naming Consistency5/5

All 16 tools follow a consistent snake_case verb_noun pattern, with get_ for data retrieval, search_ for list queries, find_ for ID resolution, and download_ for the one document fetch. There is no mixing of camelCase, action words, or stylistic inconsistency. The pattern is immediately predictable.

Tool Count5/5

16 tools is slightly above the typical 3–15 range but fully justified by the breadth of DART (Korea's electronic disclosure system) – covering company lookup, filings, financials, audit reports, internal control, going concern, events, periodic reports, attachments, XBRL, valuation, and usage stats. Each tool address a distinct functional need, and no tool feels redundant or extraneous. The scope is comprehensive yet not bloated.

Completeness5/5

The tool surface covers the full lifecycle of disclosure data access: finding entities (find_corp_code), locating filings (search_disclosures), retrieving financials (get_financials, get_xbrl), reading full text (download_document), fetching attachments (get_attachments), and drilling into audit-related details (get_audit_profile, get_audit_report, get_internal_control, get_going_concern). Periodic report sections (28 types) and corporate events cover governance and capital changes. No obvious dead ends or missing critical operations for a read-only disclosure access server.

Resources