Skip to main content
Glama

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.9/5.0
Behavior5/5

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

The annotations only say the tool is not read-only, not open-world-safe, not idempotent, and not destructive. The description adds substantial behavioral context beyond that: the caller receives a pg_ ticket number, identical reports collapse onto one line, later reports fill in blanks, long pastes are refused rather than stored, and fixes go PENDING with a runnable test.

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 it is densely informative and uses uppercase section cues (FILE A TICKET, CHECK IT IS NOT, FILE IT LIKE A SPEC, YOU GET A TICKET NUMBER BACK) to create structure. It is not maximally concise, but almost every sentence adds operational guidance the agent needs.

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?

Despite having no output schema, the description explains what the tool returns (`pg_…` ticket number), how to follow up with gap_check and gap_reply, how deduplication behaves, how partial reports are handled, and what must not be sent. Nothing essential to invoking this tool correctly is missing.

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

Parameters5/5

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

Even though schema coverage is 100%, the description adds meaning the schema does not: `answered` is called "the single most useful field," with instructions to quote it verbatim rather than characterize it; `verb` is explained as an alias for `surface`; `want` is constrained to one sentence; and `expected` is defined as a concrete acceptance line with an example.

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 opens with a specific verb and resource: "FILE A TICKET on Lucerna itself — the platform's own homework list." It names the three report kinds (missing, wrong, poor) with concrete tests for each, and its workflow references to gap_check/gap_reply clearly separate it from those siblings.

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?

It states exactly when to use the tool — a missing verb, a wrong answer, or a poor result — and when not to: "CHECK IT IS NOT A MODULE YOU DO NOT HAVE" and don't file for something that already ships. It also explains the follow-up path through gap_check and gap_reply, giving the agent a full decision 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