Warracker MCP Server
mmarquezs/warracker-mcp
Integre gestão de garantias com agentes de IA via MCP
Ver no GitHubServidor MCP que integra o Warracker, plataforma de rastreamento de garantias, com agentes de IA. Permite criar, atualizar, consultar garantias e gerenciar tags programaticamente via Claude e outras ferramentas que suportam MCP.
Instalação
npx convez-ai mmarquezs/warracker-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar registro e atualização de garantias de produtos
- Consultar historicamente garantias com processamento de linguagem natural
- Anexar documentos (notas fiscais, manuais) a garantias via agentes
Veredito

Server MCP bem estruturado para conectar o Warracker com agentes de IA. Oferece operações CRUD completas e upload de arquivos, mas requer instância Warracker própria e é mais adequado para contextos corporativos ou de produto específico.
README
A tradução para o português deste README ainda está na fila.
Warracker MCP Server
MCP server for Warracker warranty management. Enables AI agents to create, update, query warranties, upload files, and manage tags programmatically.
Built with FastMCP, runs as a stdio subprocess — no HTTP server, no Docker.
Installation
pip install warracker-mcp
Or install directly from GitHub (pin to a tag):
pip install warracker-mcp@git+https://github.com/mmarquezs/warracker-mcp@v0.1.0
Configuration
Set these environment variables:
| Variable | Description | Example |
|---|---|---|
WARRACKER_URL | Base URL of your Warracker instance | http://10.0.0.143:80 |
WARRACKER_USERNAME | Username for authentication | admin |
WARRACKER_PASSWORD | Password for authentication | your-password |
MCP Client Configuration
Add to your MCP client config (e.g. Claude Desktop, opencode, Cursor):
{
"mcpServers": {
"warracker": {
"command": "warracker-mcp",
"env": {
"WARRACKER_URL": "http://10.0.0.143:80",
"WARRACKER_USERNAME": "your-username",
"WARRACKER_PASSWORD": "your-password"
}
}
}
}
Or with uvx:
{
"mcpServers": {
"warracker": {
"command": "uvx",
"args": ["warracker-mcp"],
"env": {
"WARRACKER_URL": "http://10.0.0.143:80",
"WARRACKER_USERNAME": "your-username",
"WARRACKER_PASSWORD": "your-password"
}
}
}
}
Tools
| Tool | Description |
|---|---|
warranty_create | Create a warranty with all fields + optional file attachment |
warranty_update | Update warranty fields by ID, with optional file attachment |
warranty_get | Get a single warranty by ID |
warranties_list | List/search warranties with optional filtering and pagination |
tags_list | List all existing tags |
tag_create | Create a new tag with name and optional color |
currencies_list | List all supported currencies |
warranty_upload_file | Upload a file to an existing warranty (base64 content or URL) |
Warranty Duration
When creating or updating a warranty, provide exactly one of:
warranty_duration_years— duration in yearswarranty_duration_months— duration in monthswarranty_duration_days— duration in daysexact_expiration_date— exact date (YYYY-MM-DD)is_lifetime— set totruefor lifetime warranty
File Uploads
Files can be attached during creation/update via file_content_b64, file_name, and file_type parameters, or uploaded separately using warranty_upload_file which accepts either base64-encoded content or a URL to download from.
Supported file types:
- invoice, manual, other_document: PDF, PNG, JPG, JPEG, ZIP, RAR, WEBP, GIF
- product_photo: PNG, JPG, JPEG, WEBP, GIF
Development
git clone https://github.com/mmarquezs/warracker-mcp
cd warracker-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
Run the server:
WARRACKER_URL=http://localhost:80 WARRACKER_USERNAME=admin WARRACKER_PASSWORD=pass warracker-mcp
License
MIT