mcp-tomticket
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TOMTICKET_TOKEN | Yes | Bearer Token do painel TomTicket (criado em Administração → Configurações da Conta → API → Novo Token). Obrigatório. | |
| TOMTICKET_BASE_URL | No | URL base da API TomTicket. Padrão: https://api.tomticket.com/v2.0 | https://api.tomticket.com/v2.0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| tomticket_list_open_ticketsA | Lista chamados ABERTOS da conta TomTicket (exclui cancelados e finalizados). Nao altera dados. |
| tomticket_list_ticketsB | Lista chamados da conta com filtros da API (paginado, 50 por pagina). Nao altera dados. |
| tomticket_get_ticketA | Consulta o detalhe completo de um chamado, incluindo respostas e horarios. Nao altera dados. |
| tomticket_create_ticketA | ATENCAO: altera producao. Cria um novo chamado no TomTicket. |
| 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. |
| tomticket_reply_ticket_as_customerA | ATENCAO: altera producao. Responde o chamado como cliente. Nao dispara email automaticamente. |
| tomticket_comment_ticketA | ATENCAO: altera producao. Adiciona comentario interno no chamado. |
| tomticket_finish_ticketA | ATENCAO: altera producao. Finaliza o chamado. time_work lanca minutos trabalhados. Nao dispara email automaticamente. |
| tomticket_evaluate_ticketB | ATENCAO: altera producao. Avalia um chamado ja finalizado. |
| tomticket_transfer_ticketB | ATENCAO: altera producao. Transfere o chamado entre departamentos e/ou atendentes. |
| tomticket_assign_operatorB | ATENCAO: altera producao. Vincula um atendente ao chamado. |
| tomticket_start_statusA | ATENCAO: altera producao. Abre um status no chamado (inicia cronometro/status). Consulte status do departamento antes. |
| tomticket_close_statusB | ATENCAO: altera producao. Encerra o status aberto do chamado (para o cronometro). |
| tomticket_list_customersC | Lista clientes da conta (50 por pagina). Nao altera dados. |
| tomticket_get_customerB | Consulta os detalhes de um cliente. Nao altera dados. |
| tomticket_customer_existsB | Verifica se o cliente existe por email ou id interno. Nao altera dados. |
| tomticket_create_customerB | ATENCAO: altera producao. Cria um novo cliente. |
| tomticket_update_customerB | ATENCAO: altera producao. Atualiza dados do cliente. Propriedade vazia e ignorada. |
| tomticket_get_customer_permissionsB | Consulta permissoes basicas do cliente. Nao altera dados. |
| tomticket_set_customer_accessB | ATENCAO: altera producao. Ativa ou desativa o acesso do cliente ao painel e chamados por email. |
| tomticket_set_customer_create_ticketsB | ATENCAO: altera producao. Define se o cliente pode criar chamados. |
| tomticket_list_customer_portfoliosA | Lista carteiras de clientes (Enterprise). Nao altera dados. |
| tomticket_get_customer_hour_contractA | Consulta horas contratadas vs usadas no mes corrente. Nao altera dados. |
| tomticket_link_customer_departmentB | ATENCAO: altera producao. Vincula um departamento ao cliente. |
| tomticket_unlink_customer_departmentA | ATENCAO: altera producao. Desvincula um departamento do cliente. |
| tomticket_customer_quick_accessB | ATENCAO: gera token temporario (5 min) para o painel do cliente. |
| tomticket_check_email_blacklistA | Consulta se o email esta na blacklist de abertura de chamados por email. Nao altera dados. |
| tomticket_list_organizationsA | Lista organizacoes da conta (50 por pagina). Nao altera dados. |
| tomticket_create_organizationC | ATENCAO: altera producao. Cria uma organizacao. |
| tomticket_update_organizationB | ATENCAO: altera producao. Atualiza uma organizacao. Propriedade vazia e ignorada. |
| tomticket_list_chatsB | Lista atendimentos de chat (50 por pagina). Nao altera dados. |
| tomticket_get_chatA | Consulta um chat individualmente. Nao altera dados. |
| tomticket_list_departmentsA | Lista departamentos da conta, com categorias, status e atendentes. Nao altera dados. |
| tomticket_list_department_categoriesB | Lista categorias de um departamento. Nao altera dados. |
| tomticket_list_department_operatorsA | Lista atendentes de um departamento. Nao altera dados. |
| tomticket_list_department_statusesA | Lista status de um departamento (necessario para iniciar cronometro). Nao altera dados. |
| tomticket_list_articlesC | Lista artigos da base de conhecimento. Nao altera dados. |
| tomticket_read_articleB | Le o conteudo de um artigo da base de conhecimento. Nao altera dados. |
| tomticket_search_articlesC | Pesquisa artigos da base de conhecimento. Nao altera dados. |
| tomticket_list_article_categoriesA | Lista categorias de artigos. Nao altera dados. |
| tomticket_create_articleC | ATENCAO: altera producao. Cria artigo na base de conhecimento. |
| tomticket_update_articleC | ATENCAO: altera producao. Atualiza um artigo da base de conhecimento. |
| tomticket_list_custom_fieldsA | Lista todos os campos personalizados da conta. Nao altera dados. |
| tomticket_list_ticket_custom_fieldsA | Lista campos personalizados usados em chamados. Nao altera dados. |
| tomticket_list_customer_custom_fieldsA | Lista campos personalizados de cadastro de cliente. Nao altera dados. |
| tomticket_list_organization_custom_fieldsA | Lista campos personalizados de cadastro de organizacao. Nao altera dados. |
| tomticket_list_department_custom_fieldsA | Lista campos personalizados de chamados externos por departamento e categoria. Nao altera dados. |
| tomticket_add_custom_field_optionB | ATENCAO: altera producao. Adiciona opcao em campo personalizado. |
| tomticket_remove_custom_field_optionB | ATENCAO: altera producao. Remove opcao de campo personalizado. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.