remind_request
Manda de novo o e-mail de um pedido a uma pessoa, com o que ainda falta (id de list_requests). Só se o usuário pediu.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request_id | Yes |
Manda de novo o e-mail de um pedido a uma pessoa, com o que ainda falta (id de list_requests). Só se o usuário pediu.
| Name | Required | Description | Default |
|---|---|---|---|
| request_id | Yes |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It does disclose the key side effect — an actual email is sent to a person and its content is derived from what is still pending — plus a user-consent guardrail, which is more than the name alone. However, it says nothing about re-send throttling, required permissions, what happens if nothing is pending, or whether the request state changes.
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?
One compact sentence with the action front-loaded, then the id source, then the guardrail — every clause carries information and there is no filler. The only weakness is that the provenance parenthetical interrupts the guardrail, slightly muddling the closing constraint.
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 one-parameter tool with no output schema and no annotations, the definition conveys the action, the id source and the consent condition, which covers the essentials. It leaves out what the tool returns, whether requests without pending items are rejected, and any rate limiting — meaningful for an outbound-email tool but not blocking correct invocation.
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?
Schema description coverage is 0% for the single parameter, so the description must compensate, and it does so on the most important ambiguity: it tells the agent the request_id comes from list_requests, providing provenance for an otherwise bare string. What is missing is only format/example detail, a minor gap for a single opaque id.
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?
Names a specific verb+resource combination ('Manda de novo o e-mail de um pedido' = resend a request's email), which is clearly distinct from sibling tools like create_request, list_requests and request_documents. The parenthetical pointing to list_requests as the id source further disambiguates it, though it never explicitly contrasts itself with those siblings.
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?
'Só se o usuário pediu' is an explicit consent-based usage constraint that tells the agent when it must NOT self-initiate the tool, which is unusually valuable for an outbound-email action. It also directs the agent to list_requests for obtaining the id, giving a concrete pre-call step, but stops short of naming alternatives or state prerequisites.
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.