Loading ToolBench
Read your Swizzler cocktail library from Claude, Codex, and other MCP clients
swizzler-mcp demonstrates solid tool design with clear naming (verb_noun pattern), comprehensive descriptions (avg 150 chars), and well-structured input schemas using Zod. All 7 tools are read-only with appropriate risk classification. However, output schemas are not formally documented, responses are text-based summaries without structured field definitions. Parameter descriptions are strong but some tools lack granular error guidance. The server reads cleanly offline and reports staleness explicitly, which is excellent UX for an offline-first tool.
Explain why the Swizzler library is missing or not updating, by checking iCloud Drive on this Mac and the state of the snapshot file. Use when recipes are missing or stale.
Full details for one recipe in the user's library, by name or id.
List the user's recipe collections and how many recipes each holds.
Search the user's own cocktail library by name, ingredient, spirit, or collection. Returns one line per match. Omit every filter to list the whole library.
Report how current the local Swizzler library snapshot is, and where it came from. Use this when the user asks whether their recipes are up to date, or when a recipe they expect seems to be missing.
Given the bottles and ingredients the user has on hand, find recipes they can make. Set allowMissing above 0 to include near-misses and see what is missing.
Output schemas not formally documented. Tools return text summaries without structured field definitions. LLMs cannot reliably extract recipe IDs, counts, or metadata for downstream chaining.
get_recipe parameter 'name' accepts both recipe name and ID but lacks explicit guidance on format or resolution strategy. Description should clarify: 'Recipe name (case-insensitive) or numeric ID. If ambiguous, exact ID match takes precedence.'
Error handling relies on SnapshotUnavailableError with guidance text, but no structured error classification (retryable vs user-fixable). LLMs cannot distinguish 'file missing' (user action needed) from 'iCloud sync stalled' (retry might help).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Recipes the user has flagged "Next Round" in Swizzler — the queue of drinks they mean to make next. Use for "what's up next", "what am I making next", "what's in my queue".
search_recipes returns 'one line per match' (text summary) but does not document what fields are included per recipe (name, ID, spirit, rating?). Agents cannot reliably extract recipe IDs to pass to get_recipe.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients (Claude web, etc.). Limits deployment to local/CLI environments.