mcp-freescout

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
• ⚡ Modern SDK: Built on MCP SDK 1.25+ with McpServer and registerTool() patterns

Breaking Changes:

• Search API redesigned with explicit filter parameters instead of query-string syntax
• Migrated to modern McpServer class with structured outputs
• Removed Git/GitHub tools (use dedicated Git MCP servers for workflow automation)

New Features:

• Explicit search filters: assignee, updatedSince, createdSince, page, pageSize
• Relative time support: Use "7d", "24h", "30m" in date filters
• Exponential backoff retry logic for network errors and rate limits
• Structured content responses for better type safety
• Full Zod schema validation throughout

See CHANGELOG.md for migration guide.

• Node.js 18 or higher
• FreeScout instance with API access enabled

The easiest way to use this MCP server is with npx:

Add this to your Claude Desktop settings (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "freescout": {
      "command": "npx",
      "args": ["@verygoodplugins/mcp-freescout@latest"],
      "env": {