Skip to main content
Glama

get_recent_notices

Read-onlyIdempotent

숭실대 학교 공지사항 최신 목록을 조회합니다. category 를 지정하면 해당 카테고리만 필터링합니다. 카테고리 목록은 list_notice_categories 도구로 확인할 수 있습니다. compact=true 지원.

Input Schema

NameRequiredDescriptionDefault
pageNo페이지 번호 (1부터). 기본값 1.
compactNocompact=true: 제목·URL만 반환. compact=false(기본): 날짜·카테고리 포함.
categoryNo카테고리 (선택): 학사/장학/국제교류/외국인유학생/채용/비교과·행사/교원채용/교직/봉사/기타. 비워두면 전체.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / compact
      Added value: +{
      +  "description": "compact=true: 제목·URL만 반환. compact=false(기본): 날짜·카테고리 포함.",
      +  "type": "boolean"
      +}
  2. First observed

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered. The description adds behavioral context about category filtering and compact-mode support, but stops short of describing pagination behavior, result limits, or what fields come back — and 'compact=true 지원' is a bare feature flag that the schema has to explain.

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?

Three short Korean sentences with the core purpose front-loaded; no filler or repetition. The compact mention is terse enough to seem cryptic without the schema, which keeps this from a 5.

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

Completeness3/5

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

For a simple read-only list tool with rich annotations and fully documented parameters, the description is mostly adequate. Gaps: there is no output schema to define the return format and the description does not cover it, nor does it clarify page/pagination semantics or differentiate from get_active_notices/search_notices.

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?

Schema description coverage is 100%, so the baseline is 3; the schema already documents page defaults, compact's return differences, and the full category list. The description adds modest value by stating category's filtering role and pointing to list_notice_categories, but nothing beyond that.

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

Purpose4/5

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

The description opens with a specific verb+resource: '공지사항 최신 목록을 조회합니다' (retrieves the latest notice list), and adds the category-filtering scope. However, it never distinguishes itself from closely related siblings like get_active_notices, get_department_notices, or search_notices, so an agent must infer which notice-listing tool fits the task.

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

Usage Guidelines3/5

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

It provides one useful routing pointer — use list_notice_categories to obtain valid category values — but gives no when-to-use versus when-not-to-use guidance relative to the four other notice tools. Usage context is implied ('최신' = latest) rather than stated as a selection rule.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources