Skip to main content
Glama

独行录 / opcmenu

看一场报名详情(含我的报名状态)

get_signup_activity
Read-onlyIdempotent

【何时用】用户对某一场感兴趣、或准备报名之前调它。一次调用给全上下文:公开详情(简介/时间/地点/名额/题目表)+(登录时)我的报名状态、每题现值、还缺哪几个必填项。

【组合链】① viewer.missingRequired 非空 → 照 label/hint/options 问用户,答完 submit_signup(slug, answers=[…]);② 多场一起缺 → get_signup_gaps 一次问完;③ submitted=true → list_my_signups 看处置到哪步,别重复报。

【口径/坑】① fillable=false 的题(type=file 附件题,如 BP)agent 传不了文件,只能让用户去 App / 报名页传,绝不许瞎编「已填」或塞链接冒充。② 不返回 autofillScript(注入 webview 的 JS,对 agent 零价值)。③ valuePreview 里联系方式/证件题一律打码,那是判「填没填」用的,别复述。④ externalIsCanonical=true ⇒ 正式报名在主办方外部表单上,站内提交只是留资+代填。⑤ requiresPhoneVerification=true 分两路,看 requiresAppActivation:false 时只约束公开报名页上的游客,你是登录态照常提交;true 时这场要装 App 激活,agent 提交只拿到预留位、不落报名单,先让用户去 App。⑥ canOneClick=false 且无 externalUrl ⇒ 报名没配好,submit_signup 会拒(signup_not_open),别硬报。⑦ agreement.required=true 且 accepted=false ⇒ 不念协议不许提交:正文不在这里,用 get_activity_agreement(slug) 取全文念完、拿到明确同意再带 versionId 提交。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
slugYes活动 slug(取自 list_signup_feed 的 items[].slug)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare this as read-only, idempotent, and non-destructive, and the description adds substantial behavioral context beyond that: it discloses that autofillScript is not returned, that valuePreview fields are masked, that externalIsCanonical changes where the real submission happens, that requiresPhoneVerification has two branches, and that unconfigured signups will cause submit_signup to reject with signup_not_open. 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.

Conciseness4/5

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

The description is long but not bloated; it is organized into clear sections ('何时用', '组合链', '口径/坑') and each bullet addresses a real decision an agent would face. It is front-loaded with the primary use case and one-call value proposition. A slight deduction because the density is heavy, but every item earns its place.

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?

For a tool with a single parameter and no output schema, the description is remarkably complete. It enumerates the return content, identifies consumed fields like viewer.missingRequired and valuePreview, and explains seven edge-case behaviors that materially affect whether the agent should continue to submit_signup, fetch the agreement, or direct the user to the App. Nothing essential for correct invocation is missing.

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 documents the lone slug parameter thoroughly with its source ('取自 list_signup_feed 的 items[].slug'), so coverage is 100%. The description references slug in the submit chain but adds no new semantic constraints or format details beyond what the schema provides, leaving the baseline of 3 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 a specific verb and resource: view a single event's signup details plus the caller's own signup status. It distinguishes itself from siblings by naming exactly what it returns (public details, my status, per-question values, missing required fields) and by routing to alternatives like get_signup_gaps and list_my_signups.

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

Usage Guidelines5/5

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

The opening line gives an explicit when-to-use condition: when the user is interested in a specific event or about to sign up. The '组合链' section provides concrete decision rules with named alternatives — get_signup_gaps for multi-event gaps and list_my_signups after submission — so an agent knows exactly when to choose this tool over siblings.

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