mcp-tomticket
mcp-tomticket
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-tomticketNo 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 buildValidação rápida (somente leitura):
npm run smokeOpcional — cria, comenta, responde e finaliza um chamado de teste com assunto [MCP TESTE]:
npx tsx scripts/smoke.ts --writeRecarregue os MCPs em Settings → MCP. Exemplo local em .cursor/mcp.json.example.
Tools principais
Tool | Ação |
| Chamados abertos |
| Todos, com filtros |
| Detalhe + respostas + horários |
| Resposta do atendente ( |
| Comentário interno |
| Finaliza ( |
| Cronômetro de status |
| Abre chamado |
| 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 |
| sim | Bearer Token do painel |
| não | Padrão |
Licença
Available Tools
49 toolstomticket_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_link_customer_departmentB
ATENCAO: altera producao. Vincula um departamento ao cliente.
Inputs: customer_id (required), department_id (required), customer_type_id.
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_unlink_customer_departmentA
ATENCAO: altera producao. Desvincula um departamento do cliente.
Inputs: customer_id (required), department_id (required), customer_type_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
Scored across 49 tools
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.
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.
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.
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
Related MCP Connectors
Work your HelpRabbit help desk: tickets, replies, customers, the AI agent and its knowledge.
Read and search tickets; reply, add internal notes and open tickets in Faveo Helpdesk.
Freshdesk MCP Pack — helpdesk ticket and contact management via Freshdesk API v2.
MCP server for GLPI: tickets, ITIL, assets, knowledge base. GLPI 10/11. Not affiliated with Teclib'.
Related MCP Servers
FlicenseNot gradedqualityBmaintenanceConnect to SparrowDesk using MCP and manage your tickets, knowledge base and more.1-- AlicenseBqualityDmaintenanceEnables to interact with Re:lation support tickets via MCP. Allows searching, updating, replying to tickets, and managing customers and internal records.11MIT
- AlicenseAqualityCmaintenanceMCP server for the Ticksy support ticket API, enabling AI agents to read and write support tickets.16227 npmMIT
- FlicenseNot gradedqualityCmaintenanceMCP server to interact with Zammad ticketing system, enabling ticket search, creation, update, article addition, and user/organization/group queries via the Zammad API.-