Skip to content

v1.3.0 - MCP SDK Upgrade & Enhanced Tool Guidance

Latest

Choose a tag to compare

@drewburchfield drewburchfield released this 29 Aug 17:44
· 6 commits to main since this release

🎉 What's New in v1.3.0

  • 🆙 MCP SDK v1.17.4: Latest Model Context Protocol SDK with enhanced compatibility
  • 🎯 DXT Format Compliance: Fixed manifest format to follow official Anthropic specification
  • 📝 Enhanced Tool Guidance: Clear distinction between listing (searchConversations) vs content-based searches (comprehensiveConversationSearch)
  • 🔧 Improved Search UX: Better tool descriptions prevent empty search term confusion
  • 🛠️ Enhanced Version Management: Automated version bump script for all 6 version-sensitive files
  • ✅ Test Reliability: Fixed async test handling and improved timeout management
  • 🔒 Production Ready: Complete release workflow with DXT building and GitHub releases

📦 Installation Options

🎯 Claude Desktop (One-Click DXT)

  1. Download helpscout-mcp-extension.dxt below
  2. Double-click to install in Claude Desktop
  3. Enter Help Scout OAuth2 credentials
  4. Start using immediately!

📋 Manual NPM Installation

npx help-scout-mcp-server@1.3.0

🐳 Docker

docker pull drewburchfield/help-scout-mcp-server:1.3.0

🔧 Key Improvements

This release specifically addresses tool selection confusion by making it crystal clear:

  • Use searchConversations (without query) for "show me recent tickets"
  • Use comprehensiveConversationSearch (with search terms) for "find tickets about billing"

Assets

  • NPM Package: help-scout-mcp-server@1.3.0
  • Docker Image: drewburchfield/help-scout-mcp-server:1.3.0
  • DXT Extension: helpscout-mcp-extension.dxt (attached below)