mcp-freescout

MCP.Pizza Chef: verygoodplugins

This server connects your AI assistant to your FreeScout helpdesk, letting you fetch, analyze, and update support tickets easily. You can read ticket details, understand issues, add notes, draft replies, and change ticket status — all from apps like Claude Desktop or Cursor. It requires a FreeScout account with API access and a simple setup to link your assistant to your helpdesk.

Communication
Other

Use This MCP server To

Fetch detailed FreeScout tickets with conversation threads Analyze ticket issues to find root causes and classify problems Add internal notes to tickets for team communication Update ticket status and assign tickets to team members Create and save draft replies to customer tickets Search tickets using advanced filters and relative time Integrate ticket workflows with Git for automation

README

FreeScout MCP Server

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.

Features

  • 🎫 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 buildServer factory serves both 2025-era and 2026 MCP stdio clients

v3 runtime

  • Requires Node.js 24 or newer.
  • Uses @modelcontextprotocol/server 2.x with Zod 4 input schemas.
  • Serves both the 2025 legacy handshake and the 2026 stdio protocol from the same server factory.
  • Delivers structuredContent for stable analysis and write-operation results without declaring output schemas.
  • Accepts FreeScout's successful 204 No Content update responses and records the user ID that initiated a ticket update.

Installation

Prerequisites

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

Quick Start (Recommended)

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

With Claude Desktop

mcp-freescout FAQ

Can I use this to fetch and analyze FreeScout helpdesk tickets?
Yes — you can retrieve ticket details, analyze issues, and manage responses directly from your FreeScout instance.
Can I draft and save replies to tickets using this?
Yes — it lets you generate and save draft replies with formatting that FreeScout supports.
Which apps can I use this with?
It works with Claude Desktop and Cursor IDE, among others that support MCP servers.
Do I need an API key or account?
Yes — you need a FreeScout instance with API access enabled and an API key.
How hard is it to set up?
Setup is straightforward — you just paste a small configuration snippet into your app settings.
Does it require Node.js?
Yes — if you run it locally, Node.js 24 or higher is required, but you can also use npx for easier setup.