MCP Tomticket
TomTicket helpdesk MCP: tickets, replies, time, customers, chats, and KB
Install MCP Tomticket
Pick your client, then add it in one click or paste the config.
~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"mcp-tomticket": {
"command": "npx",
"args": [
"-y",
"mcp-tomticket"
]
}
}
}
Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.
Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.
Overview
Tools9
What MCP Tomticket lets your agent do. Expand a tool for its parameters.
Security & health
What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.
Recent health check succeeded.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Scanned 16d ago via OSV.dev · mcp-tomticket (npm)
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
From the project README
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)
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
Reviews
No reviews yet — be the first to share how it worked for you.
Frequently Asked Questions about MCP Tomticket
Related MCP servers
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/mcp-tomticket)<a href="https://allmcps.com/mcp/mcp-tomticket"><img src="https://allmcps.com/api/badge/mcp-tomticket?style=directory" alt="MCP Tomticket on AllMCPs" /></a>