Skip to main content
Glama
mcp-tomticket

mcp-tomticket

by glira

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)

Related MCP server: relation-mcp

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

Tool

Ação

tomticket_list_open_tickets

Chamados abertos

tomticket_list_tickets

Todos, com filtros

tomticket_get_ticket

Detalhe + respostas + horários

tomticket_reply_ticket

Resposta do atendente (start_date/end_date lançam horário)

tomticket_comment_ticket

Comentário interno

tomticket_finish_ticket

Finaliza (time_work em minutos)

tomticket_start_status / tomticket_close_status

Cronômetro de status

tomticket_create_ticket

Abre chamado

tomticket_transfer_ticket / tomticket_assign_operator

Transferir / 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ável

Obrigatória

Descrição

TOMTICKET_TOKEN

sim

Bearer Token do painel

TOMTICKET_BASE_URL

não

Padrão https://api.tomticket.com/v2.0

Licença

MIT

Available Tools

49 tools
tomticket_add_custom_field_optionB

ATENCAO: altera producao. Adiciona opcao em campo personalizado.

Inputs: value (required), custom_field_id (required).

tomticket_assign_operatorB

ATENCAO: altera producao. Vincula um atendente ao chamado.

Inputs: ticket_id (required), operator_id (required).

tomticket_check_email_blacklistA

Consulta se o email esta na blacklist de abertura de chamados por email. Nao altera dados.

Inputs: email (required).

tomticket_close_statusB

ATENCAO: altera producao. Encerra o status aberto do chamado (para o cronometro).

Inputs: ticket_id (required).

tomticket_comment_ticketA

ATENCAO: altera producao. Adiciona comentario interno no chamado.

Inputs: comment (required), ticket_id (required), attachments.

tomticket_create_articleC

ATENCAO: altera producao. Cria artigo na base de conhecimento.

Inputs: title (required), content (required), visibility (required), category_id (required), +1 more.

tomticket_create_customerB

ATENCAO: altera producao. Cria um novo cliente.

Inputs: name (required), customer_id (required), email, phone, +6 more.

tomticket_create_organizationC

ATENCAO: altera producao. Cria uma organizacao.

Inputs: name (required), site, email, phone, +10 more.

tomticket_create_ticketA

ATENCAO: altera producao. Cria um novo chamado no TomTicket.

Inputs: message (required), subject (required), customer_id (required), department_id (required), +5 more.

tomticket_customer_existsB

Verifica se o cliente existe por email ou id interno. Nao altera dados.

Inputs: customer_id (required), customer_type_id.

tomticket_customer_quick_accessB

ATENCAO: gera token temporario (5 min) para o painel do cliente.

Inputs: customer_id (required), customer_type_id.

tomticket_evaluate_ticketB

ATENCAO: altera producao. Avalia um chamado ja finalizado.

Inputs: grade (required), ticket_id (required), comment, custom_fields, +1 more.

tomticket_finish_ticketA

ATENCAO: altera producao. Finaliza o chamado. time_work lanca minutos trabalhados. Nao dispara email automaticamente.

Inputs: message (required), ticket_id (required), time_work, attachments, +3 more.

tomticket_get_chatA

Consulta um chat individualmente. Nao altera dados.

Inputs: chat_id (required).

tomticket_get_customerB

Consulta os detalhes de um cliente. Nao altera dados.

Inputs: customer_id (required), customer_type_id.

tomticket_get_customer_hour_contractA

Consulta horas contratadas vs usadas no mes corrente. Nao altera dados.

Inputs: customer_id (required), customer_type_id.

tomticket_get_customer_permissionsB

Consulta permissoes basicas do cliente. Nao altera dados.

Inputs: customer_id (required), customer_type_id.

tomticket_get_ticketA

Consulta o detalhe completo de um chamado, incluindo respostas e horarios. Nao altera dados.

Inputs: ticket_id (required), show_tags, show_stopwatch, show_staggered_tickets.

tomticket_list_article_categoriesA

Lista categorias de artigos. Nao altera dados.

Inputs: no named parameters.

tomticket_list_articlesC

Lista artigos da base de conhecimento. Nao altera dados.

Inputs: page, category_id.

tomticket_list_chatsB

Lista atendimentos de chat (50 por pagina). Nao altera dados.

Inputs: page, customer_id, max_protocol, min_protocol, +5 more.

tomticket_list_customer_custom_fieldsA

Lista campos personalizados de cadastro de cliente. Nao altera dados.

Inputs: no named parameters.

tomticket_list_customer_portfoliosA

Lista carteiras de clientes (Enterprise). Nao altera dados.

Inputs: no named parameters.

tomticket_list_customersC

Lista clientes da conta (50 por pagina). Nao altera dados.

Inputs: page, order, column, organization_id, +2 more.

tomticket_list_custom_fieldsA

Lista todos os campos personalizados da conta. Nao altera dados.

Inputs: no named parameters.

tomticket_list_department_categoriesB

Lista categorias de um departamento. Nao altera dados.

Inputs: department_id (required).

tomticket_list_department_custom_fieldsA

Lista campos personalizados de chamados externos por departamento e categoria. Nao altera dados.

