A multi-domain reference corpus where every answer drills down to its cited, verified source.
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'). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds behavioral context beyond the readOnlyHint annotation: it explains that a miss results in a typed abstention and logging, and reassures that the tool never guesses. This is valuable transparency for agent decision-making.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise (two sentences) and front-loaded: the first sentence defines purpose and format, the second provides critical behavioral rules. No unnecessary words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's generic nature (3 parameters, no output schema), the description covers the essential connection to describe and the abstention logging. It is sufficiently complete for an agent to use correctly, though it could mention return behavior (though output schema is absent).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents all parameters. The description adds minimal extra meaning (e.g., clarifying that args come from describe's inputSchema), which is helpful but not substantial. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states that the tool invokes a domain verb discovered via describe, with a specific format call(domain, tool, args). It distinguishes from sibling tools by emphasizing that it is identical to the namespaced tool surface and that agents must not invent verb names.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit guidance on when to use the tool (after describe), and what to avoid (inventing tool names). It also explains the behavior on a miss (logged abstention, never a guess). However, it does not explicitly discuss when not to use it or list alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
A deterministic AGGREGATE over ONE corpus's COMPLETE set — the calculated-query shape ("how many X", "break X down by Y", "which is most common"). Requires domain; optional filter scopes the set (e.g. {"spirit":"gin"}); optional by (a record field) returns the count PER value, sorted, with the largest. Built ON enumerate, so it inherits the completeness contract: over an INCOMPLETE set it ABSTAINS rather than undercount. It counts on GROUND and refuses to crown a "best"/worth ranking (that has no oracle — the user's call). For the records/categories themselves use enumerate. Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, 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, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, koppen-climate-classification, modified-mercalli-intensity, 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, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, hl7-fhir-r4-resource-type-registry, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, ramsar-wetland-designation-criteria, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, codex-alimentarius-food-standards, nist-cybersecurity-framework, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, music-thing-modular, 1010-music, after-later-audio, cosmotronic, expert-sleepers, hieroglyphic, nekyia-circuits, ohm-force, olivella-modular, rides-in-the-storm, ritual-electronics, strymon, vermona, unicode-text-segmentation, osha-permissible-exposure-limits, fmcsa-drug-alcohol-testing-thresholds, eu-reach-annex-xvii-restricted-substances, acid-rain-technology, acl-anthology, addac-system, adobe, ai-synthesis, aium, ajh-synth, alright-devices, american-diabetes-association, animal-factory-amplification, anl, atf, avalon-project-yale-law-school, befaco, behringer, bela, bmj, boredbrain-music, buchla-easel, buchla-music-easel, cbp, ccsds, cdc, centers-for-disease-control-and-prevention, centers-for-medicare-medicaid-services, clank, cleveland-clinic, coloradowic, congress, consumer-financial-protection-bureau, doepfer, dot, dublin-core-metadata-initiative, ecma-international, elra, endorphin-es, erica-synths, erogenous-tones, exa, factiverse, fao, fao-who-codex-alimentarius-commission, ffmpeg, fieldtone, fincen-gov, frap-tools, github, haken-audio, happy-nerding, herbs-and-stones, hexinverter-electronique, hhs, hl7, hl7-international, ietf, instruo, intergovernmental-panel-on-climate-change, internal-revenue-service, international-agency-for-research-on-cancer, international-internet-preservation-consortium, international-olympic-committee, iowadot, jomox, joranalogue-audio-design, justice, klavis, koma-elektronik, lacounty, ladik, library-of-congress, little-green-cheese, man7, medlineplus, medlineplus-nih-nlm, meng-qi, milk-and-magic, misco, modbap-modular, nasa, nasa-science, national-institute-of-standards-and-technology, national-physical-laboratory, national-weather-service, ncsu, netl-flow-science-software-support, nga, nhlbi-nih, nih, nist, nmsu-cooperative-extension, noise-engineering, nortonva, office-of-the-law-revision-counsel-u-s-house-of-representatives, olivia-artz-modular, omnitone, oregon-state-university-extension-service, orvis, osha, outdoornebraska, oxi-instruments, par-nsf-gov, pittsburgh-modular, pladask-elektrisk, plum-audio, portland-gov, publications-office-of-the-european-union, pulp-logic, purdue, qu-bit-electronix, rabid-elephant, rare-waves, rfc-editor, riverwoods, rossum-electro-music, santaclaracounty, schema-org, schlappi-engineering, setonix-synth, shakmat-modular, singapore-pools, sitemaps-org, skybrary, sound-machines, sparkfun-electronics, squarp-instruments, stanford, steady-state-fate, supreme-court-of-the-united-states, synthesis-technology, texas-commission-on-environmental-quality, tiptop-audio, transportation, u-s-census-bureau, u-s-department-of-justice, u-s-department-of-justice-civil-rights-division, u-s-food-and-drug-administration, u-s-geological-survey, u-s-preventive-services-task-force, unicode-consortium, universaldependencies, us-citizenship-and-immigration-services, us-epa, usenix, usgs, ut-southwestern-medical-center, verbos-electronics, w3, w3c, westlicht, whatwg, whimsical-raps-mannequins, whole-building-design-guide-nibs, wmd, wolfram-llm-mcp-integration, xaoc-devices.
| 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"}). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the readOnlyHint annotation, the description discloses determinism, the completeness contract (abstains rather than undercounts), and the refusal to produce subjective rankings. These are meaningful behavioral traits an agent could not infer from the schema alone.
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?
Core semantics are front-loaded and every early sentence earns its place. The definition is long primarily because of the extensive mounted-corpora list, which is functional context for choosing `domain`, even though it makes the overall description unwieldy.
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?
The description covers the aggregate behavior, grouping mode, filtering, important guarantees, and available corpora. It does not specify the exact return payload shape or edge-case behavior, but an agent has enough to invoke it correctly in most situations.
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?
The schema already covers all three parameters, but the description adds useful behavior: `filter` scopes the set and `by` returns a per-value count sorted with the largest. This exceeds the baseline for high schema coverage without needing to duplicate schema details.
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 is specific and action-oriented: it defines compute as a deterministic aggregate over one corpus's complete set, with concrete query shapes ('how many X', 'break X down by Y'). It also distinguishes itself from key siblings by directing raw record/category requests to `enumerate`.
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?
It explicitly states when to use the tool (calculated-query shapes) and when not to: 'For the records/categories themselves use `enumerate`.' It also clarifies that subjective 'best' rankings are out of scope, which is valuable for tool selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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'). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds context beyond the readOnlyHint annotation by explaining the two modes (no args vs domain) and that it returns tool lists with descriptions and schemas, which is non-destructive and informative.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Concise and well-structured with two clear functional sections and usage guidance. Could be slightly shorter but remains efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Fully complete for an informational tool with no output schema. Covers both invocation modes, usage context, and examples, leaving no gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with the single optional parameter. The description adds value by explaining the behavior difference when domain is provided vs not, going beyond the schema's basic description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: to discover deeper machinery by listing all domains or a specific domain's tools with schemas. It distinguishes itself from sibling tools like lookup and search by being for deeper exploration.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states when to use: 'whenever the spine (lookup/search/verify) is too shallow for the question' and gives concrete examples like contested claims or open questions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Fetch a drillable.com address and return its typed envelope (record, grades, abstains, related actions). Pass an address returned by search, or a link carried in another drill result — a same-host path starting "/c" (records) or "/x" (operations) — e.g. "/c/eurorack?q=reverb", "/c/cocktail/negroni", "/x/eurorack/drills/cover?have=…&targets=…". Addresses COMPUTE as well as read: a collection address takes bare field filters and fold params — count by a field with "/c/eurorack/modules?group_by=manufacturer", total one with "/c/intellijel/modules?sum=specs.depth_mm", filter with "/c/eurorack/modules?capability=vca" — and a collection address alone ("/c/cocktail/cocktails") returns the complete listing with its exact count, so enumerate/count questions are one drill of the right address, not a search. A non-2xx response (e.g. a 404 teaching miss) is a valid, informative result, not a tool error — read its text; a miss lists the fields and params the node does hold.
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | A same-host path starting "/c" or "/x" (no scheme, no host, no ".."), e.g. "/c/eurorack?q=reverb" or "/x/eurorack/drills/cover?have=…&targets=…". |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=true, and the description does not contradict it, even while noting addresses can compute. It adds significant behavioral detail: addresses can compute aggregates, a non-2xx response is a valid result, and a miss lists fields/params the node holds. This goes beyond the annotation and prepares the agent for nuanced outcomes.
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 long but packed with necessary examples and nuances. It front-loads the core purpose, then systematically explains address formats, compute behavior, and response handling. While every sentence earns its place, its length might be slightly reduced by moving some examples to a separate section, but it's highly effective as is.
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 single-parameter tool with no output schema, the description exhaustively covers input semantics, edge cases (404s), and expected results (typed envelope, miss details). It leaves no ambiguity about how to construct or interpret the tool's behavior, making it fully self-contained.
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 describes 'address' as a same-host path, but the description enriches it with concrete examples, explains accepted formats, and ties them to real use cases (e.g., count, sum, filter). It also clarifies that addresses can be obtained from search or other drill results, giving the agent full context for parameter construction.
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 fetches a drillable.com address and returns its typed envelope (record, grades, abstains, related actions). It explicitly distinguishes from search by noting that enumeration/count questions are better served by drilling the right address, not searching, and provides specific address formats for different 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?
The description offers explicit guidance on when to use this tool: pass an address from search or a link in another drill result. It explains compute/aggregate use cases and clarifies that non-2xx responses are valid, informative results rather than errors, which is crucial for correct handling. It also implies when not to use (search for discovery) and gives alternative contexts.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
List broad CATEGORIES or the COMPLETE set within ONE corpus — the shape search cannot serve (search returns a ranked, capped sample, not the whole set). Requires domain. Returns every category axis with exact counts, and — with an optional filter (faceted constraints, e.g. {"spirit":"gin"}) — the COMPLETE record set scoped by it, marked complete. A count/aggregate is sound ONLY over a complete set; an incomplete return is flagged, never silently undercounted (the completeness contract). Use for "what kinds are there", "all the X", "how many X"; for one record use lookup/search. Discover a domain's facets via describe. The special domain directory enumerates the FLEET itself — the algorithm domains drillable holds (declared registry tags, faceted by class/grain; e.g. "what algorithms are there?"). Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, 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, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, koppen-climate-classification, modified-mercalli-intensity, 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, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, hl7-fhir-r4-resource-type-registry, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, ramsar-wetland-designation-criteria, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, codex-alimentarius-food-standards, nist-cybersecurity-framework, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, music-thing-modular, 1010-music, after-later-audio, cosmotronic, expert-sleepers, hieroglyphic, nekyia-circuits, ohm-force, olivella-modular, rides-in-the-storm, ritual-electronics, strymon, vermona, unicode-text-segmentation, osha-permissible-exposure-limits, fmcsa-drug-alcohol-testing-thresholds, eu-reach-annex-xvii-restricted-substances, acid-rain-technology, acl-anthology, addac-system, adobe, ai-synthesis, aium, ajh-synth, alright-devices, american-diabetes-association, animal-factory-amplification, anl, atf, avalon-project-yale-law-school, befaco, behringer, bela, bmj, boredbrain-music, buchla-easel, buchla-music-easel, cbp, ccsds, cdc, centers-for-disease-control-and-prevention, centers-for-medicare-medicaid-services, clank, cleveland-clinic, coloradowic, congress, consumer-financial-protection-bureau, doepfer, dot, dublin-core-metadata-initiative, ecma-international, elra, endorphin-es, erica-synths, erogenous-tones, exa, factiverse, fao, fao-who-codex-alimentarius-commission, ffmpeg, fieldtone, fincen-gov, frap-tools, github, haken-audio, happy-nerding, herbs-and-stones, hexinverter-electronique, hhs, hl7, hl7-international, ietf, instruo, intergovernmental-panel-on-climate-change, internal-revenue-service, international-agency-for-research-on-cancer, international-internet-preservation-consortium, international-olympic-committee, iowadot, jomox, joranalogue-audio-design, justice, klavis, koma-elektronik, lacounty, ladik, library-of-congress, little-green-cheese, man7, medlineplus, medlineplus-nih-nlm, meng-qi, milk-and-magic, misco, modbap-modular, nasa, nasa-science, national-institute-of-standards-and-technology, national-physical-laboratory, national-weather-service, ncsu, netl-flow-science-software-support, nga, nhlbi-nih, nih, nist, nmsu-cooperative-extension, noise-engineering, nortonva, office-of-the-law-revision-counsel-u-s-house-of-representatives, olivia-artz-modular, omnitone, oregon-state-university-extension-service, orvis, osha, outdoornebraska, oxi-instruments, par-nsf-gov, pittsburgh-modular, pladask-elektrisk, plum-audio, portland-gov, publications-office-of-the-european-union, pulp-logic, purdue, qu-bit-electronix, rabid-elephant, rare-waves, rfc-editor, riverwoods, rossum-electro-music, santaclaracounty, schema-org, schlappi-engineering, setonix-synth, shakmat-modular, singapore-pools, sitemaps-org, skybrary, sound-machines, sparkfun-electronics, squarp-instruments, stanford, steady-state-fate, supreme-court-of-the-united-states, synthesis-technology, texas-commission-on-environmental-quality, tiptop-audio, transportation, u-s-census-bureau, u-s-department-of-justice, u-s-department-of-justice-civil-rights-division, u-s-food-and-drug-administration, u-s-geological-survey, u-s-preventive-services-task-force, unicode-consortium, universaldependencies, us-citizenship-and-immigration-services, us-epa, usenix, usgs, ut-southwestern-medical-center, verbos-electronics, w3, w3c, westlicht, whatwg, whimsical-raps-mannequins, whole-building-design-guide-nibs, wmd, wolfram-llm-mcp-integration, xaoc-devices.
| 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"}). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond `readOnlyHint=true`, it discloses the completeness contract: the result is marked complete, a count/aggregate is sound only over a complete set, and an incomplete return is flagged rather than silently undercounted. It also explains the special `directory` domain and what its output represents, which gives the agent behavioral expectations well beyond the annotation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The core behavioral guidance is front-loaded in a few precise sentences, and the structure is logical. However, the enormous mounted-corpora list makes the description far longer than necessary for tool selection; much of that list is discoverable via `directory`/`describe`, so the conciseness suffers even though the content is relevant.
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?
With no output schema, the description covers the return shape (category axes with exact counts, complete record sets marked `complete`, incomplete results flagged), the special `directory` case, the completeness contract for counts/aggregates, and the available domains. An agent has enough to invoke the tool correctly in both its modes.
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 coverage is 100%, but the description adds value: it reinforces that `domain` is required, gives a `filter` example (`{"spirit":"gin"}`) and describes what the filter does, and enumerates the special `directory` domain and the mounted corpora. A small deduction: the long corpus list does not clarify syntax beyond the schema, and the schema already documents both parameters.
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 names a specific action ('list broad CATEGORIES or the COMPLETE set within ONE corpus') and immediately differentiates from a sibling: `search` returns a ranked, capped sample, not the whole set. The term `enumerate` is fleshed out with concrete results (category axes, exact counts, complete sets), so an agent understands exactly what the tool produces.
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?
It explicitly states when to use this tool ('what kinds are there', 'all the X', 'how many X'), when not to use it ('for one record use `lookup`/`search`'), and how to discover facets (`describe`). It also gives a concrete alternative (`search`) and explains why it is inadequate for enumeration.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Define a concept/term from a domain's glossary (e.g. 'stir', 'crop-factor', 'roughness'). Routes to each domain's lookup_concept; pass domain to target one, omit to fan out. For entities/records use search. Abstains on a miss, which is logged as a gap (the demand signal) — there is no report_gap verb. For COMPUTED quantities (molar mass, date math, unit conversions) a miss will point you to the right compute verb — follow it via describe/call rather than re-searching. Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, 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, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, koppen-climate-classification, modified-mercalli-intensity, 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, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, hl7-fhir-r4-resource-type-registry, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, ramsar-wetland-designation-criteria, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, codex-alimentarius-food-standards, nist-cybersecurity-framework, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, music-thing-modular, 1010-music, after-later-audio, cosmotronic, expert-sleepers, hieroglyphic, nekyia-circuits, ohm-force, olivella-modular, rides-in-the-storm, ritual-electronics, strymon, vermona, unicode-text-segmentation, osha-permissible-exposure-limits, fmcsa-drug-alcohol-testing-thresholds, eu-reach-annex-xvii-restricted-substances, acid-rain-technology, acl-anthology, addac-system, adobe, ai-synthesis, aium, ajh-synth, alright-devices, american-diabetes-association, animal-factory-amplification, anl, atf, avalon-project-yale-law-school, befaco, behringer, bela, bmj, boredbrain-music, buchla-easel, buchla-music-easel, cbp, ccsds, cdc, centers-for-disease-control-and-prevention, centers-for-medicare-medicaid-services, clank, cleveland-clinic, coloradowic, congress, consumer-financial-protection-bureau, doepfer, dot, dublin-core-metadata-initiative, ecma-international, elra, endorphin-es, erica-synths, erogenous-tones, exa, factiverse, fao, fao-who-codex-alimentarius-commission, ffmpeg, fieldtone, fincen-gov, frap-tools, github, haken-audio, happy-nerding, herbs-and-stones, hexinverter-electronique, hhs, hl7, hl7-international, ietf, instruo, intergovernmental-panel-on-climate-change, internal-revenue-service, international-agency-for-research-on-cancer, international-internet-preservation-consortium, international-olympic-committee, iowadot, jomox, joranalogue-audio-design, justice, klavis, koma-elektronik, lacounty, ladik, library-of-congress, little-green-cheese, man7, medlineplus, medlineplus-nih-nlm, meng-qi, milk-and-magic, misco, modbap-modular, nasa, nasa-science, national-institute-of-standards-and-technology, national-physical-laboratory, national-weather-service, ncsu, netl-flow-science-software-support, nga, nhlbi-nih, nih, nist, nmsu-cooperative-extension, noise-engineering, nortonva, office-of-the-law-revision-counsel-u-s-house-of-representatives, olivia-artz-modular, omnitone, oregon-state-university-extension-service, orvis, osha, outdoornebraska, oxi-instruments, par-nsf-gov, pittsburgh-modular, pladask-elektrisk, plum-audio, portland-gov, publications-office-of-the-european-union, pulp-logic, purdue, qu-bit-electronix, rabid-elephant, rare-waves, rfc-editor, riverwoods, rossum-electro-music, santaclaracounty, schema-org, schlappi-engineering, setonix-synth, shakmat-modular, singapore-pools, sitemaps-org, skybrary, sound-machines, sparkfun-electronics, squarp-instruments, stanford, steady-state-fate, supreme-court-of-the-united-states, synthesis-technology, texas-commission-on-environmental-quality, tiptop-audio, transportation, u-s-census-bureau, u-s-department-of-justice, u-s-department-of-justice-civil-rights-division, u-s-food-and-drug-administration, u-s-geological-survey, u-s-preventive-services-task-force, unicode-consortium, universaldependencies, us-citizenship-and-immigration-services, us-epa, usenix, usgs, ut-southwestern-medical-center, verbos-electronics, w3, w3c, westlicht, whatwg, whimsical-raps-mannequins, whole-building-design-guide-nibs, wmd, wolfram-llm-mcp-integration, xaoc-devices. 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'). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the readOnlyHint annotation, the description discloses miss behavior ('abstains on a miss', logged as a gap/demand signal), notes that no `report_gap` verb exists, explains how computed-quantity misses route to compute verbs, and instructs the agent to issue queries even when the topic is not in the mounted corpus list. This is rich, non-obvious behavioral context.
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 core routing and miss behavior is front-loaded and efficient, but the description is dominated by an enormous enumerated list of mounted corpora. Since the description explicitly says to issue the query anyway if the topic is not listed, the exhaustive list adds limited decision value and significantly increases length. It is structured, but not appropriately sized.
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 read-only glossary lookup tool with only two parameters and no output schema, the description covers the essential workflow: what the tool resolves, how domain routing works, what happens on hits versus misses, and how to recover from misses for computed quantities. There are no significant gaps that would prevent an agent from invoking it correctly.
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%, so the schema already documents both `query` and `domain`. The description adds meaningful semantics beyond the schema: omitting `domain` fans out across all mounted corpora, while providing `domain` targets a single glossary. This clarifies the optional parameter's behavior in a way the schema does not.
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 opens with a specific verb and resource: 'Define a concept/term from a domain's glossary' and gives concrete examples. It explicitly contrasts itself with `search` ('For entities/records use `search`') and explains the fan-out vs. targeted routing behavior, so it is clearly distinguished from sibling tools.
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 guidance: use `search` for entities/records, use this tool for glossary concepts, and, on a computed-quantity miss, follow the pointer to the appropriate compute verb via `describe`/`call`. It also tells the agent not to decline based on the roster, which removes a common decision ambiguity.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations present, so description carries full burden. It discloses that one email will be sent when answerable and requires explicit user consent. However, it doesn't clarify behavior if called multiple times for same question beyond 'one call per question'.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is 4 sentences long, front-loaded with purpose, then usage rules. No wasted words, but could be slightly more concise without losing clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple 2-parameter tool with no output schema, description covers purpose, usage constraints, and behavior. Lacks explicit mention of return value, but the email notification implies no immediate data return.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers all parameters with descriptions. Description adds critical usage context: email must be from this session, query is verbatim from user. This adds practical meaning beyond schema, earning above baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly identifies the action ('register interest') and the resource ('question the corpus can't answer yet'). It distinguishes from sibling tools, which are generic operations like call or compute, by specifying a notification-after-answer scenario.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states when to use ('ONLY when the user themselves asked to be told'), when not to use ('never volunteer an address from context or memory'), and limits ('one call per question'). Provides clear context and exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Search the mounted corpora by query. Routes to each domain's search tool; pass domain to target one. Empty results are logged as gaps. For COMPUTED quantities (molar mass, age/date math, unit conversions) this verb will miss and surface a cross-verb hint (e.g. compute_molar_mass) — follow that hint via describe/call rather than retrying search. Mounted corpora: acupuncture, cocktail, camera, law, copyright, trademark, music-theory, supplements, writing-style, minecraft-dungeons, spanish, medical-denials, languages, behavioral-econ, baseball, agent-practices, pokemon, mcp, readability, citations, relay, models, self-oracle, recall-traps, units, tax, physics, logic, astronomy, biology, geography, medicine, chemistry, calendar, math, eurorack, building-codes, cooking, personal-finance, stardew, coffee, electronics, physiology, diving, decibels, gearing, colorimetry, subnetting, textile-gauge, first-aid, statistics, chess-endgames, woodworking, rating-systems, tuning, check-digits, paper-sizes, wire-gauge, preferred-numbers, swe-claim-denial, roman-numerals, minecraft-mods, encodings, strength-training, hardiness-zones, terraria, unix-permissions, aspect-ratio, number-bases, resistor-color-code, braille, semver, cron, unicode, timezones, metar, incoterms, soundex, glob, ieee754, http-status, zigbee, uuid, base-encodings, percent-encoding, dms-coordinates, gray-code, hashing, classical-ciphers, hamming-code, geohash, mac-address, poker-hands, capacitor-codes, iso, dice-probability, scrabble-score, wind-chill, mach-number, saffir-simpson, dataviz, patents, chords, dtmf, shoe-size, crc, base58, bech32, base85, reed-solomon, theoretical-ecology, string-similarity, checksums, compression, prng, bloom-filter, computus, hyperloglog, peppers, search-heuristics, tomatoes, solar-times, blood-alcohol, maidenhead-locator, brewing, celestial-navigation, electrochemistry, fluid-mechanics, information-theory, structural-mechanics, regex, combinatorics, graph-algorithms, linear-algebra, psychrometrics, photographic-exposure, photometry, rf-link, screen-resolution, algorithm-complexity, color-names, type-sizes, vin, drill-bit-sizing, itu, mime-types, coding-theory, finite-automata, fourier-analysis, numerical-methods, ac-circuits, heat-transfer, markov-chains, orbital-mechanics, currency-codes, elliptic-curves, queueing-theory, totp-hotp, computational-geometry, crockford-base32, html-named-character-references, iana, thermodynamics, acoustics, magnetism, hydrostatics, gas-laws, blackbody-radiation, antenna-gain, bcp47, dimensionless-numbers, dns-record-types, midi-messages, kinematics, geometric-optics, digital-logic, convex-optimization, clothing-sizes, knitting-needle-gauge, pipe-size, winemaking-math, ansi-escape-codes, radiation-dosimetry, transmission-lines, nuclear-decay, cribbage-scoring, running-pace, dnd-math, bowling-scoring, tire-size, abn-acn, sedol-cusip, damm-verhoeff, fresnel-equations, hydrogen-spectrum, material-elasticity, pump-affinity, control-theory, em-plane-waves, ordinary-differential-equations, myrcene, posix-signals-reference, quaternions-reference, origami-flat-foldability-theorems, trailer-hitch-ball-coupler-classes, bayesian-inference, issn-check, ean-barcode, aquarium-chemistry, 3d-printing, arrow-spine, knitting-needle-sizes, bearing-sizes, camera-film-formats, horology, mechanical-vibrations, rocket-propulsion, fiber-optics, rolling-element-bearing-life, beaufort-scale, iec-60320, sae-viscosity, hat-sizes, darts-scoring, complex-numbers, boolean-algebra, game-theory, lambda-calculus, combustion-stoichiometry, bolts-screws, ham-radio-bands, miniature-scale, fracture-mechanics, torsion, catenary, standard-atmosphere, open-channel-hydraulics, gaussian-beam-optics, capillary-action, lei, fen-pgn, nmea-0183, phonetic-algorithms, lumber-grades-dimensions, film-speed-iso, telescope-optics, tabletop-rpg-probability, tcr-therapy, software-licenses, z-transform, generating-functions, terzaghi-bearing-capacity, icao, imei-reference, gs1-ai, ulid, postal-barcodes, photographic-paper-sizes, gauge-systems-industrial, fishing-line-ratings, sorting-algorithms, candle-making, pool-billiards-geometry, sourdough-ratios, electromagnetic-induction, ring-sizes, probability-distributions, isentropic-flow, fatigue-life, three-phase-power, http-headers, ghs-hazard, abrasive-grit-sizes, cycling-power-zones, group-theory, dynamic-programming-recurrences, molecular-diffusion, smtp-reply-codes, un, chain-pitch, string-gauges, sewing-pattern-grading, tabletop-wargaming-probability, aquaculture-stocking-density, polynomial-arithmetic, matrix-decompositions, nhs-number, diode-junction, elastic-collisions, pressure-vessel, reverberation-time, count-min-sketch, ieee-ethertypes, http-methods, tls-alerts, bwt-mtf, bicycle-wheel-sizing, silk-thread-nm-denier, soapmaking-lye, context-free-grammars, dc-motor-equations, usb-class-codes, punycode, film-frame-rates, aperture-f-stop-series, golf-handicap, hydroponics-nutrients, sewing-fabric-math, resin-mixing-ratios, pdf-structure, piping-water-hammer, hertzian-contact-stress, photovoltaic-cell-performance, iata-airport-delay-codes, faa, sieve-mesh-sizing, disc-golf-flight-numbers, beekeeping-hive-math, vinyl-record-cutting-specs, houseplant-light-and-watering-calc, cellular-automata-rules, error-correcting-codes-beyond-block, climbing-rope-and-anchor-ratings, knot-invariants, photovoltaic-cell-model, fiber-dispersion, osmotic-pressure-solutions, naics-sic-classification, orcid-checksum, swift-bic-format, isni-checksum, shotgun-gauge-and-choke, rope-cordage-strength-and-diameter, screen-mesh-count-and-particle-sizing, battery-cell-form-factor-codes, xor-filter, kite-line-and-wind-window, clothing-glove-size-standards, wasm-module-header, protobuf-wire-format, rankine-cycle-efficiency, projectile-ballistics-drag-corrected, aes-fips-block-parameters, voronoi-delaunay, iso15459-license-plate, np-completeness-reductions, hidden-markov-viterbi, png-ihdr-fields, mbr-partition-table, fuzzywuzzy-rapidfuzz-string-similarity-api-reference, v-belt-sprocket-sizing, go-baduk-scoring, zip-central-directory-header, curling-scoring, mahjong-hand-scoring, sudoku-difficulty-rating, dominoes-scoring, base45, typography, tides, pbkdf2, ndc, epsg, hkdf, hvac-duct-sizing, hts, elevator-rope-crane-wire-rope-classification, board-game-elo-scoring, ecfr, tide-and-moon-phase-almanac, regular-expression-derivatives, obd2-pids, emission-designators, runway-designators, qr-code, iban-structure, sewing-needle, experiment-design, scientific-method, mtg-rules, crystallography, png-chunk-type, wind-turbine-aerodynamics, rf-noise-and-link-budget, icd-10-cm, world-heritage-list-criteria, german-tax-id-checksum, cas-registry-checksum, hydraulic-hose-fitting-sizing, spectacle-frame-and-lens-sizing, beer-lambert-spectrophotometry, induction-motor-slip-torque, corrosion-rate-faraday, seebeck-thermoelectric-generation, viscosity-shear-rheology, imo-ship-number, international-code-of-signals, alcohol-proof-abv, code128-code39-barcode-checksum, usp-suture-sizing, garden-perennials, precious-metal-fineness, hop-alpha-acid-ibu, guitar-fret-spacing, juggling-siteswap, leathercraft-stitch-and-skiving, data-structure-complexity, usb-device-descriptor, ipv4-tcp-header-bitfields, cologne-phonetic-and-match-rating, needleman-wunsch-smith-waterman-alignment, billiards-collision-physics, naismith-trail, statistical-mechanics, population-genetics, electrical-transformer-turns-ratio, unicode-script-property-values, sd-card-speed-class, shipping-container-iso-6346-sizing, rebar-sizing-astm-a615, pool-spa-water-chemistry, home-canning-process-times, ceramics-glaze-chemistry, seismic-magnitude, battery-peukert-discharge, ac-skin-effect-transformer-losses, cpf-cnpj-nif-national-id-checksums, grib2-wmo-bitstream-header, aamva-drivers-license-barcode-pdf417, ntp-timestamp-format-and-leap-indicator, o-ring-sizes, npt-pipe-thread, saami-ammunition-caliber, linear-programming-simplex, clausius-clapeyron-vapor-pressure, fips, usda, orifice-venturi-flow-meter, compost-cn-ratio, beer-style-specs, archimedes-buoyancy-and-flotation, doppler-effect, compton-scattering, ipa-phonetic-alphabet, library-of-congress-classification-outline, nail-size-penny-system, book-format-folio-quarto-octavo, wine-bottle-nomenclature-volumes, garden-hose-thread-ght, wheel-bolt-pattern-pcd, stable-matching-gale-shapley, bezier-de-casteljau-splines, hall-effect, gyroscopic-precession, photoelectric-effect, combinatorial-game-theory-nim-sprague-grundy, hvac-filter-merv-rating, paper-basis-weight-system, flag-semaphore-encoding, uv-index-calc, watch-movement-ligne-sizing, model-rocket-motor-classification, cornhole-scoring, market-identifier-codes, skin-cancer-epidemiology, horseshoe-pitching-scoring, chaos-theory-fractal-dimension, thermal-expansion-coefficients, agma-gear-tooth-bending-stress, bolt-preload-torque-tension, magnetic-circuit-reluctance, merchant-category-codes, ashrae-refrigerant-designations, upu-s10-tracking-number, isrc, isil, cfi, rubiks-cube-notation-and-metrics, food-additive-e-numbers, multihash-cid, perfume-concentration-and-dilution, axe-throwing-scoring, voting-tally-methods, cheesemaking-recipe-math, canine-caloric-requirements, maritime-mid-ship-station, wcag-success-criteria, fire-hose-thread-sizing, ski-binding-din-release-setting, zipper-tooth-gauge-sizing, racket-stringing-tension-and-pattern, arrhenius-equation, larmor-radiated-power, npsh-cavitation-margin, centrifugal-fan-laws, magnus-effect, pop-rivet-sizing, michaelis-menten-enzyme-kinetics, larmor-precession, 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, weir-flow-discharge, baume-specific-gravity-converter, who, kalman-filter-and-state-estimation, coriolis-effect-deflection, schwarzschild-radius, coulombs-law-electrostatic-force, stokes-law-terminal-velocity, helical-compression-spring-rate, 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, koppen-climate-classification, modified-mercalli-intensity, 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, rayleigh-scattering-intensity, rutherford-scattering-cross-section, ais-navigation-status-message-types, nema, rfc5322-email-address-grammar, grounded-retrieval, tor-v3-onion-address, railway-signal-aspects-and-block-rules, uic-wagon-number-check-digit, asl-fingerspelling-manual-alphabet, retrieval-metrics, vehicle-stopping-distance, vcard-property-registry, nato-stanag-military-rank-codes, bip39-mnemonic-checksum, larson-miller-creep-rupture-parameter, lsh-minhash, string-matching-algorithms, icao-wake-turbulence-separation-calculator, contract-bridge-hand-evaluation, simple-machines-mechanical-advantage, led-photodiode-responsivity-and-quantum-efficiency, wind-load-structures, seawater-sound-speed, sysexits-posix-exit-codes, marc21-code-lists, fix-protocol-tag-dictionary, mutcd-traffic-sign-codes, cwe-weakness-taxonomy, nordic-personal-id-checksum, table-tennis-scoring, flywheel-kinetic-energy-storage, iec-60529-ip-code-structure, radiation-pressure, gravitational-lensing-deflection, wmo-cloud-atlas, wind-speed-averaging-conversion, FCC-NWS-SAME-event-codes-EAS, cites-appendices, transponder-squawk-codes, icd-10-pcs-code-decoder, richardson-dushman-thermionic-emission, posix-errno-codes, win32-hresult-facility-codes, basel-conv-hazard-codes, sql-sqlstate-codes, badminton-scoring, dewey-decimal-classification, mohs-hardness-scale, glasgow-coma-scale, torino-impact-hazard-scale, bortle-dark-sky-scale, textile-care-symbols-iso3758, backgammon-pip-count-and-cube, union-find-disjoint-set, quadratic-residues-jacobi-symbol, cigar-ring-gauge, surfboard-volume-calculator, seawater-sound-speed-equations, french-gauge-medical-tubing, duplicate-bridge-matchpoint-scoring, blackjack-basic-strategy-ev, rack-units, eip-55-checksum-address, iccid-sim-card-checksum, welding-rod-electrode-classification-aws, fire-sprinkler-k-factor-sizing, pinewood-derby-physics, golay-code-23-12, vexillology-flag-construction-proportions, pagerank-power-iteration, raft-consensus-safety-properties, rohs-weee-marking-symbols, ssh-key-fingerprint, woodturning-lathe-speed, table-of-consanguinity-relationship-calculator, apgar-score, mil-std-810-environmental-test-methods, colregs-navigation-rules, turntable-tonearm-alignment-geometry, roller-derby-jam-scoring, cdc-acip-immunization-schedule, gemstone-carat-weight-from-dimensions, coin-melt-value, computability-turing-machines, public-key-crypto-arithmetic, real-time-scheduling-theory, order-theory-lattices, ipv6-header-bitfields, baking-pan-volume-substitution, bicycle-spoke-length-calculation, freediving-depth-pressure-tables, croquet-and-bocce-scoring-and-legality, skip-list-probabilistic-height, merkle-tree-proof-verification, pickleball-scoring-and-rules, sound-transmission-mass-law, rfc2119-bcp14-requirement-keywords, hl7-fhir-r4-resource-type-registry, home-roasting-coffee-first-crack-development, elf-header-fields, pcap-global-header-fields, dns-header-bitfields, sec-edgar-filing-rules, falconry-jess-and-weight-management, pottery-throwing-and-clay-shrinkage, esrb-pegi-content-rating-systems, wine-appellation-classification-systems, consumer-product-recalls-policy, antitrust-merger-guidelines, rubber-plastic-shore-durometer-hardness, tea-brewing-parameters, rowing-ergometer-pace-power, fabric-gsm-areal-density-conversion, kombucha-fermentation-math, fdi-dental-tooth-numbering, precious-metal-hallmark-purity-marks, eu-vat-number-checksum, z-base-32-codec, solar-panel-tilt-poa-irradiance, specific-heat-sensible-latent-load, rxnorm-normalized-drug-names, lockpicking-pin-tumbler-tolerance, scientometrics, loinc-observation-codes, fpv-drone-motor-prop-math, kayak-canoe-hull-speed, radar-range-equation, aci-318-reinforced-concrete-flexural-capacity, supreme-court-holdings, consensus-quorum-arithmetic, tcg-deck-draw-probability, iso6709, wmo-present-weather-code, usps-pub28-abbreviations, adts-aac-frame-header, fermi-dirac-statistics, us-place-gazetteer, pickleball-equipment-specs, fmcsa-hours-of-service-limits, gdpr-administrative-fine-tiers, fmla-employee-eligibility-thresholds, butterworth-chebyshev-filter-design, hash-table-load-factor-and-collision-math, munsell-color-notation, geologic-time-scale-ics, douglas-sea-scale, palermo-impact-hazard-scale, eyring-transition-state-theory, debye-huckel-activity-coefficient, sausage-casing-diameter-standards, economic-inequality-indices, tournament-tiebreak-systems, flsa-overtime-exemption-thresholds, cpsc-childrens-product-lead-limits, fda, ramsar-wetland-designation-criteria, spirits-standards-of-identity, eeoc-charge-filing-deadlines, salometer-brine-salinity, codex-alimentarius-food-standards, nist-cybersecurity-framework, source-registry, diagnostic-ultrasound-safety-indices, tiff-image-file-directory, fx-conversion, market-structure, finite-fields, sparkfun-boards, intellijel, 2hp, make-noise, mutable-instruments, 4ms, alm-busy-circuits, bastl-instruments, fujifilm, music-thing-modular, 1010-music, after-later-audio, cosmotronic, expert-sleepers, hieroglyphic, nekyia-circuits, ohm-force, olivella-modular, rides-in-the-storm, ritual-electronics, strymon, vermona, unicode-text-segmentation, osha-permissible-exposure-limits, fmcsa-drug-alcohol-testing-thresholds, eu-reach-annex-xvii-restricted-substances, acid-rain-technology, acl-anthology, addac-system, adobe, ai-synthesis, aium, ajh-synth, alright-devices, american-diabetes-association, animal-factory-amplification, anl, atf, avalon-project-yale-law-school, befaco, behringer, bela, bmj, boredbrain-music, buchla-easel, buchla-music-easel, cbp, ccsds, cdc, centers-for-disease-control-and-prevention, centers-for-medicare-medicaid-services, clank, cleveland-clinic, coloradowic, congress, consumer-financial-protection-bureau, doepfer, dot, dublin-core-metadata-initiative, ecma-international, elra, endorphin-es, erica-synths, erogenous-tones, exa, factiverse, fao, fao-who-codex-alimentarius-commission, ffmpeg, fieldtone, fincen-gov, frap-tools, github, haken-audio, happy-nerding, herbs-and-stones, hexinverter-electronique, hhs, hl7, hl7-international, ietf, instruo, intergovernmental-panel-on-climate-change, internal-revenue-service, international-agency-for-research-on-cancer, international-internet-preservation-consortium, international-olympic-committee, iowadot, jomox, joranalogue-audio-design, justice, klavis, koma-elektronik, lacounty, ladik, library-of-congress, little-green-cheese, man7, medlineplus, medlineplus-nih-nlm, meng-qi, milk-and-magic, misco, modbap-modular, nasa, nasa-science, national-institute-of-standards-and-technology, national-physical-laboratory, national-weather-service, ncsu, netl-flow-science-software-support, nga, nhlbi-nih, nih, nist, nmsu-cooperative-extension, noise-engineering, nortonva, office-of-the-law-revision-counsel-u-s-house-of-representatives, olivia-artz-modular, omnitone, oregon-state-university-extension-service, orvis, osha, outdoornebraska, oxi-instruments, par-nsf-gov, pittsburgh-modular, pladask-elektrisk, plum-audio, portland-gov, publications-office-of-the-european-union, pulp-logic, purdue, qu-bit-electronix, rabid-elephant, rare-waves, rfc-editor, riverwoods, rossum-electro-music, santaclaracounty, schema-org, schlappi-engineering, setonix-synth, shakmat-modular, singapore-pools, sitemaps-org, skybrary, sound-machines, sparkfun-electronics, squarp-instruments, stanford, steady-state-fate, supreme-court-of-the-united-states, synthesis-technology, texas-commission-on-environmental-quality, tiptop-audio, transportation, u-s-census-bureau, u-s-department-of-justice, u-s-department-of-justice-civil-rights-division, u-s-food-and-drug-administration, u-s-geological-survey, u-s-preventive-services-task-force, unicode-consortium, universaldependencies, us-citizenship-and-immigration-services, us-epa, usenix, usgs, ut-southwestern-medical-center, verbos-electronics, w3, w3c, westlicht, whatwg, whimsical-raps-mannequins, whole-building-design-guide-nibs, wmd, wolfram-llm-mcp-integration, xaoc-devices. 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. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description is transparent about routing behavior ('Routes to each domain's search tool'), logging behavior ('Empty results are logged as gaps'), and the failure/hint behavior for computed quantities. It also discloses that an unrouted miss is treated as a demand signal. These traits go well beyond the readOnlyHint annotation.
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 core prose is front-loaded and clear, but the description is dominated by an enormous unbroken inventory of mounted corpora, making it extremely long and hard to scan. That inventory could have been structured elsewhere (e.g., as an enum or supplementary list) rather than bloating the description.
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?
Despite its length, the description is contextually rich: it explains routing, domain targeting, empty-result logging, cross-verb hints for computed quantities, and how to handle topics absent from the roster. There is no output schema, so edge-case guidance in the description carries the full burden, and it does so comprehensively.
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 coverage is 100%: `query` is described as 'What to search for.' and `domain` as 'Optional: restrict to one domain.' The description's 'pass `domain` to target one' and 'Routes to each domain's search tool' adds a little routing context, but it does not add meaningful parameter syntax, value formats, or operator guidance beyond the schema.
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 uses a specific verb plus resource: 'Search the mounted corpora by vole description clearly states what the tool does and immediately signals that it is a query-time search across domains. It distinguishes itself from compute by explicitly stating that COMPUTED quantities are missed and a cross-verb hint is surfaced.
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 and when-not-to-use guidance: search the mounted corpora by query, pass `domain` to target one, and for COMPUTED quantities use the hinted verb (e.g. compute_molar_mass) via describe/call instead of retrying search. It also instructs not to decline search based on the roster, which is a clear user-facing usage rule.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=true, and the description adds significant behavioral context: two modes of operation, the distinction between recognition-free and catalog-match grading, and the meaning of 'asserted'. No contradictions with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the purpose but is somewhat verbose and dense, mixing examples and technical details. It could be restructured for clarity without losing information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (6 params, nested objects, no output schema), the description covers parameter modes, return behavior (receipt vs badge), and grading logic, making it sufficiently complete for an agent to use effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, baseline 3, but the description adds meaning beyond schema: explains how 'op' is discovered, how 'asserted' enables grading, and the relationship between parameters. This extra context justifies a 4.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool checks claims against corpora and describes two distinct modes (SINGLE and RECEIPT). However, it does not explicitly differentiate from sibling tools like 'search' or 'lookup', which could also involve fact-checking.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides internal guidance on when to use SINGLE vs RECEIPT mode and explains parameter combinations. However, it lacks explicit comparison to sibling tools or scenarios where this tool should not be used.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
No tool schema history has been recorded yet.
Claiming proves that you control a remote MCP connector. It does not move, proxy, or interrupt the server.
Open the connector listing, choose Claim ownership, and sign in to Glama.
Complete one verification method:
GitHub identity — fastest for official registry listings. For a namespace such as io.github.alice/server, link the matching GitHub user or an account that owns the GitHub organization, then choose Claim with GitHub.
HTTP challenge — works when you can deploy a public file. Generate a token, publish the exact JSON Glama shows at /.well-known/glama.json on the same origin as the connector, then choose Check HTTP challenge.
DNS challenge — works when you control DNS but cannot change the server. Generate a token, create the exact TXT record Glama shows, wait for it to propagate, then choose Check DNS challenge.
After verification, Glama sends a confirmation email and gives you access to listing details, thumbnails, health checks, and analytics. Keep the HTTP file or DNS record in place: Glama periodically checks it and ownership remains verified while the token is discoverable.
The HTTP ownership file has this structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"claim": "glama_claim_..."
}Claim tokens are opaque, stable, and bound to the signed-in Glama account. They contain no email address or other personal information. If Glama can no longer discover a verified HTTP or DNS token, it starts a seven-day grace period before removing claim-based access. Restore the same token during that period to keep ownership verified. Never publish an email address, Glama session token, GitHub token, or connector credential as ownership proof.
If verification fails, confirm that you copied the current token exactly. The HTTP file must be public, return valid JSON with a successful HTTP response, and stay on the connector's origin. DNS changes may need more time to propagate. A claim cannot transfer to a different origin or hostname: if the connector target changes, Glama starts the grace period and the new target must be claimed separately after the previous claim is released.
For a connector linked to the official MCP Registry, registry updates continue to replace its name, description, and URL by default. After claiming, open Manage connector and enable Use Glama listing details as the source of truth if edits made on Glama should be preserved. Categories and thumbnails are always managed on Glama; registry linkage and technical connection settings continue to sync.
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
To improve your MCP server's ranking:
Claim ownership of the server listing
Complete the server profile with an accurate description and thumbnail
Provide a test profile so Glama can connect to and evaluate the server
Keep tool definitions clear and complete to earn a high Tool Definition Quality Score (TDQS)
Route real usage through the Glama Gateway; more recorded successful server uses also improve the ranking
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.
No comments yet. Be the first to start the discussion!
AI-verified knowledge base with trust scoring, temporal facts, and skill cards.
Citable retrieval across papers, books, patents, Wikipedia, and live social sources.
AI research grounded in 300M scientific works — every citation a verifiable DOI.
Cite the claim, not the paper: 5,033 assertions, each hash-verifiable against its source PDF
Add one secure layer between your agents and this server.
Each tool has a distinct primary role—describe discovers, search/lookup/enumerate retrieve different shapes, compute aggregates, drill fetches addresses, verify checks claims, and notify_when_held tracks gaps. The main ambiguity is that compute and drill can both serve count/aggregate questions, though the descriptions do cross-reference each other to guide selection.
Eight of the nine tools follow a clear lowercase single-word verb pattern: call, compute, describe, drill, enumerate, lookup, search, and verify. notify_when_held breaks that pattern with snake_case and a multi-word verb phrase, creating a minor but noticeable inconsistency.
Nine tools is a well-scoped count for a knowledge retrieval and verification server. Each tool earns its place and the set avoids both bloat and thinness.
The tool surface covers the full intended lifecycle: discovery, search, glossary lookup, complete-set enumeration, aggregation, address-based drilling, claim verification, and registering unanswered questions. Abstentions and gap logging are built into misses, and describe/call unlock domain-specific verbs, so there are no obvious dead ends.
