feat: enhance README generator with programmatic access documentation

- Add comprehensive "Access Methods" section with CLI, API, MCP, and programmatic examples
- Include installation instructions for all binary commands
- Add endpoint documentation and curl examples for REST API
- Include MCP configuration examples for Claude Desktop
- Update installation section with npx usage patterns

Author: Mearman

scripts/generate-complete-readme.js

@@ -123,24 +123,40 @@ npx ${name} --help
 - Dry-run mode for safe testing
 - Detailed operation reporting
 
+### 🌐 **Multiple Access Methods**
+- **CLI Tool**: Direct command-line interface with JSON output
+- **REST API**: Lightweight HTTP server using native Node.js
+- **MCP Server**: Model Context Protocol for AI agent integration
+- **Programmatic API**: TypeScript library for Node.js applications
+
 ## 📦 Installation
 
 ### Direct Usage with npx (Recommended)
 \`\`\`bash
+# CLI Tool
 npx ${name} --help
 npx ${name} move old-doc.md new-doc.md
+
+# REST API Server
+npx ${name}-api
+
+# MCP Server
+npx ${name}-mcp
 \`\`\`
 
 ### Global Installation
 \`\`\`bash
 npm install -g ${name}
-${name} --help
+
+# All tools available globally
+${name} --help           # CLI tool
+${name}-api             # REST API server
+${name}-mcp             # MCP server
 \`\`\`
 
-### Local Installation
+### Library Installation
 \`\`\`bash
 npm install ${name}
-npx ${name} --help
 \`\`\`
 
 ### Requirements
@@ -305,6 +321,104 @@ npx ${name} index --dry-run --verbose
 - **branch**: Index in directories with subdirectories
 - **existing**: Only update existing index files
 
+## 🌐 Access Methods
+
+${name} provides multiple ways to access its functionality:
+
+### 1. CLI Tool (Command Line Interface)
+
+The primary command-line interface with JSON output support:
+
+\`\`\`bash
+# Basic usage
+npx ${name} move old.md new.md
+
+# With JSON output for scripting
+npx ${name} move old.md new.md --json
+
+# Dry run with detailed output
+npx ${name} split large.md --strategy headers --dry-run --verbose --json
+\`\`\`
+
+### 2. REST API Server
+
+Lightweight HTTP API using native Node.js (zero external dependencies):
+
+\`\`\`bash
+# Start API server (default port 3000)
+npx ${name}-api
+
+# Custom port
+PORT=8080 npx ${name}-api
+\`\`\`
+
+**Available Endpoints:**
+- \`GET /health\` - Health check
+- \`POST /api/move\` - Move single file
+- \`POST /api/move-batch\` - Move multiple files
+- \`POST /api/validate\` - Validate operation results
+
+**Example API Usage:**
+\`\`\`bash
+# Move a file
+curl -X POST http://localhost:3000/api/move \\
+  -H "Content-Type: application/json" \\
+  -d '{"source": "old.md", "destination": "new.md", "options": {"dryRun": true}}'
+
+# Health check
+curl http://localhost:3000/health
+\`\`\`
+
+### 3. MCP Server (Model Context Protocol)
+
+For AI agent integration with Claude and other MCP-compatible systems:
+
+\`\`\`bash
+# Start MCP server
+npx ${name}-mcp
+\`\`\`
+
+**MCP Configuration for Claude Desktop:**
+\`\`\`json
+{
+  "mcpServers": {
+    "${name}": {
+      "command": "npx",
+      "args": ["${name}-mcp"]
+    }
+  }
+}
+\`\`\`
+
+**Available MCP Tools:**
+- \`move_file\` - Move markdown file with link updates
+- \`move_files\` - Move multiple files with link updates
+- \`validate_operation\` - Validate operation results
+
+### 4. Programmatic API
+
+TypeScript/JavaScript library for Node.js applications:
+
+\`\`\`typescript
+import { FileOperations, moveFile, createMarkMv } from '${name}';
+
+// Simple usage
+const result = await moveFile('old.md', 'new.md');
+
+// Advanced usage
+const fileOps = new FileOperations();
+const result = await fileOps.moveFile('docs/api.md', 'reference/', {
+  dryRun: true,
+  verbose: true
+});
+
+// Factory pattern
+const markmv = createMarkMv();
+const result = await markmv.moveFiles([
+  { source: 'docs/*.md', destination: 'archive/' }
+]);
+\`\`\`
+
 ## ⚙️ Configuration
 
 Configuration options can be passed via command line flags. See each command's \`--help\` for available options.