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.
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.
Tool Definition Quality
Average 4.6/5 across 7 of 7 tools scored.
Each tool has a clearly distinct purpose: call invokes domain verbs, compute aggregates, describe discovers structure, enumerates lists, lookup defines terms, search queries, and verify checks claims. The descriptions explicitly differentiate their use cases, leaving no ambiguity.
All tool names are single lowercase verbs (call, compute, describe, enumerate, lookup, search, verify), following a uniform and predictable pattern.
With 7 tools, the set is well-scoped for a knowledge server that provides multiple access patterns (lookup, search, aggregate, etc.) without being too heavy or too thin.
The tool surface covers all essential operations for interacting with a large corpus: definition lookup, free-text search, categorical enumeration, aggregation, discovery of available actions, invocation of those actions, and claim verification. No obvious gaps are present.
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.
| 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
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds behavioral context: every miss is a typed abstention logged as demand, and never a guess. However, the readOnlyHint annotation already indicates it's safe; the description does not contradict but adds only minor detail about logging, not covering potential side effects from invoked verbs.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise (two sentences) and front-loaded with the core purpose. It efficiently conveys the key constraints and behavior without fluff, though slightly dense.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a meta-tool that delegates to dynamic verbs, the description adequately covers the pattern, relationship with `describe`, miss behavior, and naming constraint. No output schema is needed as return depends on invoked verb. It is sufficiently complete given the tool's nature.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and the description adds value by explaining that `args` follows the schema from `describe()`. This connects the parameters to the broader discovery workflow, beyond what the schema's property descriptions provide.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool invokes a domain verb discovered via `describe`, explaining its role as a dynamic invocation mechanism. It distinguishes itself by emphasizing that it's identical to the namespaced tool surface and explicitly warns against inventing names.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear guidance: do not invent tool names, only use verbs from `describe`. It implicitly distinguishes from sibling `describe` (discovery vs. invocation). However, it lacks explicit when-to-use or when-not-to-use comparisons with other siblings like `lookup` or `search`.
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: calendar, building-codes, gearing, colorimetry, first-aid, tuning, wire-gauge, preferred-numbers, strength-training, unix-permissions, number-bases, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, glob, ieee754, http-status, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso-duration, dice-probability, scrabble-score, mach-number, chords, dtmf, base85, theoretical-ecology, checksums, bloom-filter, search-heuristics, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, structural-mechanics, regex, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, color-names, type-sizes, vin, drill-bit-sizing, iso-country-codes, itu-e164, mime-types, finite-automata, ac-circuits, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, iana-port-numbers, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, iso-language-codes, dns-record-types, midi-messages, kinematics, digital-logic, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, iso-6346, iso-7064, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, iana-uri-schemes, aquarium-chemistry, iso-thread, knitting-needle-sizes, bearing-sizes, horology, rocket-propulsion, rolling-element-bearing-life, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, lambda-calculus, combustion-stoichiometry, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, open-channel-hydraulics, gaussian-beam-optics, nato-phonetic, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, z-transform, generating-functions, terzaghi-bearing-capacity, icao-doc8643, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, probability-distributions, isentropic-flow, fatigue-life, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, dynamic-programming-recurrences, smtp-reply-codes, un-locode, chain-pitch, string-gauges, sewing-pattern-grading, aquaculture-stocking-density, polynomial-arithmetic, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, ieee-ethertypes, icao-mrz, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, iso-3166-2, context-free-grammars, dc-motor-equations, usb-class-codes, 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, un-ece-vegetable-fruit-grading-standards, iata-airport-delay-codes, un-transport-hazard-class-un-numbers, faa-nas-airspace-classes, 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, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, 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, aes-fips-block-parameters, voronoi-delaunay, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, e164-carrier-mnc-mcc, faa-nav-aid-frequency-bands, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, pbkdf2, hkdf, hvac-duct-sizing, board-game-elo-scoring, tide-and-moon-phase-almanac, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, iana-link-relations, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, un-sdg-indicator-framework, iso-20022-message-types, world-heritage-list-criteria, german-tax-id-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, itu-callsign-allocation, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, un-vienna-road-signs, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, 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-state-county-codes, usda-plants-taxonomic-registry, orifice-venturi-flow-meter, beer-style-specs, 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, un-m49-region-codes, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, skin-cancer-epidemiology, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, ashrae-refrigerant-designations, upu-s10-tracking-number, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, axe-throwing-scoring, voting-tally-methods, canine-caloric-requirements, maritime-mid-ship-station, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, itu-r-recommendation-v431-frequency-band-nomenclature, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, helmholtz-resonator-port-tuning, 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, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, baume-specific-gravity-converter, kalman-filter-and-state-estimation, coriolis-effect-deflection, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, thermal-expansion, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, cvss-scoring, dicom-tag-dictionary, fips-140-security-levels, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema-wiring-device-configurations, rfc5322-email-address-grammar, 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, iana-root-zone-tld-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, nema-mg1-motor-frame-sizes, larson-miller-creep-rupture-parameter, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, icao-notam-q-code-contractions, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, 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, transponder-squawk-codes, icd-10-pcs-code-decoder, nema-250-enclosure-type-ratings, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, icao-wake-turbulence-category-assignment, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, un-dangerous-goods-placard-design-orange-book, 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, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, iso-15924-scripts, welding-rod-electrode-classification-aws, 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, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, 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, sound-transmission-mass-law, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, wine-appellation-classification-systems, un-spsc-product-classification, rubber-plastic-shore-durometer-hardness, 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, loinc-observation-codes, fpv-drone-motor-prop-math, aci-318-reinforced-concrete-flexural-capacity, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, pickleball-equipment-specs, 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, 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, math, eurorack, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, subnetting, textile-gauge, statistics, chess-endgames, woodworking, rating-systems, check-digits, paper-sizes, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, hardiness-zones, terraria, aspect-ratio, resistor-color-code, incoterms, soundex, zigbee, wind-chill, saffir-simpson, dataviz, patents, shoe-size, crc, base58, bech32, reed-solomon, string-similarity, compression, prng, computus, hyperloglog, peppers, tomatoes, fluid-mechanics, information-theory, combinatorics, graph-algorithms, linear-algebra, algorithm-complexity, coding-theory, fourier-analysis, numerical-methods, heat-transfer, markov-chains, orbital-mechanics, html-named-character-references, thermodynamics, geometric-optics, convex-optimization, nuclear-decay, fresnel-equations, myrcene, itu-q-code, 3d-printing, arrow-spine, camera-film-formats, mechanical-vibrations, fiber-optics, beaufort-scale, iana-protocol-numbers, boolean-algebra, game-theory, bolts-screws, standard-atmosphere, capillary-action, tcr-therapy, software-licenses, gauge-systems-industrial, ring-sizes, three-phase-power, http-headers, group-theory, molecular-diffusion, tabletop-wargaming-probability, matrix-decompositions, count-min-sketch, punycode, photovoltaic-cell-model, faa-n-number, orcid-checksum, swift-bic-format, projectile-ballistics-drag-corrected, faa-airport-codes, iso15459-license-plate, typography, tides, ndc, epsg, hts, elevator-rope-crane-wire-rope-classification, ecfr, regular-expression-derivatives, scientific-method, mtg-rules, cas-registry-checksum, international-code-of-signals, garden-perennials, usb-device-descriptor, compost, flag-semaphore, shipping-container-iso-6346-sizing, beer-styles, ceramics-glaze-chemistry, compost-cn-ratio, archimedes-buoyancy-and-flotation, iso-7010-safety-signs, sun-safety, market-identifier-codes, horseshoe-pitching-scoring, voting-theory-social-choice, merchant-category-codes, isrc, iso-3166-3, isil, cfi, perfume-concentration-and-dilution, cheesemaking-recipe-math, wcag-success-criteria, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, iarc-carcinogen-classification-registry, hornbostel-sachs-instrument-classification, ethernet-cable-category-ratings, chemical-compound-physical-properties, tippet-x-rating, weir-flow-discharge, who-atc-drug-classification, schwarzschild-radius, iata-icao-airline-designators, hl7v2-message-type-registry, nfpa-704-fire-diamond, dea-controlled-substance-schedules, icao-wake-turbulence-category, usda-beef-quality-grades, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, volcanic-explosivity-index, digit-lottery, rayleigh-scattering-intensity, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, gymnastics-code-of-points, archery-target-scoring, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, cwe-weakness-taxonomy, cites-appendices, climbing-grade-conversion-scales, fire-sprinkler-k-factor-sizing, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, cdc-acip-immunization-schedule, un-human-rights-instruments, ipcc-climate-findings, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, sec-edgar-filing-rules, systemd, esrb-pegi-content-rating-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, epidemiology-surveillance, usda-egg-poultry-inspection-grade-marks, un-dangerous-goods-packing-instructions, scientometrics, kayak-canoe-hull-speed, radar-range-equation, food-recalls, supreme-court-holdings, wmo-present-weather-code, who-pheic-declarations, us-place-gazetteer, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda-major-food-allergen-labeling, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, who-preeclampsia-diagnostic-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, faa-part107-small-uas-operating-limits, salometer-brine-salinity, fda-food-code, national-register-historic-places-criteria, codex-alimentarius-food-standards, fda-orange-book-therapeutic-equivalence, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory.
| 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
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, but description adds deterministic behavior, completeness contract, abstention on incomplete sets, refusal to crown rankings, and inheritance from 'enumerate' – far exceeding what annotations provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with core purpose and examples, but includes an extensive list of mounted corpora which, while useful, adds length. Overall every sentence earns its place, but could be slightly trimmed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Even without an output schema, the description clarifies return format (plain count vs grouped count), covers edge cases (incomplete set, ranking refusal), and lists supported corpora. Comprehensive enough for safe invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and description adds meaning: 'by' returns count per value sorted with largest, 'filter' scopes with example, 'domain' is required. Also advises to discover fields via 'enumerate'.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states 'a deterministic AGGREGATE over ONE corpus's COMPLETE set' and provides examples like 'how many X', 'break X down by Y', 'which is most common', clearly distinguishing it from siblings like 'enumerate' which is for records/categories.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives explicit when-to-use (aggregate queries), when-not-to-use (ranking 'best' or 'worth'), and alternatives ('for the records/categories themselves use enumerate'). It also explains behavior over incomplete sets (abstains) and refuses rankings.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| domain | No | Optional: one domain's full tool schemas (e.g. 'cocktail'). |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=true, and the description aligns by using verbs like 'discover' and 'list'. No contradiction. The description adds behavioral context about returning grouped verb lists and the ability to invoke listed tools via 'call'. This goes beyond the annotation's simple read-only flag.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise (three sentences) yet packed with all necessary information: purpose, behavior for both input cases, usage guidance, and connection to sibling tool 'call'. No wasted words; front-loaded with the main action.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (tool introspection), single optional parameter, no output schema, and presence of annotations, the description covers all necessary aspects: both invocation modes, when to use, and how it relates to other tools. No gaps identified.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single optional parameter 'domain' with a basic description. The description adds significant meaning: explaining the two modes (no arg vs. domain) and what each returns. This clarifies the parameter's semantics beyond the schema alone. Baseline 3, plus 1 for added value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: discovering domains and their tools. It specifies behavior for no arguments (list all domains grouped by rung) and with a domain (full tool list with schemas). It distinguishes itself from siblings by referencing deeper discovery beyond lookup/search/verify.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit usage guidance is given: 'Use this whenever the spine (lookup/search/verify) is too shallow for the question.' Concrete examples follow: 'what can I make/patch/cover with MY inventory', contested claims, open questions. This clearly tells the agent when to invoke this tool over alternatives.
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: calendar, building-codes, gearing, colorimetry, first-aid, tuning, wire-gauge, preferred-numbers, strength-training, unix-permissions, number-bases, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, glob, ieee754, http-status, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso-duration, dice-probability, scrabble-score, mach-number, chords, dtmf, base85, theoretical-ecology, checksums, bloom-filter, search-heuristics, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, structural-mechanics, regex, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, color-names, type-sizes, vin, drill-bit-sizing, iso-country-codes, itu-e164, mime-types, finite-automata, ac-circuits, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, iana-port-numbers, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, iso-language-codes, dns-record-types, midi-messages, kinematics, digital-logic, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, iso-6346, iso-7064, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, iana-uri-schemes, aquarium-chemistry, iso-thread, knitting-needle-sizes, bearing-sizes, horology, rocket-propulsion, rolling-element-bearing-life, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, lambda-calculus, combustion-stoichiometry, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, open-channel-hydraulics, gaussian-beam-optics, nato-phonetic, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, z-transform, generating-functions, terzaghi-bearing-capacity, icao-doc8643, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, probability-distributions, isentropic-flow, fatigue-life, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, dynamic-programming-recurrences, smtp-reply-codes, un-locode, chain-pitch, string-gauges, sewing-pattern-grading, aquaculture-stocking-density, polynomial-arithmetic, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, ieee-ethertypes, icao-mrz, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, iso-3166-2, context-free-grammars, dc-motor-equations, usb-class-codes, 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, un-ece-vegetable-fruit-grading-standards, iata-airport-delay-codes, un-transport-hazard-class-un-numbers, faa-nas-airspace-classes, 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, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, 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, aes-fips-block-parameters, voronoi-delaunay, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, e164-carrier-mnc-mcc, faa-nav-aid-frequency-bands, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, pbkdf2, hkdf, hvac-duct-sizing, board-game-elo-scoring, tide-and-moon-phase-almanac, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, iana-link-relations, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, un-sdg-indicator-framework, iso-20022-message-types, world-heritage-list-criteria, german-tax-id-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, itu-callsign-allocation, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, un-vienna-road-signs, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, 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-state-county-codes, usda-plants-taxonomic-registry, orifice-venturi-flow-meter, beer-style-specs, 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, un-m49-region-codes, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, skin-cancer-epidemiology, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, ashrae-refrigerant-designations, upu-s10-tracking-number, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, axe-throwing-scoring, voting-tally-methods, canine-caloric-requirements, maritime-mid-ship-station, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, itu-r-recommendation-v431-frequency-band-nomenclature, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, helmholtz-resonator-port-tuning, 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, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, baume-specific-gravity-converter, kalman-filter-and-state-estimation, coriolis-effect-deflection, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, thermal-expansion, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, cvss-scoring, dicom-tag-dictionary, fips-140-security-levels, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema-wiring-device-configurations, rfc5322-email-address-grammar, 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, iana-root-zone-tld-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, nema-mg1-motor-frame-sizes, larson-miller-creep-rupture-parameter, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, icao-notam-q-code-contractions, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, 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, transponder-squawk-codes, icd-10-pcs-code-decoder, nema-250-enclosure-type-ratings, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, icao-wake-turbulence-category-assignment, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, un-dangerous-goods-placard-design-orange-book, 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, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, iso-15924-scripts, welding-rod-electrode-classification-aws, 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, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, 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, sound-transmission-mass-law, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, wine-appellation-classification-systems, un-spsc-product-classification, rubber-plastic-shore-durometer-hardness, 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, loinc-observation-codes, fpv-drone-motor-prop-math, aci-318-reinforced-concrete-flexural-capacity, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, pickleball-equipment-specs, 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, 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, math, eurorack, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, subnetting, textile-gauge, statistics, chess-endgames, woodworking, rating-systems, check-digits, paper-sizes, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, hardiness-zones, terraria, aspect-ratio, resistor-color-code, incoterms, soundex, zigbee, wind-chill, saffir-simpson, dataviz, patents, shoe-size, crc, base58, bech32, reed-solomon, string-similarity, compression, prng, computus, hyperloglog, peppers, tomatoes, fluid-mechanics, information-theory, combinatorics, graph-algorithms, linear-algebra, algorithm-complexity, coding-theory, fourier-analysis, numerical-methods, heat-transfer, markov-chains, orbital-mechanics, html-named-character-references, thermodynamics, geometric-optics, convex-optimization, nuclear-decay, fresnel-equations, myrcene, itu-q-code, 3d-printing, arrow-spine, camera-film-formats, mechanical-vibrations, fiber-optics, beaufort-scale, iana-protocol-numbers, boolean-algebra, game-theory, bolts-screws, standard-atmosphere, capillary-action, tcr-therapy, software-licenses, gauge-systems-industrial, ring-sizes, three-phase-power, http-headers, group-theory, molecular-diffusion, tabletop-wargaming-probability, matrix-decompositions, count-min-sketch, punycode, photovoltaic-cell-model, faa-n-number, orcid-checksum, swift-bic-format, projectile-ballistics-drag-corrected, faa-airport-codes, iso15459-license-plate, typography, tides, ndc, epsg, hts, elevator-rope-crane-wire-rope-classification, ecfr, regular-expression-derivatives, scientific-method, mtg-rules, cas-registry-checksum, international-code-of-signals, garden-perennials, usb-device-descriptor, compost, flag-semaphore, shipping-container-iso-6346-sizing, beer-styles, ceramics-glaze-chemistry, compost-cn-ratio, archimedes-buoyancy-and-flotation, iso-7010-safety-signs, sun-safety, market-identifier-codes, horseshoe-pitching-scoring, voting-theory-social-choice, merchant-category-codes, isrc, iso-3166-3, isil, cfi, perfume-concentration-and-dilution, cheesemaking-recipe-math, wcag-success-criteria, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, iarc-carcinogen-classification-registry, hornbostel-sachs-instrument-classification, ethernet-cable-category-ratings, chemical-compound-physical-properties, tippet-x-rating, weir-flow-discharge, who-atc-drug-classification, schwarzschild-radius, iata-icao-airline-designators, hl7v2-message-type-registry, nfpa-704-fire-diamond, dea-controlled-substance-schedules, icao-wake-turbulence-category, usda-beef-quality-grades, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, volcanic-explosivity-index, digit-lottery, rayleigh-scattering-intensity, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, gymnastics-code-of-points, archery-target-scoring, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, cwe-weakness-taxonomy, cites-appendices, climbing-grade-conversion-scales, fire-sprinkler-k-factor-sizing, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, cdc-acip-immunization-schedule, un-human-rights-instruments, ipcc-climate-findings, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, sec-edgar-filing-rules, systemd, esrb-pegi-content-rating-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, epidemiology-surveillance, usda-egg-poultry-inspection-grade-marks, un-dangerous-goods-packing-instructions, scientometrics, kayak-canoe-hull-speed, radar-range-equation, food-recalls, supreme-court-holdings, wmo-present-weather-code, who-pheic-declarations, us-place-gazetteer, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda-major-food-allergen-labeling, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, who-preeclampsia-diagnostic-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, faa-part107-small-uas-operating-limits, salometer-brine-salinity, fda-food-code, national-register-historic-places-criteria, codex-alimentarius-food-standards, fda-orange-book-therapeutic-equivalence, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory.
| 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
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true. Description adds behavioral details like the completeness contract (incomplete return flagged, never silent undercount) and special directory domain, which provides value beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely long due to a massive list of domain names, which is not concise. While front-loaded with purpose, the excessive list detracts from readability and earns a low score.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (enumerating domains, completeness contract, filter usage, special directory), the description is thorough and covers all critical aspects including return behavior and differences from sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers 100% of parameters. Description adds concrete examples (e.g., 'cocktail' for domain, '{"family":"sour"}' for filter) and explains the special 'directory' domain, enriching parameter understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'List broad CATEGORIES or the COMPLETE set within ONE corpus' and distinguishes from siblings like search and lookup with specific use cases.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states when to use (e.g., 'what kinds are there', 'all the X') and when not to use (use lookup/search for one record), and mentions describe for discovering facets.
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: calendar, building-codes, gearing, colorimetry, first-aid, tuning, wire-gauge, preferred-numbers, strength-training, unix-permissions, number-bases, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, glob, ieee754, http-status, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso-duration, dice-probability, scrabble-score, mach-number, chords, dtmf, base85, theoretical-ecology, checksums, bloom-filter, search-heuristics, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, structural-mechanics, regex, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, color-names, type-sizes, vin, drill-bit-sizing, iso-country-codes, itu-e164, mime-types, finite-automata, ac-circuits, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, iana-port-numbers, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, iso-language-codes, dns-record-types, midi-messages, kinematics, digital-logic, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, iso-6346, iso-7064, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, iana-uri-schemes, aquarium-chemistry, iso-thread, knitting-needle-sizes, bearing-sizes, horology, rocket-propulsion, rolling-element-bearing-life, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, lambda-calculus, combustion-stoichiometry, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, open-channel-hydraulics, gaussian-beam-optics, nato-phonetic, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, z-transform, generating-functions, terzaghi-bearing-capacity, icao-doc8643, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, probability-distributions, isentropic-flow, fatigue-life, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, dynamic-programming-recurrences, smtp-reply-codes, un-locode, chain-pitch, string-gauges, sewing-pattern-grading, aquaculture-stocking-density, polynomial-arithmetic, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, ieee-ethertypes, icao-mrz, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, iso-3166-2, context-free-grammars, dc-motor-equations, usb-class-codes, 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, un-ece-vegetable-fruit-grading-standards, iata-airport-delay-codes, un-transport-hazard-class-un-numbers, faa-nas-airspace-classes, 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, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, 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, aes-fips-block-parameters, voronoi-delaunay, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, e164-carrier-mnc-mcc, faa-nav-aid-frequency-bands, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, pbkdf2, hkdf, hvac-duct-sizing, board-game-elo-scoring, tide-and-moon-phase-almanac, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, iana-link-relations, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, un-sdg-indicator-framework, iso-20022-message-types, world-heritage-list-criteria, german-tax-id-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, itu-callsign-allocation, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, un-vienna-road-signs, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, 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-state-county-codes, usda-plants-taxonomic-registry, orifice-venturi-flow-meter, beer-style-specs, 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, un-m49-region-codes, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, skin-cancer-epidemiology, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, ashrae-refrigerant-designations, upu-s10-tracking-number, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, axe-throwing-scoring, voting-tally-methods, canine-caloric-requirements, maritime-mid-ship-station, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, itu-r-recommendation-v431-frequency-band-nomenclature, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, helmholtz-resonator-port-tuning, 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, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, baume-specific-gravity-converter, kalman-filter-and-state-estimation, coriolis-effect-deflection, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, thermal-expansion, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, cvss-scoring, dicom-tag-dictionary, fips-140-security-levels, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema-wiring-device-configurations, rfc5322-email-address-grammar, 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, iana-root-zone-tld-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, nema-mg1-motor-frame-sizes, larson-miller-creep-rupture-parameter, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, icao-notam-q-code-contractions, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, 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, transponder-squawk-codes, icd-10-pcs-code-decoder, nema-250-enclosure-type-ratings, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, icao-wake-turbulence-category-assignment, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, un-dangerous-goods-placard-design-orange-book, 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, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, iso-15924-scripts, welding-rod-electrode-classification-aws, 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, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, 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, sound-transmission-mass-law, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, wine-appellation-classification-systems, un-spsc-product-classification, rubber-plastic-shore-durometer-hardness, 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, loinc-observation-codes, fpv-drone-motor-prop-math, aci-318-reinforced-concrete-flexural-capacity, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, pickleball-equipment-specs, 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, 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, math, eurorack, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, subnetting, textile-gauge, statistics, chess-endgames, woodworking, rating-systems, check-digits, paper-sizes, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, hardiness-zones, terraria, aspect-ratio, resistor-color-code, incoterms, soundex, zigbee, wind-chill, saffir-simpson, dataviz, patents, shoe-size, crc, base58, bech32, reed-solomon, string-similarity, compression, prng, computus, hyperloglog, peppers, tomatoes, fluid-mechanics, information-theory, combinatorics, graph-algorithms, linear-algebra, algorithm-complexity, coding-theory, fourier-analysis, numerical-methods, heat-transfer, markov-chains, orbital-mechanics, html-named-character-references, thermodynamics, geometric-optics, convex-optimization, nuclear-decay, fresnel-equations, myrcene, itu-q-code, 3d-printing, arrow-spine, camera-film-formats, mechanical-vibrations, fiber-optics, beaufort-scale, iana-protocol-numbers, boolean-algebra, game-theory, bolts-screws, standard-atmosphere, capillary-action, tcr-therapy, software-licenses, gauge-systems-industrial, ring-sizes, three-phase-power, http-headers, group-theory, molecular-diffusion, tabletop-wargaming-probability, matrix-decompositions, count-min-sketch, punycode, photovoltaic-cell-model, faa-n-number, orcid-checksum, swift-bic-format, projectile-ballistics-drag-corrected, faa-airport-codes, iso15459-license-plate, typography, tides, ndc, epsg, hts, elevator-rope-crane-wire-rope-classification, ecfr, regular-expression-derivatives, scientific-method, mtg-rules, cas-registry-checksum, international-code-of-signals, garden-perennials, usb-device-descriptor, compost, flag-semaphore, shipping-container-iso-6346-sizing, beer-styles, ceramics-glaze-chemistry, compost-cn-ratio, archimedes-buoyancy-and-flotation, iso-7010-safety-signs, sun-safety, market-identifier-codes, horseshoe-pitching-scoring, voting-theory-social-choice, merchant-category-codes, isrc, iso-3166-3, isil, cfi, perfume-concentration-and-dilution, cheesemaking-recipe-math, wcag-success-criteria, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, iarc-carcinogen-classification-registry, hornbostel-sachs-instrument-classification, ethernet-cable-category-ratings, chemical-compound-physical-properties, tippet-x-rating, weir-flow-discharge, who-atc-drug-classification, schwarzschild-radius, iata-icao-airline-designators, hl7v2-message-type-registry, nfpa-704-fire-diamond, dea-controlled-substance-schedules, icao-wake-turbulence-category, usda-beef-quality-grades, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, volcanic-explosivity-index, digit-lottery, rayleigh-scattering-intensity, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, gymnastics-code-of-points, archery-target-scoring, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, cwe-weakness-taxonomy, cites-appendices, climbing-grade-conversion-scales, fire-sprinkler-k-factor-sizing, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, cdc-acip-immunization-schedule, un-human-rights-instruments, ipcc-climate-findings, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, sec-edgar-filing-rules, systemd, esrb-pegi-content-rating-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, epidemiology-surveillance, usda-egg-poultry-inspection-grade-marks, un-dangerous-goods-packing-instructions, scientometrics, kayak-canoe-hull-speed, radar-range-equation, food-recalls, supreme-court-holdings, wmo-present-weather-code, who-pheic-declarations, us-place-gazetteer, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda-major-food-allergen-labeling, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, who-preeclampsia-diagnostic-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, faa-part107-small-uas-operating-limits, salometer-brine-salinity, fda-food-code, national-register-historic-places-criteria, codex-alimentarius-food-standards, fda-orange-book-therapeutic-equivalence, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory. 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.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The concept/entity to resolve. | |
| domain | No | Optional: restrict to one domain (e.g. 'acupuncture'). |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses key behaviors beyond readOnlyHint: abstains on miss (no creation), miss logged as demand signal, and for computed quantities the miss points to compute verb. No contradiction with readOnlyHint.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose due to the extensive list of mounted corpora, but the core info is front-loaded. Could be more concise without losing value, but structure is logical.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Covers purpose, usage, behavior, and routing well, but lacks description of return format or output structure, which is needed since no output schema is provided.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%; description adds clarity with examples (e.g., 'acupuncture') and explains routing logic for domain parameter. Minimal redundancy.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool defines concepts/terms from a domain glossary, distinguishes from sibling tools like search for entities/records and compute for computed quantities, and explains routing behavior with domain parameter.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says when to use (glossary definitions), when not (entities/records use search, computed quantities use compute after a miss), and describes behavior on miss (logged as gap with no report_gap verb).
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.
| 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
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description carries the full burden. It discloses that the tool sends exactly one email per question and implies it creates a record. Could be improved by specifying what happens on duplicate calls or authorization needs, but sufficiently covers the main behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured and front-loaded with purpose, then usage guidelines. Each sentence adds value, though slightly longer than necessary. No redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simple tool (2 params, no output schema, no annotations), the description covers all essential aspects: purpose, when to use, parameter semantics. It is self-contained and leaves little ambiguity for an AI agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with basic descriptions, but the description adds critical context: email must be given this session, query is the exact user question. This goes beyond the schema to guide parameter usage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: registering a user's interest in an unanswered question to receive an email when it becomes answerable. It distinguishes itself from sibling tools by focusing on notification for missing answers.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides explicit conditions: call only when the user asks to be told, ask for email in this session, never use stored addresses, one call per question. This clearly guides when and how to use the tool.
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: calendar, building-codes, gearing, colorimetry, first-aid, tuning, wire-gauge, preferred-numbers, strength-training, unix-permissions, number-bases, cognitive-psychology, braille, semver, cron, unicode, timezones, metar, glob, ieee754, http-status, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso-duration, dice-probability, scrabble-score, mach-number, chords, dtmf, base85, theoretical-ecology, checksums, bloom-filter, search-heuristics, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, structural-mechanics, regex, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, color-names, type-sizes, vin, drill-bit-sizing, iso-country-codes, itu-e164, mime-types, finite-automata, ac-circuits, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, iana-port-numbers, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, iso-language-codes, dns-record-types, midi-messages, kinematics, digital-logic, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, iso-6346, iso-7064, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, iana-uri-schemes, aquarium-chemistry, iso-thread, knitting-needle-sizes, bearing-sizes, horology, rocket-propulsion, rolling-element-bearing-life, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, lambda-calculus, combustion-stoichiometry, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, open-channel-hydraulics, gaussian-beam-optics, nato-phonetic, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, z-transform, generating-functions, terzaghi-bearing-capacity, icao-doc8643, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, probability-distributions, isentropic-flow, fatigue-life, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, dynamic-programming-recurrences, smtp-reply-codes, un-locode, chain-pitch, string-gauges, sewing-pattern-grading, aquaculture-stocking-density, polynomial-arithmetic, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, ieee-ethertypes, icao-mrz, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, iso-3166-2, context-free-grammars, dc-motor-equations, usb-class-codes, 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, un-ece-vegetable-fruit-grading-standards, iata-airport-delay-codes, un-transport-hazard-class-un-numbers, faa-nas-airspace-classes, 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, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, 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, aes-fips-block-parameters, voronoi-delaunay, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, e164-carrier-mnc-mcc, faa-nav-aid-frequency-bands, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, pbkdf2, hkdf, hvac-duct-sizing, board-game-elo-scoring, tide-and-moon-phase-almanac, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, iana-link-relations, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, un-sdg-indicator-framework, iso-20022-message-types, world-heritage-list-criteria, german-tax-id-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, itu-callsign-allocation, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, knots, leathercraft-stitch-and-skiving, data-structure-complexity, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, un-vienna-road-signs, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, 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-state-county-codes, usda-plants-taxonomic-registry, orifice-venturi-flow-meter, beer-style-specs, 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, un-m49-region-codes, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, skin-cancer-epidemiology, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, ashrae-refrigerant-designations, upu-s10-tracking-number, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, axe-throwing-scoring, voting-tally-methods, canine-caloric-requirements, maritime-mid-ship-station, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, itu-r-recommendation-v431-frequency-band-nomenclature, voltage-drop-conductor-sizing, grounding-electrode-resistance, chimney-stack-effect-draft, concrete-water-cement-ratio-strength, helmholtz-resonator-port-tuning, 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, capstan-belt-friction-equation, iala-maritime-buoyage, iau-constellation-codes, egg-size-grading, respirator-filter-class-rating, resin-identification-codes, nfpa-fire-extinguisher-classification, iucn-red-list-categories, enhanced-fujita-scale, proquint-encoding, electrical-conduit-trade-size, fishing-hook-size, baume-specific-gravity-converter, kalman-filter-and-state-estimation, coriolis-effect-deflection, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, thermal-expansion, malus-law-polarization, hazen-williams-pipe-flow, extended-surface-fin-heat-transfer, fillet-weld-strength, isan-check-character, iswc-check-digit, rifle-scope-moa-mrad-conversion, cvss-scoring, dicom-tag-dictionary, fips-140-security-levels, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema-wiring-device-configurations, rfc5322-email-address-grammar, 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, iana-root-zone-tld-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, nema-mg1-motor-frame-sizes, larson-miller-creep-rupture-parameter, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, icao-notam-q-code-contractions, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, 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, transponder-squawk-codes, icd-10-pcs-code-decoder, nema-250-enclosure-type-ratings, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, icao-wake-turbulence-category-assignment, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, un-dangerous-goods-placard-design-orange-book, 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, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, iso-15924-scripts, welding-rod-electrode-classification-aws, 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, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, 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, sound-transmission-mass-law, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, wine-appellation-classification-systems, un-spsc-product-classification, rubber-plastic-shore-durometer-hardness, 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, loinc-observation-codes, fpv-drone-motor-prop-math, aci-318-reinforced-concrete-flexural-capacity, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, pickleball-equipment-specs, 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, 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, math, eurorack, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, subnetting, textile-gauge, statistics, chess-endgames, woodworking, rating-systems, check-digits, paper-sizes, swe-claim-denial, psychology, roman-numerals, minecraft-mods, encodings, hardiness-zones, terraria, aspect-ratio, resistor-color-code, incoterms, soundex, zigbee, wind-chill, saffir-simpson, dataviz, patents, shoe-size, crc, base58, bech32, reed-solomon, string-similarity, compression, prng, computus, hyperloglog, peppers, tomatoes, fluid-mechanics, information-theory, combinatorics, graph-algorithms, linear-algebra, algorithm-complexity, coding-theory, fourier-analysis, numerical-methods, heat-transfer, markov-chains, orbital-mechanics, html-named-character-references, thermodynamics, geometric-optics, convex-optimization, nuclear-decay, fresnel-equations, myrcene, itu-q-code, 3d-printing, arrow-spine, camera-film-formats, mechanical-vibrations, fiber-optics, beaufort-scale, iana-protocol-numbers, boolean-algebra, game-theory, bolts-screws, standard-atmosphere, capillary-action, tcr-therapy, software-licenses, gauge-systems-industrial, ring-sizes, three-phase-power, http-headers, group-theory, molecular-diffusion, tabletop-wargaming-probability, matrix-decompositions, count-min-sketch, punycode, photovoltaic-cell-model, faa-n-number, orcid-checksum, swift-bic-format, projectile-ballistics-drag-corrected, faa-airport-codes, iso15459-license-plate, typography, tides, ndc, epsg, hts, elevator-rope-crane-wire-rope-classification, ecfr, regular-expression-derivatives, scientific-method, mtg-rules, cas-registry-checksum, international-code-of-signals, garden-perennials, usb-device-descriptor, compost, flag-semaphore, shipping-container-iso-6346-sizing, beer-styles, ceramics-glaze-chemistry, compost-cn-ratio, archimedes-buoyancy-and-flotation, iso-7010-safety-signs, sun-safety, market-identifier-codes, horseshoe-pitching-scoring, voting-theory-social-choice, merchant-category-codes, isrc, iso-3166-3, isil, cfi, perfume-concentration-and-dilution, cheesemaking-recipe-math, wcag-success-criteria, iec-60529-ip-rating-codes, pencil-graphite-hardness-grading, iarc-carcinogen-classification-registry, hornbostel-sachs-instrument-classification, ethernet-cable-category-ratings, chemical-compound-physical-properties, tippet-x-rating, weir-flow-discharge, who-atc-drug-classification, schwarzschild-radius, iata-icao-airline-designators, hl7v2-message-type-registry, nfpa-704-fire-diamond, dea-controlled-substance-schedules, icao-wake-turbulence-category, usda-beef-quality-grades, koppen-climate-classification, modified-mercalli-intensity, ansi-a13-1-pipe-marking, volcanic-explosivity-index, digit-lottery, rayleigh-scattering-intensity, grounded-retrieval, asme-y14-5-gdt-symbols, automotive-blade-fuse-sizing, figure-skating-scoring, ioc-noc-codes, icd-10-pcs, aiga-dot-symbol-signs, universal-dependencies-relations, lsh-minhash, string-matching-algorithms, gymnastics-code-of-points, archery-target-scoring, wind-load-structures, seawater-sound-speed, messier-catalog, grpc-status-codes, cwe-weakness-taxonomy, cites-appendices, climbing-grade-conversion-scales, fire-sprinkler-k-factor-sizing, colregs-navigation-rules, osha-permissible-exposure-limits, ada-2010-accessible-design-standards, cdc-acip-immunization-schedule, un-human-rights-instruments, ipcc-climate-findings, rfc2119-bcp14-requirement-keywords, montreal-protocol-controlled-substance-annexes, hl7-fhir-r4-resource-type-registry, roller-chain-sizing, sec-edgar-filing-rules, systemd, esrb-pegi-content-rating-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, epidemiology-surveillance, usda-egg-poultry-inspection-grade-marks, un-dangerous-goods-packing-instructions, scientometrics, kayak-canoe-hull-speed, radar-range-equation, food-recalls, supreme-court-holdings, wmo-present-weather-code, who-pheic-declarations, us-place-gazetteer, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, uspstf-screening-grades, ada-diabetes-diagnostic-criteria, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda-major-food-allergen-labeling, fatf-aml-cft-recommendations, ramsar-wetland-designation-criteria, who-preeclampsia-diagnostic-criteria, bluetooth-company-identifiers, spirits-standards-of-identity, eeoc-charge-filing-deadlines, faa-part107-small-uas-operating-limits, salometer-brine-salinity, fda-food-code, national-register-historic-places-criteria, codex-alimentarius-food-standards, fda-orange-book-therapeutic-equivalence, nist-cybersecurity-framework, geneva-conventions-ihl-articles, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory. 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.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to search for. | |
| domain | No | Optional: restrict to one domain. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint, and the description adds behavioral details: empty results logged as gaps, cross-verb hints for computed quantities, and an explanation that unrouted misses drive corpus coverage. No contradiction 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with purpose and guidelines, but includes a very long list of corpora. While the list is useful for context, it harms conciseness. Each sentence earns its place, but the length reduces clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of the tool (many domains, routing behavior, hinting, output handling), the description covers all scenarios: normal search, computed quantities, empty results, and guidance for unknown topics. No output schema, but the behavior is fully described.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with descriptions, but the description adds value by explaining that the 'domain' parameter targets a specific domain's search tool and that results may be logged as gaps. Baseline 3 with extra context justifies 4.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches mounted corpora by query, routes to domain-specific search tools, and distinguishes from sibling tools like compute by noting that for computed quantities it will miss and prompt use of a compute tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly tells when to use (search by query) and when not to (for computed quantities, use compute tools instead), and advises searching even if the topic isn't in the listed roster to signal corpus gaps.
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.
| 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
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses that claims are re-executed and graded, and explains the return format (structured receipt). Annotations confirm read-only behavior. No contradictions. It adds context beyond annotations, though could mention more about error handling.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose and densely technical, using jargon like 'recognition-free' and 'catalog-match' without immediate clarity. While it is well-structured with labeled sections, it could be more concise to improve readability for an AI agent.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complex input schema with nested objects and multiple modes, the description thoroughly covers usage patterns, parameter relationships, and output behavior. It explains what happens when no receipt line is present, ensuring the agent understands the tool's full capability.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, providing baseline. The description adds significant meaning: it explains the difference between single and receipt mode, the role of 'asserted' for grading vs grounding, and clarifies that 'op' and 'params' are for recognition-free checks. This exceeds minimal expectations.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states the tool's purpose: 'Check claims against the corpora' and distinguishes between two modes (SINGLE and RECEIPT) with clear outputs. It differentiates from sibling tools by focusing on verification with typed verdicts.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear guidance on when to use single vs receipt mode and explains the two grading methods (recognition-free vs catalog-match). It hints at discovering available ops via another verb, but does not explicitly state when not to use this tool or compare to alternatives.
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!