wikigen defines 3 tools with reasonable naming and solid descriptions, but lacks critical schema details and input validation guidance. Tool names follow verb_noun convention (get_docs, search_docs, index_directories) and descriptions are substantive (150-250 chars each). However, parameter schemas are incomplete: search_docs has good param descriptions but index_directories lacks detail on recursion depth behavior; output schemas are not explicitly documented; error handling provides some guidance but not comprehensive recovery paths. The server returns unstructured string responses rather than structured JSON, forcing LLMs to parse markdown-formatted results. Semantic search is a strong feature but the tool lacks pagination, output size limits, and clear chunking strategy documentation.

• Restructure search_docs output to return structured JSON: {"chunks": [{"path": str, "resource_name": str, "score": float, "content": str, "file_position": {"start_char": int, "end_char": int}}], "total_results": int, "returned": int, "has_more": bool, "next_offset": int | null}. This enables LLMs to programmatically extract fields and understand pagination.
• Expand index_directories description to 100+ chars: 'Index markdown files from specified directories to enable semantic search. Recursively scans each directory up to max_depth levels. Re-indexing updates changed files and adds new ones. Auto-called on first search if no files indexed. Returns count of new/updated files.'
• Add a tool to clear or refresh the search index: reset_search_index(). Agents may need to rebuild the index after doc updates.
• Document search_docs result format in the description: 'Performs semantic search across all indexed markdown files. Returns up to limit chunks (max 20 by default), with up to chunk_limit chunks per file (default 5). Each result includes file path, resource name, relevance score (0-1), and a 200-char content snippet.'
• Add error classification to index_directories: 'On error (invalid path, permission denied, disk full), returns: {"status": "error", "code": "<INVALID_PATH|PERMISSION_DENIED|DISK_FULL>", "message": str, "retryable": bool}. Example: 'Directory /nonexistent does not exist (retryable: false).'
• Implement offset-based or cursor-based pagination for search_docs to handle result sets larger than limit. Include 'has_more' and 'next_cursor' in response.