lgndluke/REI3-Tickets-MCP-Server

REI3 Tickets MCP Server

A simple FastMCP server for the REI3 Tickets application.

Key Features • Installation • Demonstration • Credits • Donate

Key Features

• Create tickets.
• Create ticket worklog entries.
• Close ticket by ticket key functionality.
• Get context by ticket key functionality.
• Get ticket info by ticket key functionality.

Installation

Installation instructions (release)

[!NOTE] The FastMCP disk storage backend is currently blocking the creation of a new release build.
Issue link: https://github.com/jlowin/fastmcp/issues/2514
Until this is resolved, please refer to other installation methods.

1. Create a designated user in REI3 with access to the Tickets API role.
   This user will be used for authentication.

2. Set up an API Profile in your REI3 tickets instance.
   You can create one under: Tickets > Admin Tab > API profiles

3. Download the latest release.

4. Set-ExecutionPolicy Bypass -> if you plan on using the shortcut 'open_config.ps1' script.

5. Adjust config.ini file variables.

6. Start the 'REI3 Tickets MCP Server.exe'

Installation instructions (manual)

1. Install Python 3.13.5.

2. Install uv Python package manager.

3. Add uv to PATH.

4. Create a designated user in REI3 with access to the Tickets API role.
   This user will be used for authentication.

5. Set up an API Profile in your REI3 tickets instance.
   You can create one under: Tickets > Admin Tab > API profiles

6. Download/Clone and extract this repository and adjust the config.ini file variables.

7. Ensure you have an MCP Client with the capability to run MCP tools at your disposal.
   I used AnythingLLM

8. Configure the MCP-Server JSON configuration to include the REI3-Tickets-MCP-Server.

Installation instruction (docker)

1. Install docker.

2. Install git.

3. Create a designated user in REI3 with access to the Tickets API role.
   This user will be used for authentication.

4. Set up an API Profile in your REI3 tickets instance.
   You can create one under: Tickets > Admin Tab > API profiles.

5. Download/Clone and extract this repository and adjust the config.ini file variables.

6. Run the setup_docker.ps1 script, it will create the docker image for you, as well as provide instructions on how to create the container.

MCP-Server JSON configuration examples for AnythingLLM:

For transport mode 'http':

{
  "mcpServers": {
	"REI3-Tickets-MCP-Server" : {
		"url": "http://127.0.0.1:54321/mcp/",
		"type": "streamable"
	}
  }
}

[!NOTE] Some MCP-Clients do not yet natively support OAuth Flows.
If this affects you, the 'mcp-remote' package might be a solution.
Link: https://www.npmjs.com/package/mcp-remote

For transport mode 'http' with the 'mcp-remote' package.

{
  "mcpServers": {
	"REI3-Tickets-MCP-Server" : {
		"command": "npx",
		"args": [
          "mcp-remote",
          "https://127.0.0.1:54321/mcp/"
        ]
	}
  }
}

[!IMPORTANT] 'stdio' transport has been removed in versions later than release: 2025-10-03_02
Please refer to transport mode 'http'.

For transport mode 'stdio':

{
  "mcpServers": {
	"REI3-Tickets-MCP-Server" : {
		"command": "uv",
		"args": [
			"--directory",
			"ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\REI3-Tickets-MCP-Server-main",
			"run",
			"rei3_tickets_mcp_server.py"
		]
	}
  }
}

Demonstration

Creating a REI3 ticket using the REI3-Tickets-MCP-Server:

Created ticket:

Created ticket worklog:

Creating a worklog entry inside an existing ticket:

Created ticket worklog:

Credits

This software utilizes:

• REI3

Donate