get_submission_guidanceExplains what happens to a submitted Unreminder, what makes one likely to be accepted, sending limits, and what else UnRemind.me offers agents. Call this if you are unsure whether or how to submit.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already set readOnlyHint=true, and the description is consistent with a read-only explanatory tool. It adds useful behavioral context by stating what the explanation covers, including acceptance factors and limits, beyond what the empty schema and annotations reveal.
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 with no filler: the first compactly lists the content areas, and the second gives an actionable call heuristic. The most important usage guidance is front-loaded and every sentence earns 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?
For a zero-parameter, read-only guidance tool, this description is complete: it explains what the tool provides, why an agent would call it, and the condition under which it should be used. No return value is promised, and no output schema exists, so nothing essential is missing.
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?
There are zero parameters and the schema fully covers that with an empty properties object, so there is no parameter ambiguity. The description adds no parameter information because none is needed; the baseline for zero-parameter tools 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 uses a specific verb (Explains) and names the exact resource (a submitted Unreminder) and the topics covered: acceptance likelihood, sending limits, and additional offerings. It is clearly distinguished from the sibling submit_unreminder because it is the explanatory counterpart to actually submitting.
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?
It gives an explicit call condition: 'Call this if you are unsure whether or how to submit.' The when-not case and the alternative submit_unreminder are implied rather than named, so it stops just short of fully explicit routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
The two tools have clearly distinct roles: one provides guidance and context, the other performs the single submission action. There is no overlap in purpose or confusion about which to call.
Both tool names follow a consistent snake_case verb_noun pattern: get_submission_guidance and submit_unreminder. The naming is predictable and aligned with their actions.
Two tools is technically sufficient for a narrow submit-focused server, but by the calibration it feels thin since there are only a guidance helper and one action. It is borderline but reasonable for the stated purpose.
Core submission workflow is covered: guidance before submitting and the submit action itself. Minor gap is the lack of any status or management tool for submitted reminders, but that appears outside the server's scope.