This server has basic tool definitions with schemas and descriptions, but falls short of production quality. All 5 tools have names, descriptions, and input schemas visible in src/index.ts. However, descriptions are extremely terse (10-30 chars), parameter descriptions are sparse or missing entirely, output schemas are undocumented, and error handling provides no recovery guidance. The 'search' tool has some parameter descriptions (type, communities, sort) but others lack detail. Most critically, no tool documents what it returns, making it impossible for LLMs to plan downstream calls or extract needed fields. Parameter validation is minimal, no enums for constrained values like 'type' or 'sort', no ranges for numeric params (page, size). The server lacks any tool annotations (readOnlyHint, etc.) despite all tools being read-only. This is typical of early-stage community servers.

• Add output schema documentation to each tool. Example for 'search': 'Returns {hits: [{id, title, creators, publication_date, resource_type, ...}], total: number, page: number}'. This enables LLMs to extract and chain results.
• Expand tool descriptions to 50-200 chars. Example: 'Search Zenodo records by keyword, type, or community. Returns paginated results with metadata. Use this to discover datasets, publications, or software before fetching details with record().'
• Convert 'type' and 'sort' parameters to enums in the schema. Replace free-form strings with explicit allowed values: type: enum[dataset, publication, software, presentation, poster, image, video, other]; sort: enum[mostrecent, bestmatch, mostviewed].
• Add parameter descriptions for all numeric and string params. Example: 'page: Result page number (1-indexed, default 1)'; 'size: Results per page (1-1000, default 25)'; 'query: Search keywords (required, e.g. "climate model")'.
• Enhance error messages with recovery hints. Example: 'Record not found. Try search() with keywords to find the record ID first.' or 'Invalid community ID. Call communities() to list available communities.'