Skip to main content
Glama

audit_microtransaction

Read-onlyIdempotent

Research the selected property and show the evidence needed for the requested records service. Returns source facts and available actions. It does not verify savings, quote a payable fee, inspect payment methods, charge, create a filing packet or submit a correction. Test checkout uses separate tools and requires account permission.

Input Schema

NameRequiredDescriptionDefault
addressNoExplicitly selected property street address or parcel ID. A nonblank address takes precedence over parcel_id.
parcel_idNoExplicitly selected county parcel ID / PIDN, used when address is absent or blank.
county_keyNoExact registered county adapter key, such as hamilton; restricts source lookup to that county.
service_typeYesExplicit research route selected from get_microtransactions_catalog. Common aliases: demolished_outbuilding, square_footage_correction, mailing_address_change, commercial_reclassification, certified_tax_ledger. No service is assumed.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already establish read-only, idempotent, non-destructive, open-world behavior. The description adds useful boundary context by listing what the tool does not do (verify savings, quote fees, inspect payment methods, charge, create a filing packet, submit a correction) and by noting test checkout requires separate tools and account permission. It still does not describe the return format in detail, so this is not a 5.

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?

The purpose is front-loaded, followed by return behavior and negative scope, and no sentence merely restates the name. The test-checkout sentence is relevant boundary information and earns its place.

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 100% schema coverage and annotations covering the safety profile, the main remaining gap is output detail: no output schema exists and the description only says it returns "source facts and available actions." That is enough to select the tool but not fully describe the evidence payload.

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?

All four parameters are fully documented in the schema, including address precedence over parcel_id, county_key scope, and service_type aliases from get_microtransactions_catalog. The description adds no parameter-level meaning beyond those schema descriptions, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific action ("Research the selected property") and output ("show the evidence needed for the requested records service"), which clearly frames the tool as a read-only research step. It separates itself from payment and checkout actions, but it does not name the closest research sibling such as get_property_assessment, and the tool name audit_microtransaction is not echoed.

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?

It establishes when the tool applies ("requested records service") and gives explicit when-not conditions for fee verification, charging, filing packets, corrections, and test checkout. However, it only refers to "separate tools" instead of naming the specific sibling alternatives, so guidance is clear but not fully explicit.

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.