Skip to main content
Glama

Report a problem

report_gap

FILE A TICKET on Lucerna itself — the platform's own homework list. Three things put you here: a verb that does not exist (missing), a door that answered and its answer is not true (wrong), or a door that worked and the RESULT was bad — a page that built ugly, an answer that was thin, a refusal that named a way out this caller does not have (poor). The third one matters as much as the other two and is the one agents skip, because nothing stopped you. If your human would not be happy with what this platform just produced, that is a ticket. CHECK IT IS NOT A MODULE YOU DO NOT HAVE. A verb missing from your catalog may be switched OFF for this shop rather than absent from the platform — upgrade.list and modules.off say which, and 'there is no verb for this anywhere' is the one claim this queue cannot verify for you. A ticket asking us to build something that already ships aims the roadmap at work nobody needs. FILE IT LIKE A SPEC, NOT A COMPLAINT. want is the one sentence. expected is the acceptance line — what a correct answer would have looked like, concretely enough that somebody could tell when it is done. answered is WHAT THE DOOR ACTUALLY SAID, quoted short, and it is the single most useful field you can send: the difference between a knob that is missing and a whole mechanism that is missing is usually sitting verbatim in the refusal you just read. Do not characterise it — quote it. YOU GET A TICKET NUMBER BACK (pg_…) AND IT IS WORTH KEEPING. filing is no longer one-way — gap_check with that id says where your report got to, and when we think we have fixed it the ticket goes PENDING carrying the literal test you can run to check us. gap_reply with verdict fixed closes it, still_broken sends it straight back to the queue with your sentence as the reason. Nothing here waits on you and no reply is required, but a reporter who checks a fix is the only evidence this platform has that one held. An identical report from anybody else collapses onto the same line, so a wall a hundred agents hit reads as a hundred rather than as a hundred tickets, and that count is what decides what gets built next. A later report fills in fields an earlier one left blank, so send what you have even when it is partial. Report what you MEASURED, never what you imagine — this is a homework list, not a wishlist, and one speculative feature request buries the real ones. Do NOT send your human's brief or anything that identifies them: it is their document, no tool here accepts one, and a long paste is refused rather than stored. Describe the CAPABILITY you needed, never the person who needed it.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
kindNo`missing` — no such verb, nothing to call. `wrong` — a door answered and the answer is not true. `poor` — it worked and the result was bad. Leave it off rather than guessing.
shopNothe shop you were working on, if there was one
verbNothe same thing as `surface`, by the word you probably reached for first
wantYesone sentence: what you were trying to do that this platform could not do, or did badly
surfaceNothe tool or verb you tried, if you know it — e.g. `front.set`, `checkout_intent`. `verb` works as a name for this too
answeredNowhat the door actually said, quoted short — the refusal text, the wrong value, or the thin result that was not good enough. The most useful field here.
expectedNothe acceptance line: what a correct answer would have looked like, concrete enough to check — e.g. 'the owner names a percentage and the shop’s cut on each seller sale becomes that number'

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.7/5.0
Behavior5/5

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

The description goes far beyond annotations: it discloses that the tool returns a pg_ ticket number, that duplicate reports collapse onto the same line, that later reports fill in blanks, and that long pastes are refused rather than stored. It also explains the open-world limitation that 'there is no verb for this anywhere' cannot be verified, aligning with openWorldHint without contradicting any annotation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

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

The content is dense and substantive, but the description is very long and heavily all-capped, making it harder to scan than necessary. Some motivational asides ('The third one matters as much as the other two...') are not strictly operational and could be trimmed, though the overall structure moves from action to conditions to field guidance to follow-up.

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 7-parameter reporting tool with no output schema, the description is unusually complete: it covers prerequisites, field semantics, return value, follow-up flow, deduplication behavior, privacy constraints, and when not to file. An agent has what it needs to call this tool correctly and understand the consequences.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real semantic value above the schema: 'want' must be one sentence, 'expected' is the acceptance line, and 'answered' should be quoted verbatim as the most useful field. This clarifies how to fill the most consequential parameters beyond their schema descriptions.

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 states a specific action and resource: "FILE A TICKET on Lucerna itself — the platform's own homework list." It then enumerates exactly what counts as a reportable problem (missing, wrong, poor), which clearly separates this filing tool from its follow-up siblings gap_check and gap_reply.

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 description gives explicit when-to-use conditions and exclusions: the three problem kinds, the instruction to check upgrade.list/modules.off before filing, and the privacy rule not to send a human's brief. It also routes to gap_check and gap_reply for follow-up, so an agent knows this tool is for filing only.

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