Single-tool server with a well-structured input schema and clear descriptions. The search_datasets tool has comprehensive parameter documentation with enums, defaults, and explanatory text. However, no documented output schema is visible in the source code, and the server lacks error handling guidance and recovery patterns. The tool description is strong (170+ chars) with actionable guidance about DOI/author inclusion, but the implementation does not appear to validate that guidance or provide structured error feedback to guide LLM self-correction.

• Document the full output schema for search_datasets. Include field names (title, authors, doi_url, publication_date, etc.), types, and whether results are paginated. Example: { 'datasets': [ { 'title': string, 'authors': [string], 'doi': string, 'published': string, 'total_count': integer } ], 'page': integer, 'total_pages': integer }
• Add error handling code that catches HTTP errors from the Borealis API and translates them into recovery guidance. For example: if 'Invalid dataverse' error, return 'Dataverse not found. Type search_datasets with query="dataverse" to list available institutions.' If query syntax error, return 'Query error. Use uppercase AND/OR/NOT for boolean logic.'
• Add regex validation to the 'query' parameter schema to enforce uppercase boolean operators, or add a pre-call transformation that normalizes case. Alternatively, enrich error messages to guide the LLM: 'Invalid query syntax. Borealis API requires uppercase AND, OR, NOT operators. Try: <corrected query>'
• Build a curated enum list of valid dataverse identifiers (from the UNIVERSITY_DATAVERSE_MAP keys) and embed it in the schema, or implement a discovery tool like 'list_dataverses()' that returns available institutions. This prevents hallucinated institution names.
• Implement pagination support: ensure search results are capped (e.g., max 50 items per call) and return a 'next_cursor' or 'page' field so agents can iterate through large result sets without context explosion. Document the cap in the tool description.