MCP server for LOOT/libloot (masterlist metadata, load order suggestion)
Three tools with comprehensive parameter schemas and detailed descriptions. All tools have explicit JSON Schema definitions with type information and parameter descriptions. Tool names follow verb_noun pattern (loot_evaluate, loot_load_order, loot_plugin_metadata). Descriptions are detailed (200+ chars) and explain WHAT, WHEN, and HOW. However, output schemas are not documented in the visible code, only input schemas are defined. Error handling is minimal (no recovery guidance or error categorization). No tool annotations (readOnlyHint, etc.) despite all being read-only operations.
Read-only: libloot — suggested load order, general messages (default). include_load_order_suggested false skips sort. include_plugin_metadata + plugin_metadata_content; pagination; include_master_header_issues; general_messages_min_severity. Env: LOOT_MCP_CACHE, LOOT_MCP_CACHE_TTL_SEC, LOOT_MCP_TIMING, LOOT_MCP_TIMINGS_JSON, LOOT_MCP_DIAGNOSTICS_LOG, LOOT_MCP_PARALLEL_METADATA=0. Does not write plugins.txt.
Read-only: load order from loadorder.txt or plugins.txt (fast). Same base args as loot_evaluate (game_type, game_path, game_local_path, etc.). Returns load_order_current only (no sort, no general_messages). Env: LOOT_MCP_CACHE, LOOT_MCP_CACHE_TTL_SEC, LOOT_MCP_TIMING, LOOT_MCP_TIMINGS_JSON, LOOT_MCP_DIAGNOSTICS_LOG, LOOT_MCP_PARALLEL_METADATA=0.
Read-only: evaluated LOOT YAML for specific plugins. Same base args as loot_evaluate (game_type, game_path, game_local_path, etc.) + plugin_names list. Returns metadata_yaml per plugin. Env: LOOT_MCP_CACHE, LOOT_MCP_CACHE_TTL_SEC, LOOT_MCP_TIMING, LOOT_MCP_TIMINGS_JSON, LOOT_MCP_DIAGNOSTICS_LOG, LOOT_MCP_PARALLEL_METADATA=0.
Output schemas not documented. Tool descriptions mention what is returned (load_order_current, load_order_suggested, general_messages, plugins map, metadata_yaml) but no formal schema definition is visible in code. LLMs cannot plan downstream operations without knowing response structure.
No tool annotations despite all three tools being read-only. MCP spec supports readOnlyHint to signal safe operations. This helps agents reason about retry safety and side effects.
Error handling lacks recovery guidance. No error categorization (retryable vs user-fixable vs fatal). Descriptions mention environment variables and caching but do not explain what errors might occur or how to recover.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Parameter descriptions use technical jargon (libloot, YAML, masterlist, prelude) without explaining what these mean to an LLM unfamiliar with LOOT. E.g., 'masterlist.yaml' should explain 'LOOT's curated load order rules database'.
Pagination parameters (plugin_metadata_offset, plugin_metadata_limit) lack constraints. No min/max documented. Descriptions do not state what happens if offset exceeds plugin count or if limit is 0 or negative.