Skip to main content
Glama

SQLGuard — permission before production writes

Verify Execution Certificate

sqlguard_verify
Read-onlyIdempotent

REQUIRED before production execute. Verify Execution Certificate signature, expiry, and PASS. If verify fails, do not write.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
signatureYesEd25519 signature string over the certificate bytes
accept_demoNoIf true, accept demo-mode certificates (non-production)
certificateYesExecution Certificate object returned by sqlguard_validate
public_key_pemNoOptional PEM public key; defaults to SQLGuard live attestation key
expected_sql_hashNoOptional hex hash that must match certificate.sql_hash
expected_schema_hashNoOptional hex hash that must match certificate.schema_hash

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
validNoWhether the certificate signature and claims verify
reasonsNoFailure reasons when valid is false
decisionNoPASS/FAIL from the verified certificate

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare read-only and non-destructive behavior. The description adds valuable workflow constraints: it must run before production execution and instructs not to write if verification fails. This goes beyond the annotation-provided safety profile without contradicting it.

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

Conciseness5/5

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

Two succinct sentences, front-loaded with the critical 'REQUIRED' note. Every sentence provides meaningful information without waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a rich output schema and full parameter descriptions, the tool is well-documented. The description adds the essential workflow context and conditional behavior, making it complete enough for a verification tool of this complexity.

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?

Input schema covers all 6 parameters with descriptions (100% coverage), so the baseline is 3. The description itself does not elaborate on parameter semantics, leaving the schema to carry the full burden, which it does adequately.

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 the tool verifies an Execution Certificate's signature, expiry, and PASS status. The 'REQUIRED before production execute' context differentiates it from sibling validation tools, making the purpose specific and unambiguous.

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

Usage Guidelines4/5

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

Explicitly states when the tool is required ('before production execute'), providing strong usage context. However, it does not mention when not to use it or alternative tools, so it falls short of a 5.

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.

TDQS

C2.9/5.0
Disambiguation2/5

The tool set is dominated by overlapping buy/unlock paths (challenge, pilot, buy, catalog, cert, session, workday, sprint, profit, handshake) that are poorly differentiated, with many marked as legacy or off-table. Only a few tools (bind, gate, verify, effects) have clearly distinct roles.

Naming Consistency2/5

All tools share the sqlguard_ prefix, but the second part is a mix of nouns, verbs, and vague branding (gravity, profit, sprint, handshake). There is no consistent verb_noun pattern, making it hard to predict a tool's purpose from its name.

Tool Count3/5

24 tools is heavy for a permission gateway, and many are redundant legacy or alternative buy paths. While the count is within the 16-25 borderline range, the core functionality could likely be served by 8-10 tools.

Completeness3/5

The core authorization flow (handshake → challenge/unlock → bind/gate → verify) is present, but the surface is muddied by legacy and alternative paths that create dead ends. Missing tools for managing denials or configuring policies leave some gaps, though the central lifecycle is covered.