MCP Server for vehicle repair history, maintenance records, warranty claims analysis, and compliance checking using GigaChat LLM with multi-agent system
AutoCompliance MCP Server demonstrates basic tool structure with LangChain wrapper layer, but has significant gaps in schema documentation, parameter validation, and error handling. The five tools (warranty_days, warranty_history, maintenance_history, vehicle_repairs_history, compliance_rag) are READ_ONLY and target a specialized domain (automotive warranty compliance). However, the visible source code in backend/agent/tools/langchain_tools.py shows only LangChain wrapper implementations, not the actual MCP server tool registration. The descriptions provided are domain-specific and moderately detailed (Russian language), but I cannot see the actual MCP server.py tool definitions, input/output schemas, or explicit tool registration with JSON Schema. The requirements.txt lists fastmcp>=2.13.3, suggesting HTTP transport, but tool schemas visible in the prompt show minimal structure: most tools accept only a single 'vin' parameter (string) with basic description. The compliance_rag tool accepts a 'query' parameter. No enum constraints, bounds checking, output schema documentation, or structured error handling is visible. LangChain wrapper code shows basic VIN validation and error logging, but no guidance for LLM recovery, no permission gates, and no audit trail. The server appears functional for its domain (Russian automotive warranty analysis), but lacks production-grade tool quality patterns.
Поиск информации в базе знаний гарантийной политики и стандартов клиентской службы дилера. Используй этот инструмент для: - Интерпретации условий гарантии - Поиска релевантных статей стандартов клиентской службы дилера - Объяснения действий клиентской службы дилера - Получения информации о гарантийных обязательствах. Входные данные: текстовый запрос на русском языке
Получить историю технического обслуживания (ТО) автомобиля. Используй этот инструмент для: - Просмотра всех проведённых ТО - Проверки соблюдения регламента обслуживания - Анализа регулярности обслуживания. Входные данные: VIN автомобиля
Получить полную историю всех ремонтов автомобиля в дилерской сети. Используй этот инструмент для: - Комплексного анализа всех ремонтов (гарантийных и платных) - Выявления повторяющихся проблем - Анализа работы дилерских центров - Поиска паттернов неисправностей. Входные данные: VIN автомобиля
Получить статистику дней простоя автомобиля в ремонте по годам. Используй этот инструмент для анализа: - Сколько дней в году автомобиль находился в ремонте - Соблюдения 30-дневного лимита по закону о защите прав потребителей - Прогнозирования рисков превышения лимита. Входные данные: VIN автомобиля (17 символов)
No explicit input schema validation visible. Tools accept 'vin' as string with only a basic description 'VIN номер автомобиля', no length constraint (should be 17), no format specification, no enum or pattern validation. Compliance_rag accepts 'query' with no constraints on length or format.
Output schema for all tools is not documented in the visible source. Descriptions state what the tools do but do not specify the structure of returned data (fields, types, pagination, totals). LLMs cannot plan downstream tool calls without knowing what fields are returned.
Error handling is minimal. LangChain wrapper code logs errors to loguru but returns generic error dicts like {'error': str(e), 'vin': vin}. No actionable recovery guidance (e.g., 'VIN validation failed. VIN must be 17 characters. Try again with a valid VIN.'). Agents cannot self-correct.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 50 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 41 | - | v1 |
Получить полную историю гарантийных обращений автомобиля. Используй этот инструмент для: - Просмотра всех гарантийных ремонтов - Анализа типов неисправностей - Изучения дат и периодов ремонтов. Входные данные: VIN автомобиля
Four of five tools accept only a 'vin' parameter and query a vehicle database; one (compliance_rag) takes a free-form query. Tool names do not clearly distinguish between guarantee history, maintenance history, and repairs history, all start with generic verbs (warranty_*, maintenance_*, vehicle_repairs_*) and LLMs may conflate which to call for a given query.
Tool registration not visible. Source provided shows only LangChain wrapper layer (backend/agent/tools/langchain_tools.py). The actual MCP server tool registration in backend/mcp_server/server.py is not included in the source. Cannot verify that tools are registered with fastmcp, that schemas are correct JSON Schema, or that the MCP protocol layer is implemented correctly.
No pagination or result limit documentation. History tools (warranty_history, maintenance_history, vehicle_repairs_history) may return large result sets (years of service records). No mention of page/offset/limit parameters, response caps, or pagination strategy in descriptions. Without limits, large responses bloat context windows.
No tool annotations visible. Tools are marked READ_ONLY in the inventory but lack explicit readOnlyHint, destructiveHint, or idempotentHint annotations. MCP spec 2026-07-28 expects tool annotations in metadata to guide agent planning and safety.
Descriptions are in Russian. While domain-appropriate, they are not optimized for LLM instruction-following. Descriptions mix 'Используй этот инструмент для' (Use this tool for) with usage guidance. Baseline is 50-200 chars for A+ tools; these descriptions range 300-400+ chars and may dilute the core intent for non-Russian-native models.