Kluster.ai Verify MCPofficial
A
license-
quality-
maintenanceEnables fact-checking of AI responses against reliable sources and validation of responses against document content to ensure accuracy and reliability.
Drillable
Server Details
A multi-domain reference corpus where every answer drills down to its cited, verified source.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
MCP client
Glama
MCP server
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
100% free. Your data is private.
Tool Definition Quality
A4.3/5.0
Tool DescriptionsA
Average 4.4/5 across 8 of 8 tools scored. Lowest: 3.7/5.
Server CoherenceA
Disambiguation5/5
Each tool maps to a distinct query operation: search for ranked results, lookup for glossary definitions, enumerate for complete sets, compute for aggregates, verify for claim checks, describe for introspection, call for domain-verb dispatch, and notify_when_held for async registration. There is no meaningful overlap between these purposes, and the descriptions explicitly delineate boundaries (e.g., search vs. enumerate).
Naming Consistency4/5
The tool names are all lowercase verbs (call, compute, describe, enumerate, lookup, search, verify) with one exception: notify_when_held uses a multi-word snake_case form. While the verb-first pattern is consistent, the length and underscore in the outlier create a minor stylistic deviation.
Tool Count5/5
The server spans hundreds of domains, but 8 tools cover the distinct access patterns needed: retrieval, aggregation, verification, discovery, dispatch, and notification. This is well within the ideal 3-15 range and each tool earns its place without redundancy.
Completeness5/5
The set covers every core query shape for a read-only knowledge server: searching records, defining terms, enumerating complete sets, computing aggregates, verifying claims, discovering capabilities, invoking domain-specific verbs, and registering for future answers. No obvious gaps exist—missing data is handled via automatic demand logging rather than requiring extra tools.
Available Tools
8 toolscallCall a domain verbARead-onlyInspect
Invoke a domain verb discovered via describe: call(domain, tool, args). Identical to the namespaced tool surface — every answer drills to its source; a miss is a typed abstention (logged as demand), never a guess. Do NOT invent tool names — take them from describe.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | Arguments for that verb, per its describe() inputSchema. | |
| tool | Yes | The domain verb to invoke (e.g. 'reachable_cocktails'). | |
| domain | Yes | The mounted domain (e.g. 'cocktail'). |
Tool Definition Quality
A4.2/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds behavioral context beyond the readOnlyHint annotation: it explains that a miss results in a typed abstention and logging, and reassures that the tool never guesses. This is valuable transparency for agent decision-making.
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 description is concise (two sentences) and front-loaded: the first sentence defines purpose and format, the second provides critical behavioral rules. No unnecessary words.
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?
Given the tool's generic nature (3 parameters, no output schema), the description covers the essential connection to describe and the abstention logging. It is sufficiently complete for an agent to use correctly, though it could mention return behavior (though output schema is absent).
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?
Schema coverage is 100%, so the schema already documents all parameters. The description adds minimal extra meaning (e.g., clarifying that args come from describe's inputSchema), which is helpful but not substantial. Baseline 3 is appropriate.
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 that the tool invokes a domain verb discovered via describe, with a specific format call(domain, tool, args). It distinguishes from sibling tools by emphasizing that it is identical to the namespaced tool surface and that agents must not invent verb names.
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?
The description provides explicit guidance on when to use the tool (after describe), and what to avoid (inventing tool names). It also explains the behavior on a miss (logged abstention, never a guess). However, it does not explicitly discuss when not to use it or list alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
computeCount or group a domain's recordsARead-onlyInspect
A deterministic AGGREGATE over ONE corpus's COMPLETE set — the calculated-query shape ("how many X", "break X down by Y", "which is most common"). Requires domain; optional filter scopes the set (e.g. {"spirit":"gin"}); optional by (a record field) returns the count PER value, sorted, with the largest. Built ON enumerate, so it inherits the completeness contract: over an INCOMPLETE set it ABSTAINS rather than undercount. It counts on GROUND and refuses to crown a "best"/worth ranking (that has no oracle — the user's call). For the records/categories themselves use enumerate. Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, compost, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, flag-semaphore, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, beer-styles, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, sun-safety, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, voting-theory-social-choice, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, iarc-carcinogen-classification-registry, larmor-precession, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, hornbostel-sachs-instrument-classification, helmholtz-resonator-port-tuning, ethernet-cable-category-ratings, propeller-pitch-slip-thrust, pencil-lead-diameter-and-hardness-scale, hydraulic-jump-open-channel-flow, epa-air-quality-index-breakpoints, concrete-maturity-method, wet-bulb-globe-temperature-wbgt, chemical-compound-physical-properties, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, tippet-x-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, iata-icao-airline-designators, hl7v2-message-type-registry, clothing-pattern-drop-and-suit-size-system, bowling-ball-drilling-layout, tippet-x-diameter-calculator, curie-weiss-magnetic-susceptibility, penman-monteith-reference-evapotranspiration, camera-lens-filter-thread-and-step-ring-sizing, amateur-radio-contest-scoring, optimal-stopping-theory, cherenkov-radiation-angle, zeeman-effect-splitting, josephson-junction-relation, nfpa-704-fire-diamond, dea-controlled-substance-schedules, thermal-expansion, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, volcanic-explosivity-index, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, digit-lottery, cvss-scoring, dicom-tag-dictionary, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, gymnastics-code-of-points, archery-target-scoring, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, isbn-registration-group-ranges, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, climbing-grade-conversion-scales, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, ipcc-climate-findings, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, systemd, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, epidemiology-surveillance, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, food-recalls, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, national-register-historic-places-criteria, codex-alimentarius-food-standards, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, knowledge-organization, max-msp, ultrasound-imaging, modular-synthesis, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, sigma, music-thing-modular, cwejman, doepfer, befaco, 1010-music, joranalogue-audio-design, addac-system, instruo, ai-synthesis.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | Optional: a record field to group the count by (e.g. 'family'). Omit for a plain count. Discover fields via `enumerate`. | |
| domain | Yes | The corpus to compute over (required). | |
| filter | No | Optional faceted constraints to scope the set (e.g. {"spirit":"gin"}). |
Tool Definition Quality
A4.4/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the readOnlyHint annotation, the description reveals key behavioral traits: determinism, abstention on incomplete sets, refusal to rank, and inheritance of the completeness contract from `enumerate`. This goes well beyond what annotations alone provide.
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 core description is compact and front-loaded, but it is appended with an extremely long list of mounted corpora (hundreds of entries) that is mostly noise for an agent. This hurts conciseness, though the structure is clear.
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?
Given there is no output schema, the description explains the return behavior for grouped counts ('count PER value, sorted, with the largest') and the completeness contract. It does not explicitly state the return type for plain counts or error handling, but it is largely sufficient for a 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?
The input schema already covers all parameters with descriptions and examples (100% coverage). The description adds minimal extra meaning—mostly the 'sorted, with the largest' detail for the `by` parameter—but does not significantly compensate beyond the schema baseline.
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 this is 'a deterministic AGGREGATE over ONE corpus's COMPLETE set' with specific use cases ('how many X', 'break X down by Y'). It differentiates from siblings by explicitly directing users to `enumerate` for records/categories themselves.
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 explicitly states when to use this tool (aggregate calculations) and when not to ('refuses to crown a "best"/worth ranking'), and names the alternative tool (`enumerate`). It also alerts users about abstaining on incomplete sets, which is a clear usage boundary.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
describeDescribe a domain's toolsARead-onlyInspect
Discover the fleet's deeper machinery. No args → every mounted domain with its verbs grouped by rung (lookup → composability → contested → frontier). With domain → that domain's full tool list with descriptions and input schemas. Invoke anything it lists via call. Use this whenever the spine (lookup/search/verify) is too shallow for the question — e.g. "what can I make/patch/cover with MY inventory", contested claims, open questions.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | No | Optional: one domain's full tool schemas (e.g. 'cocktail'). |
Tool Definition Quality
A4.6/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds context beyond the readOnlyHint annotation by explaining the two modes (no args vs domain) and that it returns tool lists with descriptions and schemas, which is non-destructive and informative.
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?
Concise and well-structured with two clear functional sections and usage guidance. Could be slightly shorter but remains efficient.
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?
Fully complete for an informational tool with no output schema. Covers both invocation modes, usage context, and examples, leaving no gaps.
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% with the single optional parameter. The description adds value by explaining the behavior difference when domain is provided vs not, going beyond the schema's basic description.
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's purpose: to discover deeper machinery by listing all domains or a specific domain's tools with schemas. It distinguishes itself from sibling tools like lookup and search by being for deeper exploration.
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?
Explicitly states when to use: 'whenever the spine (lookup/search/verify) is too shallow for the question' and gives concrete examples like contested claims or open questions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
enumerateList a domain's categories or complete setARead-onlyInspect
List broad CATEGORIES or the COMPLETE set within ONE corpus — the shape search cannot serve (search returns a ranked, capped sample, not the whole set). Requires domain. Returns every category axis with exact counts, and — with an optional filter (faceted constraints, e.g. {"spirit":"gin"}) — the COMPLETE record set scoped by it, marked complete. A count/aggregate is sound ONLY over a complete set; an incomplete return is flagged, never silently undercounted (the completeness contract). Use for "what kinds are there", "all the X", "how many X"; for one record use lookup/search. Discover a domain's facets via describe. The special domain directory enumerates the FLEET itself — the algorithm domains drillable holds (declared registry tags, faceted by class/grain; e.g. "what algorithms are there?"). Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, compost, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, flag-semaphore, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, beer-styles, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, sun-safety, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, voting-theory-social-choice, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, iarc-carcinogen-classification-registry, larmor-precession, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, hornbostel-sachs-instrument-classification, helmholtz-resonator-port-tuning, ethernet-cable-category-ratings, propeller-pitch-slip-thrust, pencil-lead-diameter-and-hardness-scale, hydraulic-jump-open-channel-flow, epa-air-quality-index-breakpoints, concrete-maturity-method, wet-bulb-globe-temperature-wbgt, chemical-compound-physical-properties, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, tippet-x-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, iata-icao-airline-designators, hl7v2-message-type-registry, clothing-pattern-drop-and-suit-size-system, bowling-ball-drilling-layout, tippet-x-diameter-calculator, curie-weiss-magnetic-susceptibility, penman-monteith-reference-evapotranspiration, camera-lens-filter-thread-and-step-ring-sizing, amateur-radio-contest-scoring, optimal-stopping-theory, cherenkov-radiation-angle, zeeman-effect-splitting, josephson-junction-relation, nfpa-704-fire-diamond, dea-controlled-substance-schedules, thermal-expansion, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, volcanic-explosivity-index, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, digit-lottery, cvss-scoring, dicom-tag-dictionary, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, gymnastics-code-of-points, archery-target-scoring, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, isbn-registration-group-ranges, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, climbing-grade-conversion-scales, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, ipcc-climate-findings, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, systemd, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, epidemiology-surveillance, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, food-recalls, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, national-register-historic-places-criteria, codex-alimentarius-food-standards, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, knowledge-organization, max-msp, ultrasound-imaging, modular-synthesis, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, sigma, music-thing-modular, cwejman, doepfer, befaco, 1010-music, joranalogue-audio-design, addac-system, instruo, ai-synthesis.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | The corpus to enumerate (required), e.g. 'cocktail'. | |
| filter | No | Optional faceted constraints to scope the complete set (e.g. {"family":"sour"}). |
Tool Definition Quality
A4.8/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations include readOnlyHint=true, and the description reinforces this with 'List'. It adds significant context beyond the annotation by explaining the completeness contract: counts are sound only over a complete set, incomplete returns are flagged, and the complete record set is marked 'complete'. It also details the special `directory` domain behavior. No contradictions.
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 core explanation is well-structured and front-loaded: purpose, then usage guidance, then special domain, then the mounted corpus list. The list is unusually long but not prose bloat; it is easily skippable reference data. Overall, the description is dense but organized, earning a 4 rather than a 5 due to its excessive length.
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?
With no output schema, the description carries the full burden of explaining return values, which it does: 'returns every category axis with exact counts', complete record set marked 'complete', and the completeness contract. It also covers the special `directory` domain and mounted corpora. This is thorough for a two-parameter tool.
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 description coverage is 100%, providing baseline context for both parameters. The description adds extra meaning by giving concrete filter examples (e.g., {"spirit":"gin"}) and explicitly explaining that the filter scopes the complete set. This goes beyond the schema's basic descriptions, though not to the level of exhaustive syntax or operator details.
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 lists broad categories or the complete set within one corpus, using specific verbs and a resource. It explicitly distinguishes itself from search, which returns a ranked, capped sample, and from lookup/search for a single record. This makes the purpose unambiguous and differentiates it from 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?
The description provides explicit use cases: 'what kinds are there', 'all the X', 'how many X'. It also names alternatives for single-record lookups (`lookup`/`search`) and suggests `describe` for discovering facets. This gives clear when-to-use and when-not-to-use guidance, exceeding basic expectations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
lookupLook up a conceptARead-onlyInspect
Define a concept/term from a domain's glossary (e.g. 'stir', 'crop-factor', 'roughness'). Routes to each domain's lookup_concept; pass domain to target one, omit to fan out. For entities/records use search. Abstains on a miss, which is logged as a gap (the demand signal) — there is no report_gap verb. For COMPUTED quantities (molar mass, date math, unit conversions) a miss will point you to the right compute verb — follow it via describe/call rather than re-searching. Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, compost, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, flag-semaphore, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, beer-styles, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, sun-safety, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, voting-theory-social-choice, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, iarc-carcinogen-classification-registry, larmor-precession, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, hornbostel-sachs-instrument-classification, helmholtz-resonator-port-tuning, ethernet-cable-category-ratings, propeller-pitch-slip-thrust, pencil-lead-diameter-and-hardness-scale, hydraulic-jump-open-channel-flow, epa-air-quality-index-breakpoints, concrete-maturity-method, wet-bulb-globe-temperature-wbgt, chemical-compound-physical-properties, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, tippet-x-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, iata-icao-airline-designators, hl7v2-message-type-registry, clothing-pattern-drop-and-suit-size-system, bowling-ball-drilling-layout, tippet-x-diameter-calculator, curie-weiss-magnetic-susceptibility, penman-monteith-reference-evapotranspiration, camera-lens-filter-thread-and-step-ring-sizing, amateur-radio-contest-scoring, optimal-stopping-theory, cherenkov-radiation-angle, zeeman-effect-splitting, josephson-junction-relation, nfpa-704-fire-diamond, dea-controlled-substance-schedules, thermal-expansion, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, volcanic-explosivity-index, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, digit-lottery, cvss-scoring, dicom-tag-dictionary, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, gymnastics-code-of-points, archery-target-scoring, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, isbn-registration-group-ranges, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, climbing-grade-conversion-scales, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, ipcc-climate-findings, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, systemd, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, epidemiology-surveillance, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, food-recalls, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, national-register-historic-places-criteria, codex-alimentarius-food-standards, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, knowledge-organization, max-msp, ultrasound-imaging, modular-synthesis, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, sigma, music-thing-modular, cwejman, doepfer, befaco, 1010-music, joranalogue-audio-design, addac-system, instruo, ai-synthesis. If your user's topic isn't in that list, issue the query anyway rather than declining from the roster — an unrouted miss that grounds nowhere is the demand signal for what the corpus should cover next.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The concept/entity to resolve. | |
| domain | No | Optional: restrict to one domain (e.g. 'acupuncture'). |
Tool Definition Quality
A4.9/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses multiple behavioral traits not covered by the readOnlyHint annotation: it routes to each domain's lookup_concept, abstains on a miss, logs misses as a gap (with no report_gap verb), and directs computed quantity misses to the right compute verb. These are valuable details that go beyond the sparse annotation.
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 core guidance is front-loaded and efficient, with each behavioral rule stated succinctly. However, the enormous mounted-corpora list makes the description long. While the list is informative, it could be seen as excessive; still, it served a purpose and the essential guidance remains clear and well-structured.
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 fully covers the tool's behavior: routing logic, domain targeting, miss behavior, computed quantity handling, and fallback guidance. It addresses both normal and edge cases, making it a complete guide for correct invocation and interpretation of results.
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?
Although the schema provides descriptions for both parameters (100% coverage), the description adds crucial semantic context: the distinction between concept/term lookups and entity records, the optionality of `domain` and its fan-out behavior, and the miss-handling semantics. This materially enhances understanding beyond the schema alone.
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: 'Define a concept/term from a domain's glossary' with concrete examples. It also explicitly distinguishes itself from the sibling 'search' tool ('For entities/records use `search`'), making purpose unambiguous.
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 detailed when-to-use guidance: it states when to pass `domain` vs. omit it (fan out), provides an explicit alternative for entities/records (`search`), and instructs that computed quantities should be routed to the appropriate compute verb via `describe`/`call` rather than re-searching. It even tells the agent to issue queries for unmounted topics rather than declining, covering edge cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
notify_when_heldAsk to hear when a missing answer landsAInspect
Register your user's standing interest in a question the corpus can't answer yet: when it becomes answerable, they get one email. Call this ONLY when the user themselves asked to be told — ask them first, this session, and use the email they give you now; never volunteer an address you hold from context or memory. One call per question.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | The email the user gave you this session for this purpose. | ||
| query | Yes | The question to follow, as the user asked it. |
Tool Definition Quality
A4.5/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations present, so description carries full burden. It discloses that one email will be sent when answerable and requires explicit user consent. However, it doesn't clarify behavior if called multiple times for same question beyond 'one call per question'.
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?
Description is 4 sentences long, front-loaded with purpose, then usage rules. No wasted words, but could be slightly more concise without losing clarity.
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?
For a simple 2-parameter tool with no output schema, description covers purpose, usage constraints, and behavior. Lacks explicit mention of return value, but the email notification implies no immediate data return.
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 covers all parameters with descriptions. Description adds critical usage context: email must be from this session, query is verbatim from user. This adds practical meaning beyond schema, earning above baseline.
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?
Description clearly identifies the action ('register interest') and the resource ('question the corpus can't answer yet'). It distinguishes from sibling tools, which are generic operations like call or compute, by specifying a notification-after-answer scenario.
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?
Explicitly states when to use ('ONLY when the user themselves asked to be told'), when not to use ('never volunteer an address from context or memory'), and limits ('one call per question'). Provides clear context and exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
searchSearch the corporaARead-onlyInspect
Search the mounted corpora by query. Routes to each domain's search tool; pass domain to target one. Empty results are logged as gaps. For COMPUTED quantities (molar mass, age/date math, unit conversions) this verb will miss and surface a cross-verb hint (e.g. compute_molar_mass) — follow that hint via describe/call rather than retrying search. Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, compost, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, flag-semaphore, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, beer-styles, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, sun-safety, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, voting-theory-social-choice, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, iarc-carcinogen-classification-registry, larmor-precession, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, hornbostel-sachs-instrument-classification, helmholtz-resonator-port-tuning, ethernet-cable-category-ratings, propeller-pitch-slip-thrust, pencil-lead-diameter-and-hardness-scale, hydraulic-jump-open-channel-flow, epa-air-quality-index-breakpoints, concrete-maturity-method, wet-bulb-globe-temperature-wbgt, chemical-compound-physical-properties, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, tippet-x-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, iata-icao-airline-designators, hl7v2-message-type-registry, clothing-pattern-drop-and-suit-size-system, bowling-ball-drilling-layout, tippet-x-diameter-calculator, curie-weiss-magnetic-susceptibility, penman-monteith-reference-evapotranspiration, camera-lens-filter-thread-and-step-ring-sizing, amateur-radio-contest-scoring, optimal-stopping-theory, cherenkov-radiation-angle, zeeman-effect-splitting, josephson-junction-relation, nfpa-704-fire-diamond, dea-controlled-substance-schedules, thermal-expansion, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, volcanic-explosivity-index, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, digit-lottery, cvss-scoring, dicom-tag-dictionary, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, gymnastics-code-of-points, archery-target-scoring, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, isbn-registration-group-ranges, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, climbing-grade-conversion-scales, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, ipcc-climate-findings, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, systemd, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, epidemiology-surveillance, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, food-recalls, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, national-register-historic-places-criteria, codex-alimentarius-food-standards, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, knowledge-organization, max-msp, ultrasound-imaging, modular-synthesis, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, sigma, music-thing-modular, cwejman, doepfer, befaco, 1010-music, joranalogue-audio-design, addac-system, instruo, ai-synthesis. If your user's topic isn't in that list, search it anyway rather than declining from the roster — an unrouted miss that grounds nowhere is the demand signal for what the corpus should cover next.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to search for. | |
| domain | No | Optional: restrict to one domain. |
Tool Definition Quality
A4.4/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond readOnlyHint=true annotation, the description discloses routing behavior, logging of empty results as gaps, the fact that computed-quantity queries will miss and surface a hint, and that unrouted misses are demand signals. This adds substantial behavioral context beyond the 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 first two sentences are front-loaded and clear, but the massive domain list makes the description very long. While informative, it goes beyond minimal necessary information and hurts conciseness, even though there is no redundancy.
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?
For a tool with many domains, routing, and special handling of computed quantities, the description covers key aspects: routing, gap logging, hint behavior, and fallback guidance. Missing explicit return-value details, but no output schema exists and the description still gives sufficient context for usage.
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?
Schema covers both parameters with descriptions (100% coverage), so baseline is 3. The description adds only that 'domain' targets one domain and that routing occurs, but does not provide deeper syntax, constraints, or examples beyond the schema.
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?
Description uses specific verb 'Search' and resource 'mounted corpora', clearly stating what the tool does. It also distinguishes from siblings by noting routing to domain-specific search tools and explicitly contrasting with compute/describe/call for computed quantities.
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?
Provides explicit when-to-use and when-not-to-use guidance: for computed quantities, search will miss and the agent should follow cross-verb hints via describe/call rather than retrying search. Also instructs to search any topic even if not in the roster, preventing premature declines.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
verifyVerify claims against sourcesARead-onlyInspect
Check claims against the corpora. SINGLE: verify({claim}) grounds one claim (core/verify truth-referee verdict where a domain surfaces it, else a corpus-grounding badge). RECEIPT: verify({claims:[…]}) claim-CHECKS each assertion and returns a TYPED per-claim verdict (verified / corrected / abstained) + drilled value + source, as a structured receipt (rides the response → portable to any client). Each claim is graded one of two ways: RECOGNITION-FREE — give op + params + asserted (STATE the computation you ran; it is RE-EXECUTED with no catalog match, so it grades NOVEL inputs too — the strongest form), or CATALOG-MATCH — give claim + asserted (matched to a covered record). Pass asserted (your own answer) to have it GRADED, not just grounded — the receipt corrects a confidently-wrong claim the model can't catch itself. A claim with no receipt line is unverified.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | No | Recognition-free single check: the computation you performed (e.g. 'compare_decimal'). Discover ops via the recall-traps check_claim verb (no args). | |
| claim | No | A single claim to check (back-compat / catalog-match). For several, use `claims`. | |
| claims | No | Receipt mode: the claims to check. Each item is {claim?, op?, params?, asserted?, domain?} (or a bare string). | |
| domain | No | Optional: restrict to one domain. | |
| params | No | Recognition-free single check: inputs for `op`. | |
| asserted | No | With a single `claim`/`op`: your answer, graded against the re-executed truth. |
Tool Definition Quality
A3.7/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true, and the description adds significant behavioral context: two modes of operation, the distinction between recognition-free and catalog-match grading, and the meaning of 'asserted'. No contradictions with annotations.
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 description is front-loaded with the purpose but is somewhat verbose and dense, mixing examples and technical details. It could be restructured for clarity without losing information.
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?
Given the complexity (6 params, nested objects, no output schema), the description covers parameter modes, return behavior (receipt vs badge), and grading logic, making it sufficiently complete for an agent to use effectively.
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%, baseline 3, but the description adds meaning beyond schema: explains how 'op' is discovered, how 'asserted' enables grading, and the relationship between parameters. This extra context justifies a 4.
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 clearly states the tool checks claims against corpora and describes two distinct modes (SINGLE and RECEIPT). However, it does not explicitly differentiate from sibling tools like 'search' or 'lookup', which could also involve fact-checking.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines3/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides internal guidance on when to use SINGLE vs RECEIPT mode and explains parameter combinations. However, it lacks explicit comparison to sibling tools or scenarios where this tool should not be used.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Servers
- AlicenseAqualityDmaintenanceAutomates high-credibility research with multi-source search and 10+ rounds of cross-verification.614MIT
- AlicenseAqualityBmaintenanceSearch 1,500+ pre-verified, cited knowledge units across 16 domains. 6 tools: query, batch query, get unit, list domains, suggest topics, report issues. Free, no API key required.62371MIT
- AlicenseAqualityBmaintenanceEnables querying a team of domain experts with automatic routing and traceable citations for accurate answers.338MIT