Skip to main content
Glama
Guipegoraro

totvs-tickets-mcp

by Guipegoraro
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TOTVS_DEBUGNoSet to '1' to enable verbose login logging to stderr.
TOTVS_TIMEOUTNoRequest timeout in seconds (default 60).
TOTVS_PASSWORDNoOverride for the Fluig password stored in keyring.
TOTVS_USERNAMENoOverride for the Fluig username stored in keyring.
TOTVS_AUDIT_LOGNoSet to '1' to append audit log to ~/.totvs-tickets-mcp-audit.log.
TOTVS_TOTP_SEEDNoOverride for the TOTP seed stored in keyring.
TOTVS_DEFAULT_ORGNoDefault Zendesk organization ID for ticket search (see totvs_whoami). Empty means all visible orgs.
TOTVS_NO_TOKEN_CACHENoSet to '1' to disable token caching on disk.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
totvs_whoamiA

Identidade do usuario no portal TOTVS derivada do token: userId Zendesk, customerCode padrao, organizacoes as quais pertence e validade do token. Use pra descobrir os organization_ids/customerCode disponiveis.

totvs_contatoA

Dados cadastrais do contato logado no portal (nome, email, telefone, empresa/customerCode, cargo). Endpoint contact/find-contact.

totvs_tickets_listarA

Busca/lista tickets de suporte TOTVS por ORGANIZACAO, com filtros e paginacao.

A busca ve tickets de qualquer solicitante da(s) organizacao(oes) — nao so os do usuario logado. keywords casa por numero, titulo e conteudo.

  • keywords: texto livre (numero do ticket, palavra do titulo/descricao/comentario).

  • status: lista de valores (ver totvs_tickets_status). None/[] = todos.

  • product_tags / module_tags / routine_tags: tags do catalogo (ver totvs_tickets_filtros). Ex Protheus: product_tags=['cattotvs_nivel_3_linha_protheus'].

  • organization_ids: IDs de org (ver totvs_whoami). None = org padrao (env TOTVS_DEFAULT_ORG, ou todas se nao configurada). [] = TODAS as orgs visiveis. ATENCAO: a org primaria/pessoal do usuario costuma retornar VAZIO; configure a org que concentra os chamados via TOTVS_DEFAULT_ORG (id via totvs_whoami).

  • requester_id: filtra por solicitante.

  • created_start/created_end/updated_start/updated_end: filtros de data (formato a confirmar).

  • page: pagina (1-based).

  • sort_by: campo de ordenacao (default updated_at). sort_order: asc/desc.

  • ticket_views: qual VISAO/aba de tickets (load-bearing, semantica confirmada pelo usuario): 1 = meus tickets (abertos por mim); 2 = tickets em que estou em copia (colaborador); 3 = tickets criados por OUTROS usuarios da org (default — e onde esta o volume). Sao conjuntos DISJUNTOS: pra cobrir tudo, consulte as 3 visoes e una os resultados. Nesta conta, 1 e 2 costumam vir vazios; a busca util fica em 3.

totvs_ticket_detalheA

Detalhe completo de um ticket (solicitante, colaboradores, organizacao, status, produto/modulo, etc). ticket_id = numero do ticket (ex: '29586485').

totvs_ticket_comentariosA

Comentarios/andamentos de um ticket, com anexos. ticket_id = numero do ticket. sort_order: 'DESC' (mais recentes primeiro) ou 'ASC'.

totvs_tickets_statusA

Lista oficial de status usaveis no filtro status de totvs_tickets_listar (value + label). Ex: {value:'new_open_hold', label:'Aberto'}.

totvs_tickets_filtrosA

Opcoes do catalogo para os filtros de totvs_tickets_listar.

  • tipo: 'product', 'module' ou 'routine'.

  • filtro: texto pra buscar dentro das opcoes (vazio = primeiras).

  • page / page_size: paginacao. Retorna itens com as tags usadas em product_tags/module_tags/routine_tags.

totvs_tickets_motivos_prioridadeA

Lista de motivos de priorizacao (priority-reasons) usados no portal.

totvs_notificacoes_countA

Numero de notificacoes nao lidas do usuario no portal (ex: {'unread': 44}).

totvs_usuarios_buscarA

Busca usuarios/contatos do Zendesk por termo (nome/email), opcionalmente escopado por organizacao. Util pra descobrir o requester_id de alguem.

  • termo: minimo 3 caracteres (a API rejeita menos).

  • organization_ids: IDs de org (None/[] = todas as visiveis).

totvs_departamentosA

Lista os departamentos/areas de atendimento do portal (key, label, nome, tags). Endpoint chats-departaments/get-departament-by-area.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Guipegoraro/totvs-tickets-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server