Lens.org patent + scholarly search (free academic key required)
This server has critical definition gaps. All 4 tools have minimal descriptions (10-24 chars, well below the 50-200 char baseline for LLM-optimized tools). Parameter descriptions are sparse or missing entirely: 'size' and 'from' lack descriptions in both search tools; 'lens_id' has no description in either detail tool. Input schemas are present but incomplete, no type constraints, enums, ranges, or validation guidance. The 'query' parameter in scholarly_search has no description at all. Error handling is generic (401 → 'invalid or expired token') with no recovery guidance. No output schema documentation. Tool names are acceptable (verb_noun pattern) but descriptions fail to explain WHEN to use each tool or what distinguishes patents_search from patent, or scholarly_search from scholarly.
Single patent by lens_id.
Patent search.
Single scholarly work.
Scholarly works search.
scholarly_search has NO description, LLM cannot determine when to use it vs patents_search or scholarly detail tool
Parameter descriptions missing or incomplete: 'size', 'from' in both search tools lack descriptions; 'lens_id' in detail tools has no description. LLMs cannot infer parameter meaning from names alone.
No output schema documented. LLMs cannot plan downstream calls or extract required fields (e.g., does search return lens_id for detail lookups?).
No pagination guidance in descriptions. Search tools accept 'size' and 'from' but descriptions do not explain limits, defaults, or when pagination is needed.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 37 | 2026-07-28+ | v2 |
Generic error messages with no recovery guidance. '401, invalid or expired token' tells LLM nothing about next steps (retry? ask user for new token?).