DokuWiki MCP exposes 4 tools with significant definition gaps. The initialize, tools_list, and ping tools are protocol-level utilities with empty schemas and minimal descriptions (10-50 chars), violating the 10-1024 char baseline. The critical tools_call tool has a vague description ('Call a DokuWiki API method') that fails to explain WHEN to use it, what it returns, or its side effects. No parameter descriptions exist for the 'arguments' object, forcing LLMs to guess at structure. Output schemas are completely undocumented, LLMs cannot predict what fields to expect from tool results. Error handling is present but generic ('tool result' wrapping) without recovery guidance. The server acts as a thin proxy to DokuWiki's JSON-RPC API rather than exposing well-defined, LLM-optimized tools.

• Expand tool descriptions to 50-200 chars. Example for tools_call: 'Invoke any DokuWiki API method (e.g., wiki.getPage, wiki.putPage). Returns structured data or error. Requires authentication for write operations. Use tools_list to discover available methods.'
• Document the 'arguments' parameter: 'Object containing method-specific parameters. Structure depends on the method name. Call tools_list first to see required/optional fields for each method.'
• Add output schema documentation. For tools_call, document that responses are wrapped as {content: [{type: 'text', text: string}], isError: boolean}. For initialize, document the returned capabilities object structure.
• Add error recovery guidance to tools_call description: 'If a method is not found, call tools_list to verify the method name. If authentication fails, ensure a valid token is provided in the Authorization header.'
• Implement per-tool error messages that guide the LLM. Instead of generic 'tool failed', return 'Method wiki.getPage requires page_id parameter. Available parameters: page_id (required), version (optional, integer).' This enables self-correction.

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry