# MCP FreeScout

Connect an AI agent to FreeScout to inspect and classify tickets, update their status, and save reply drafts. Requires Node.js 24 or newer and FreeScout API access.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 30
- Author: verygoodplugins
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/verygoodplugins/mcp-freescout
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-freescout

## What it does

MCP FreeScout gives an agent tools to retrieve ticket details and conversation threads, classify an issue, and assess its likely cause. It can also add an internal note, change a ticket’s status or assignment, and save a reply draft. Markdown in the draft is converted to HTML for FreeScout.

The server runs over stdio and can be launched through `npx`. You’ll need Node.js 24 or newer, a FreeScout instance with API access enabled, its URL, and an API key. Without API access to the instance, the server cannot read or update tickets.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FREESCOUT_URL`, `FREESCOUT_API_KEY`, `FREESCOUT_DEFAULT_USER_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env FREESCOUT_URL=<FREESCOUT_URL> --env FREESCOUT_API_KEY=<FREESCOUT_API_KEY> --env FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> --transport stdio mcp-freescout -- npx -y @verygoodplugins/mcp-freescout
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-freescout --env FREESCOUT_URL=<FREESCOUT_URL> --env FREESCOUT_API_KEY=<FREESCOUT_API_KEY> --env FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> -- npx -y @verygoodplugins/mcp-freescout
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-freescout": {
            "command": "npx",
            "args": [
                "-y",
                "@verygoodplugins/mcp-freescout"
            ],
            "env": {
                "FREESCOUT_URL": "<FREESCOUT_URL>",
                "FREESCOUT_API_KEY": "<FREESCOUT_API_KEY>",
                "FREESCOUT_DEFAULT_USER_ID": "<FREESCOUT_DEFAULT_USER_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-freescout": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@verygoodplugins/mcp-freescout"
            ],
            "env": {
                "FREESCOUT_URL": "<FREESCOUT_URL>",
                "FREESCOUT_API_KEY": "<FREESCOUT_API_KEY>",
                "FREESCOUT_DEFAULT_USER_ID": "<FREESCOUT_DEFAULT_USER_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FREESCOUT_URL=<FREESCOUT_URL> -e FREESCOUT_API_KEY=<FREESCOUT_API_KEY> -e FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> mcp-freescout npx -y @verygoodplugins/mcp-freescout
```
Replace <…> with your own values

## When to use it
- classify a ticket and assess its likely cause
- retrieve a conversation by ticket ID, number, or URL
- leave an internal note for the team
- change a ticket’s status or assigned user
- save a reply draft in FreeScout

## Example prompts
- Inspect FreeScout ticket 12345 and identify the issue type and likely cause.
- Add an internal note to ticket 12345 saying the customer confirmed the fix works.
- Draft a response for ticket 12345 and save it for review before sending.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md