Inputs: category_id, department_id.

tomticket_list_department_operatorsA

Lista atendentes de um departamento. Nao altera dados.

Inputs: department_id (required).

tomticket_list_departmentsA

Lista departamentos da conta, com categorias, status e atendentes. Nao altera dados.

Inputs: show_nested_items.

tomticket_list_department_statusesA

Lista status de um departamento (necessario para iniciar cronometro). Nao altera dados.

Inputs: department_id (required).

tomticket_list_open_ticketsA

Lista chamados ABERTOS da conta TomTicket (exclui cancelados e finalizados). Nao altera dados.

Inputs: page, priority, show_tags, operator_id, +2 more.

tomticket_list_organization_custom_fieldsA

Lista campos personalizados de cadastro de organizacao. Nao altera dados.

Inputs: no named parameters.

tomticket_list_organizationsA

Lista organizacoes da conta (50 por pagina). Nao altera dados.

Inputs: page, order, column, show_custom_fields, +1 more.

tomticket_list_ticket_custom_fieldsA

Lista campos personalizados usados em chamados. Nao altera dados.

Inputs: no named parameters.

tomticket_list_ticketsB

Lista chamados da conta com filtros da API (paginado, 50 por pagina). Nao altera dados.

Inputs: page, order, column, priority, +18 more.

tomticket_read_articleB

Le o conteudo de um artigo da base de conhecimento. Nao altera dados.

Inputs: article_id (required).

tomticket_remove_custom_field_optionB

ATENCAO: altera producao. Remove opcao de campo personalizado.

Inputs: custom_field_id (required), value, option_id.

tomticket_reply_ticketA

ATENCAO: altera producao. Responde o chamado como atendente. Exige atendente vinculado. Use start_date e end_date juntos para lancar horario de trabalho.

Inputs: message (required), ticket_id (required), end_date, start_date, +1 more.

tomticket_reply_ticket_as_customerA

ATENCAO: altera producao. Responde o chamado como cliente. Nao dispara email automaticamente.

Inputs: message (required), ticket_id (required), attachments.

tomticket_search_articlesC

Pesquisa artigos da base de conhecimento. Nao altera dados.

Inputs: query (required), page, category_id.

tomticket_set_customer_accessB

ATENCAO: altera producao. Ativa ou desativa o acesso do cliente ao painel e chamados por email.

Inputs: active (required), customer_id (required), customer_type_id.

tomticket_set_customer_create_ticketsB

ATENCAO: altera producao. Define se o cliente pode criar chamados.

Inputs: customer_id (required), create_tickets (required), customer_type_id.

tomticket_start_statusA

ATENCAO: altera producao. Abre um status no chamado (inicia cronometro/status). Consulte status do departamento antes.

Inputs: status_id (required), ticket_id (required), comment.

tomticket_transfer_ticketB

ATENCAO: altera producao. Transfere o chamado entre departamentos e/ou atendentes.

Inputs: ticket_id (required), operator_id, department_id.

tomticket_update_articleC

ATENCAO: altera producao. Atualiza um artigo da base de conhecimento.

Inputs: article_id (required), title, content, visibility, +2 more.

tomticket_update_customerB

ATENCAO: altera producao. Atualiza dados do cliente. Propriedade vazia e ignorada.

Inputs: customer_id (required), name, email, phone, +8 more.

tomticket_update_organizationB

ATENCAO: altera producao. Atualiza uma organizacao. Propriedade vazia e ignorada.

Inputs: organization_id (required), name, site, email, +8 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 49 tools

    Disambiguation3/5

    Most tools are clearly distinct, but several families overlap: tomticket_list_departments already includes categories, operators, and statuses, while separate department-list tools exist. Similarly, tomticket_list_custom_fields overlaps with five scoped custom-field listers. The descriptions help, but the boundaries are not always obvious in a 49-tool set.

    Naming Consistency4/5

    The tools overwhelmingly follow a clear tomticket_verb_noun snake_case pattern, such as list_tickets, create_customer, and finish_ticket. Minor deviations like tomticket_customer_exists and tomticket_customer_quick_access break the verb-first convention, but the overall naming scheme remains predictable and readable.

    Tool Count2/5

    49 tools is well above the 25+ threshold and creates unnecessary navigation burden. Many tools could be consolidated with parameters, such as the six custom-field listers and four department listers, making the surface heavier than the domain requires.

    Completeness3/5

    Core ticket, customer, and article workflows are well covered, including mutation operations. However, notable gaps exist: there is no general ticket update/delete, no delete for articles/customers/organizations, no article-category management beyond listing, and chat tools are read-only with no reply capability.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Connect to SparrowDesk using MCP and manage your tickets, knowledge base and more.
      1
      -
    • A
      license
      B
      quality
      D
      maintenance
      Enables to interact with Re:lation support tickets via MCP. Allows searching, updating, replying to tickets, and managing customers and internal records.
      11
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the Ticksy support ticket API, enabling AI agents to read and write support tickets.
      16
      227 npm
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server to interact with Zammad ticketing system, enabling ticket search, creation, update, article addition, and user/organization/group queries via the Zammad API.
      -