Skip to content
MCP server

MCP Ticket Demo

Reference MCP server with ticket desk tools, auth modes and a live dashboard for learning

Runs locally
Install
Pricing
Open source
Platforms
CLI, API, vscode
Runs
Locally
Version
1.9.0
Listing updated
today

Similar MCP servers

About MCP Ticket Demo

MCP Ticket Demo is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MCP_API_KEYAPI key for authenticated tool calls. Issue one on /admin → API Keys. Required when AUTH_MODE=write or AUTH_MODE=all.
  • AUTH_MODEAuthentication mode: off (default), write (write+pii tools gated), all (every tool gated).
  • MCP_USERSExtra username/password users: 'alice:secret:read,write'. Comma-separated, colon-delimited.
  • RATE_LIMITMax tool calls per window per caller. Default 60.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Personal open-source project distributed via npm; no paid plan mentioned.

MCP Ticket Demo 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.

How AIPoweredBot checks servers