mcpField
M
mcp-tomticket

mcp-tomticket

Local
github.com/gliraBusiness & Marketing0Updated 10w ago
Repository

About mcp-tomticket

mcp-tomticket is an MCP server for the TomTicket v2 API, aimed at teams managing helpdesk work through AI workflows. It covers tickets as well as customers, organizations, chats, departments, and the knowledge base.

Key features

  1. 01List and inspect tickets
  2. 02Reply to, comment on, and create tickets
  3. 03Log work time and finish tickets
  4. 04Manage customers, organizations, and chats
  5. 05Access departments and the knowledge base

Use cases

  1. 01Review open tickets and reply to customers
  2. 02Log ticket work time and close tickets
  3. 03Create tickets or assign them to operators
  4. 04Look up customer, chat, or knowledge base details

MCP support

It exposes TomTicket v2 ticketing and related helpdesk operations as tools for MCP clients. A TomTicket Bearer Token must be supplied through an environment variable.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "glira-mcp-tomticket": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-tomticket"
      ],
      "env": {
        "TOMTICKET_TOKEN": "<TOMTICKET_TOKEN>",
        "TOMTICKET_BASE_URL": "<TOMTICKET_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y mcp-tomticket
Environment variables to set
TOMTICKET_TOKENSecretBearer Token created in TomTicket (Administração → Configurações da Conta → API)
TOMTICKET_BASE_URLAPI base URL. Default: https://api.tomticket.com/v2.0

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-tomticket1.0.0

Tools

49

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
pageintegerNoPage. Up to 50 items per page. Default: 1.
prioritystringNoComma-separated priorities: 1 low, 2 normal, 3 high, 4 urgent.
show_tagsintegerNo1 to include tags.
operator_idstringNoFilter by attendant. Leave empty to find tickets without an attendant.
department_idstringNoFilter by department.
show_stopwatchintegerNo1 to include tracked times.

Details

From the project README

mcp-tomticket

npm MCP Registry Glama

Servidor MCP para a API TomTicket v2. Lista, responde, lança horário e finaliza chamados e também cobre clientes, organizações, chats, departamentos e base de conhecimento.

Não existe endpoint de login. O Bearer Token é criado no painel: Administração → Configurações da Conta → API → Novo Token. Marque Pode criar e modificar dados para respostas, horário e finalização.

O token vai só em variável de ambiente. Nunca o commite.

Requisitos

  • Node.js >= 18
  • Token de API do TomTicket (conta Premium/Enterprise)

Instalação

Via npm (recomendado):

npx mcp-tomticket

No Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "tomticket": {
      "command": "npx",
      "args": ["-y", "mcp-tomticket"],
      "env": {
        "TOMTICKET_TOKEN": "cole-o-token-aqui"
      }
    }
  }
}

Clone local:

git clone https://github.com/glira/mcp-tomticket.git
cd mcp-tomticket
npm install
cp .env.example .env
# edite .env e cole o TOMTICKET_TOKEN
npm run build

Validação rápida (somente leitura):

npm run smoke

Opcional — cria, comenta, responde e finaliza um chamado de teste com assunto [MCP TESTE]:

npx tsx scripts/smoke.ts --write

Recarregue os MCPs em Settings → MCP. Exemplo local em .cursor/mcp.json.example.

Tools principais

ToolAção
tomticket_list_open_ticketsChamados abertos
tomticket_list_ticketsTodos, com filtros
tomticket_get_ticketDetalhe + respostas + horários
tomticket_reply_ticketResposta do atendente (start_date/end_date lançam horário)
tomticket_comment_ticketComentário interno
tomticket_finish_ticketFinaliza (time_work em minutos)
tomticket_start_status / tomticket_close_statusCronômetro de status
tomticket_create_ticketAbre chamado
tomticket_transfer_ticket / tomticket_assign_operatorTransferir / vincular atendente

Há também tools de clientes, organizações, chats, departamentos, KB e campos personalizados. Operações de escrita avisam que alteram produção. Finalizar um chamado exige atendente vinculado (tomticket_assign_operator).

Rate limit

A API aceita 3 requisições por segundo. O client aplica intervalo mínimo de 350 ms.

Variáveis

VariávelObrigatóriaDescrição
TOMTICKET_TOKENsimBearer Token do painel
TOMTICKET_BASE_URLnãoPadrão https://api.tomticket.com/v2.0

Licença

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.