Skip to main content
Glama

투표함 — 전자투표 법령 자료 · AI 투표함 (Korean e-voting statutes, quorum & ballot drafting)

소집통지 기록

record_notice

소집통지를 한 날짜·방법·대상 수를 기록한다(모든 안건). 기록이 하나 더해진다. manageToken 필요.

Input Schema

NameRequiredDescriptionDefault
noteNo비고(선택). 예: "우편 발송 영수증 보관"
methodYes통지 방법. 예: "등기우편", "문자", "게시판 공고", "이메일"
meetingIdYes집회 번호. create_draft_meeting 응답의 meetingId 또는 대시보드 주소의 m= 값. 예: "m_8f3kq2"
notifiedOnYes통지한 날짜 YYYY-MM-DD. 예: "2026-11-05"
recipientsNo통지 대상 수. 예: 366
manageTokenYes주최자가 넘겨준 관리 토큰(영숫자). 대시보드 주소의 # 뒤 값. 주최자가 확인·결제한 뒤에만 생긴다

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • addedInput schema / properties / manageToken / description
      Added value: +"주최자가 넘겨준 관리 토큰(영숫자). 대시보드 주소의 # 뒤 값. 주최자가 확인·결제한 뒤에만 생긴다"
    • addedInput schema / properties / meetingId / description
      Added value: +"집회 번호. create_draft_meeting 응답의 meetingId 또는 대시보드 주소의 m= 값. 예: \"m_8f3kq2\""
    • addedInput schema / properties / method / description
      Added value: +"통지 방법. 예: \"등기우편\", \"문자\", \"게시판 공고\", \"이메일\""
    • addedInput schema / properties / note / description
      Added value: +"비고(선택). 예: \"우편 발송 영수증 보관\""
    • changedInput schema / properties / notifiedOn / description
      Previous value: -"YYYY-MM-DD"New value: +"통지한 날짜 YYYY-MM-DD. 예: \"2026-11-05\""
    • addedInput schema / properties / recipients / description
      Added value: +"통지 대상 수. 예: 366"
  2. First observed

TDQS

A3.7/5.0
Behavior4/5

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

The description goes beyond annotations by disclosing the append semantic ('기록이 하나 더해진다'), which tells the agent that repeat calls accumulate records rather than updating — meaningful context reinforcing idempotentHint=false. It also surfaces the auth requirement (manageToken). It does not say what the response contains (e.g., the new record id).

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 compact sentences with the core action and scope front-loaded, then the side effect, then the precondition. No filler; only '기록이 하나 더해진다' borders on restating the action, but it carries real semantic weight.

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

Completeness4/5

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

For a non-idempotent mutation with no output schema, the description covers the essential: what is captured, that a record accumulates, and that a manageToken is required. The only gap is the return value (record identifier or confirmation), which matters if the agent must chain calls.

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 all six parameters are already documented with examples. The description only restates the captured fields (date/method/recipient count) and adds no format, validation, or edge-case guidance beyond the schema; the optional 'note' and 'recipients' handling is left entirely to the schema.

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 states a specific verb and resource (기록한다 / 소집통지) plus exactly which fields are captured: date, method, and recipient count, with the scope constraint '(모든 안건)'. It is clearly distinct from siblings like create_draft_meeting or close_meeting, though it does not name them explicitly.

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

Usage Guidelines3/5

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

Usage is implied rather than stated: it records a notice once one has been sent, and it discloses the prerequisite 'manageToken 필요'. There is no explicit when-not condition or reference to an alternative tool, so an agent must infer the trigger from 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.

Resources