Server data from the Official MCP Registry
TomTicket helpdesk MCP: tickets, replies, time, customers, chats, and KB
About
TomTicket helpdesk MCP: tickets, replies, time, customers, chats, and KB
Security Report
This is a well-structured MCP server for the TomTicket helpdesk API with proper authentication via bearer token stored in environment variables. Code quality is good with appropriate input validation using Zod, and permissions align well with the server's purpose. Minor findings relate to low-severity code quality issues and a token generation tool that exposes temporary credentials, but no critical vulnerabilities or malicious patterns detected. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: TOMTICKET_TOKEN
Environment variable: TOMTICKET_BASE_URL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-glira-mcp-tomticket": {
"env": {
"TOMTICKET_TOKEN": "your-tomticket-token-here",
"TOMTICKET_BASE_URL": "your-tomticket-base-url-here"
},
"args": [
"-y",
"mcp-tomticket"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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 review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.