v1.5.0 - MCP SDK Upgrade, Security Improvements & New Tools
What's New
🔧 Core Improvements
- MCP SDK v1.25.2: Latest Model Context Protocol SDK with enhanced compatibility
- Auth Alignment: Standardized environment variable naming (
HELPSCOUT_APP_ID/HELPSCOUT_APP_SECRET) to match Help Scout UI - Content Redaction: Renamed to
REDACT_MESSAGE_CONTENTfor clarity
🆕 New Tool
structuredConversationFilter: ID-based refinement and direct ticket number lookup (e.g., "Show ticket #42839")
🛡️ Security & Stability
- CI Branch Guard: Docker builds now verify tag is on main branch before publishing
- Enhanced Input Validation: Improved error handling from comprehensive code review
- Tool Discovery: Clearer descriptions and decision tree for better LLM tool selection
📦 Installation
NPM (Claude Code, Cursor, etc.):
```bash
npx help-scout-mcp-server
```
Docker:
```bash
docker run -e HELPSCOUT_APP_ID="your-id" -e HELPSCOUT_APP_SECRET="your-secret" drewburchfield/help-scout-mcp-server
```
Claude Desktop: Download the .mcpb file below and double-click to install.
Configuration
```
HELPSCOUT_APP_ID=your-app-id
HELPSCOUT_APP_SECRET=your-app-secret
```
See README for full documentation.