# MCP Ticket Demo

> MCP Ticket Demo is an open-source MCP server for developer tools. Reference MCP server with ticket desk tools, auth modes and a live dashboard for learning. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, vscode, Web, self-hosted
- **Repository:** https://github.com/markusvankempen/mcp-ticket-demo
- **MCP Registry name:** io.github.markusvankempen/mcp-ticket-demo
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a demo server for learning and testing the Model Context Protocol. It ships a small ticket desk, with tools for creating tickets, commenting, closing them and running schema-driven queries, alongside server-operation tools for settings, users and API keys.

According to the README, the server runs over stdio, SSE and Streamable HTTP from one codebase, and offers three auth modes (off, write, all) with per-tool gates, rate limiting and PII redaction of customer phone numbers. A browser admin page and a /log view show counters, errors and call traces as the model uses the tools.

The project suits developers who want a worked example of MCP tools, resources and prompts, or who need to test IDE integrations in VS Code, Cursor or Windsurf. The README states that tickets are held in memory and reset to seed data on restart.

## Features

- **Ticket desk tools:** Create, comment on, close and query tickets through a small set of intent-named tools.
- **Schema-driven query:** A single run_query tool reads tickets, customers, assets and settings using schemas discovered with get_schema.
- **Three auth modes:** Off, write-gated or fully gated operation, with API keys and per-tool gates set in the admin page.
- **PII redaction:** Customer phone fields show as REDACTED unless the caller holds the pii scope.
- **Rate limiting:** Caps tool calls per window per caller and reports the retry delay in errors.
- **Live observability:** A /log page shows call counters, error logs and a full call trace.

## Good for

- Learning how MCP tools, resources and prompts are structured in a working server
- Testing how an IDE client such as VS Code or Cursor handles an MCP server
- Running a live demo of MCP authentication and tool gating
- Using the codebase as a starting point for a custom MCP server

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-ticket-demo --env MCP_API_KEY='<MCP_API_KEY>' --env MCP_USERS='<MCP_USERS>' -- npx -y mcp-ticket-demo
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-ticket-demo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ticket-demo"
      ],
      "env": {
        "MCP_API_KEY": "<MCP_API_KEY>",
        "MCP_USERS": "<MCP_USERS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-ticket-demo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ticket-demo"
      ],
      "env": {
        "MCP_API_KEY": "<MCP_API_KEY>",
        "MCP_USERS": "<MCP_USERS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-ticket-demo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-ticket-demo"
      ],
      "env": {
        "MCP_API_KEY": "<MCP_API_KEY>",
        "MCP_USERS": "<MCP_USERS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-ticket-demo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ticket-demo"
      ],
      "env": {
        "MCP_API_KEY": "<MCP_API_KEY>",
        "MCP_USERS": "<MCP_USERS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-ticket-demo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ticket-demo"
      ],
      "env": {
        "MCP_API_KEY": "<MCP_API_KEY>",
        "MCP_USERS": "<MCP_USERS>"
      }
    }
  }
}
```

## Tools

- `describe_server`: First call and after any denial; discovery of server details.
- `create_ticket`: Open a ticket; pass requester_email to attribute it.
- `add_comment`: Comment on a known ticket.
- `close_ticket`: Resolve a ticket with an optional resolution note.
- `get_schema`: Lists query names or returns the shape for a given name.
- `run_query`: Reads tickets, customers, assets, timers, system, settings and events.

## FAQ

### How is the server installed?

The README gives npx mcp-ticket-demo for stdio, or cloning the repository and running npm install and npm run http inside the server folder.

### Are tickets stored persistently?

No. The README says tickets live in memory, so a new container starts from seed data.

### How are API keys supplied over stdio?

Through the MCP_API_KEY environment variable, which is required when AUTH_MODE is write or all.

### What does the default rate limit allow?

The registry entry and README give a default of 60 calls per window, with a 60000 ms window.

### Is MCP Ticket Demo free?

Yes. MCP Ticket Demo is open source, so you can use and self-host it for free.

### How do I add MCP Ticket Demo to Claude Code?

Run this command in your terminal: claude mcp add mcp-ticket-demo --env MCP_API_KEY='<MCP_API_KEY>' --env MCP_USERS='<MCP_USERS>' -- npx -y mcp-ticket-demo

### What are the best alternatives to MCP Ticket Demo?

The closest alternatives to MCP Ticket Demo are Salon booking demo (Atithi), MCP Server Template, Sample Shop MCP server, Enterprise MCP Gateway and Crimson Crab MCP Template.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Salon booking demo (Atithi)](https://ai-powered.com/mcp/salon-booking-demo-atithi): Salon booking demo (Atithi) is a free MCP server for maps and travel.
- [MCP Server Template](https://ai-powered.com/mcp/mcp-server-template): MCP Server Template is an open-source MCP server for developer tools.
- [Sample Shop MCP server](https://ai-powered.com/mcp/sample-shop-mcp-server): Sample Shop MCP server is an open-source MCP server for developer tools.
- [Enterprise MCP Gateway](https://ai-powered.com/mcp/enterprise-mcp-gateway-3): Enterprise MCP Gateway is an open-source MCP server for developer tools.
- [Crimson Crab MCP Template](https://ai-powered.com/mcp/crimson-crab-mcp-template): Crimson Crab MCP Template is an open-source MCP server for ai models and llm tooling.
- [Bmc Helix MCP](https://ai-powered.com/mcp/bmc-helix-mcp): Bmc Helix MCP is an open-source MCP server for developer tools.
- [Tiny Go MCP Server](https://ai-powered.com/mcp/tiny-go-mcp-server): Tiny Go MCP Server is an open-source MCP server for developer tools.
- [Pmcp](https://ai-powered.com/mcp/pmcp-2): Pmcp is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-ticket-demo
