An MCP (Model Context Protocol) server for FreeScout helpdesk ticket management. This server provides tools to interact with FreeScout tickets, analyze issues, and manage customer responses.
- 🎫 Ticket Management: Fetch, analyze, and update FreeScout tickets
- 🔍 Intelligent Analysis: Automatically analyze tickets to determine issue type, root cause, and solutions
- 💬 Draft Responses: Generate customer replies based on ticket analysis
- 📊 Advanced Search: First-class filter parameters with relative time support ("7d", "24h")
- 🔒 Type Safety: Full Zod schema validation with structured outputs
- 🔁 Reliability: Automatic retry logic with exponential backoff for transient failures
- ⚡ Protocol-ready stdio: A fresh
buildServerfactory serves both 2025-era and 2026 MCP stdio clients
- Requires Node.js 24 or newer.
- Uses
@modelcontextprotocol/server2.x with Zod 4 input schemas. - Serves both the 2025 legacy handshake and the 2026 stdio protocol from the same server factory.
- Delivers
structuredContentfor stable analysis and write-operation results without declaring output schemas. - Accepts FreeScout's successful
204 No Contentupdate responses and records the user ID that initiated a ticket update.
- Node.js 24 or higher
- FreeScout instance with API access enabled
The easiest way to use this MCP server is with npx: