Simple MCP Server

MCP server for the Simple Support System helpdesk API: read, answer and move tickets.

Local serverstdio

What is the Simple MCP Server?

MCP server for the Simple Support System helpdesk API: read, answer and move tickets.

The short version

Local MCP server (stdio) for the REST API of the Simple Support System add-on for Concrete CMS. It lets an assistant work a support queue the way a human would: find the ticket, read it with its history, write a reply, move it to the next state. Projects, attachments and moderation are covered as well.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Statesnew, open, in_progress, on_hold, resolved, duplicate, invalid, wont_fix, closed. set_ticket_state accepts all of them except new, which is only set when a ticke
Typesbug, enhancement, proposal, task
Prioritiestrivial, minor, major, critical, blocker
list_ticketsLists tickets with filters for project, state, type, priority, assignee, text search and change date, sorted and paged. Compact summaries by default.
get_ticketReads one ticket with its attachments and, unless switched off, all of its comments.
reply_to_ticketPosts a reply as a comment on a ticket and triggers the notification mails.
set_ticket_stateMoves a ticket to another workflow state and notifies everyone involved.
create_ticketCreates a ticket in a project, by project id or project handle, optionally with uploaded files.
update_ticketChanges title, content, type, priority or assignee. Only the given fields are touched.
approve_ticketApproves a moderated ticket.
delete_ticketDeletes a ticket with all comments and attachment links. Irreversible, needs confirm: true.
list_ticket_commentsLists the comments of a ticket.
update_commentReplaces the text of a comment.
approve_commentApproves a moderated comment.
delete_commentDeletes a comment. Irreversible, needs confirm: true.
list_projectsLists the support projects, with access tokens when an API key is configured.
get_projectReads one project by id.
create_projectCreates a project, private projects get a generated access token.
update_projectChanges name, handle or visibility of a project.
delete_projectDeletes a project with every ticket and comment inside it. Irreversible, needs confirm: true.
list_ticket_attachmentsLists the files attached to a ticket.
upload_attachmentUploads a local file into the file manager and returns its file id.
add_ticket_attachmentsLinks uploaded file ids to a ticket.
download_attachmentResolves the download URL of an attachment and can save it to a local path.
delete_attachmentRemoves a file from a ticket. Irreversible, needs confirm: true.
get_server_infoShows the configured API URL, whether a key is present and the accepted states, types and priorities. The key itself is never returned.

How to install the Simple MCP Server

{
  "mcpServers": {
    "simple-support-system": {
      "command": "node",
      "args": [
        "/absolute/path/to/simple-support-system-mcp/dist/src/index.js"
      ],
      "env": {
        "SIMPLE_SUPPORT_SYSTEM_BASE_URL": "https://support.example.com",
        "SIMPLE_SUPPORT_SYSTEM_API_KEY": "YOUR_SIMPLE_SUPPORT_SYSTEM_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SIMPLE_SUPPORT_SYSTEM_BASE_URLDeclared in the maintainer’s client configuration.Yes
SIMPLE_SUPPORT_SYSTEM_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Simple to States.”
  • “Use Simple to Types.”
  • “Use Simple to Priorities.”

Frequently asked questions

MCP server for the Simple Support System helpdesk API: read, answer and move tickets. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.