DocumentMCP has 2 tools with basic definitions. Both tools have descriptions and input schemas, but descriptions are minimal (14-36 chars vs baseline 194 chars), parameters lack guidance on expected formats/constraints, and there is no documented output schema. The edit_document tool modifies state but the description does not explicitly say so. No error recovery guidance. Naming follows verb_noun convention but descriptions are too terse to help LLM selection. read_document is read-only; edit_document is destructive but lacks confirmation pattern.

• Expand read_doc_contents description to ~150 chars: 'Retrieves the full text contents of a document by ID. Use this to read and examine a document before editing. Returns plain text. Call list_docs() first if you don't have a doc ID.'
• Expand edit_document description to ~200 chars: 'Edits a document by replacing a substring with new text. DESTRUCTIVE: changes are permanent. Replacement must match exactly including whitespace. Returns nothing on success. This operation is NOT reversible.'
• Add 'Returns' field to both tools documenting output: 'read_doc_contents returns a string containing the full document text. edit_document returns success/error only; does not return modified document contents.'
• Enhance doc_id parameter description: 'Unique document identifier (string, case-sensitive). Valid IDs: deposition.md, report.pdf, financials.docx, outlook.pdf, plan.md, spec.txt. Call list_docs() if unsure.'
• Enhance old_string parameter: 'Exact substring to replace (case-sensitive, whitespace-sensitive). Must match document content exactly or operation fails. Cannot be empty.'
• Enhance new_string parameter: 'Replacement text. If empty string, deletes old_string. Max length 10000 chars.'
• Implement error recovery: catch ValueError for 'not found' and return 'Document ID not found. Available documents: {list}. Try list_docs() to see all available documents.'
• Add dry-run parameter to edit_document: 'dry_run (optional, boolean): If true, validate the replacement without modifying. Defaults to false. Use this to preview changes before committing.'

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

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