An agent API for searching and purchasing archived forum content from Comrades of War, with support for A2A (Agent-to-Agent), MCP (Model Context Protocol), and direct HTTP interfaces
Single tool 'search_archive' has a basic description and partial schema. Description is adequate (89 chars, within 10-1024 range) but lacks WHEN to use it and prerequisites. Input schema defines 'query' and 'limit' with types and descriptions, meeting minimum requirements. However, NO output schema is documented, LLMs cannot plan downstream calls or extract structured data. Parameter 'limit' lacks range constraints (min/max). No error handling guidance. Tool naming follows verb_noun pattern (search_archive) which is correct. Overall: meets bare minimum for a single read-only tool but lacks production-grade polish.
Search the Comrades of War archive for forum posts matching a query
No output schema documented. LLMs cannot infer what fields the response contains, preventing downstream tool chaining and forcing manual parsing.
Parameter 'limit' lacks numeric constraints (min/max). LLMs may pass absurd values (0, 999999) that break the API or cause timeouts.
Tool description does not explain WHEN to use it vs alternatives, prerequisites, or what the response structure contains. Incomplete docstring.
No error handling guidance. If search fails (no results, API error, timeout), LLM has no recovery path. Missing recovery-guide pattern.
Only one tool exposed. No composition or chaining capability. Archive search alone cannot satisfy multi-step workflows (search → fetch → analyze).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2025-06-18+ | v2 |