An MCP server that indexes your other MCP servers and emits playbooks on demand.
Server defines 17 tools with explicit schemas and descriptions. Most tools follow verb_noun naming (librarian_list, librarian_help, librarian_refresh). Descriptions are present and reasonably detailed (avg ~120 chars). However, parameter descriptions are sparse or missing for many tools, and output schemas are not documented. Error handling guidance is minimal. Two tools (alpha_do, beta_run) are mock examples from test code, not production tools. The approval-token pattern for write operations is well-designed but adds complexity.
Do an alpha thing with given volume.
Run beta against a list of targets.
Fetch and cache documentation from URLs.
Get detailed help for a specific MCP server, including tools, arguments, and learned notes.
List all discovered MCP servers with summaries and categories.
Propose a manifest (TOML) for an MCP server, returning a token for approval.
Restore a server's manifest from backup.
Output schemas not documented. Tools return results but LLMs cannot predict field structure, forcing them to parse unstructured responses. E.g., librarian_list, librarian_help, librarian_fetch_docs lack documented return types.
Parameter descriptions missing or minimal for complex nested objects. E.g., librarian_seed_batch accepts 'servers' array with nested 'tools' objects, but the nested structure is not described. LLMs cannot infer what fields each tool object requires.
Error handling lacks recovery guidance. Tools return errors but do not tell LLMs what to do next. E.g., if librarian_manifest_write fails due to invalid TOML, the error should suggest 'Check TOML syntax or call librarian_manifest_propose to validate first.'
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | <=2025-11-25 | v2 |
Commit a manifest restore using an approval token.
Commit a proposed manifest using an approval token.
Record a learned note about a server or tool.
Reprobe one or all MCP servers and rebuild the cache.
Bulk seed multiple servers with their tools.
Commit a proposed bulk seed using an approval token.
Propose a bulk seed operation, returning a token for approval.
Seed the index with tools from a playbook (for servers not yet installed).
Remove a server from the seeded index.
Commit a seed removal using an approval token.
Mock tools (alpha_do, beta_run) included in production tool list. These are test fixtures from examples/mock_server.rs and should not be exposed as real tools. Removes credibility and confuses agents.
Approval-token pattern requires agents to call propose, wait for user approval, then commit. This multi-step flow is complex and error-prone. Consider single-step operations with dry-run preview instead, or document the approval flow more explicitly in tool descriptions.