MCP server for Kaloricke Tabulky food diary search and writes
Strong foundation with 14 well-structured tools using FastMCP. All tools have descriptions (avg 85 chars, within 10-1024 range). Input schemas present with type definitions and parameter descriptions. Naming follows verb_noun convention (search_food, record_food, list_accounts). Key strengths: pagination support (limit/page params), commit/preview pattern for write safety, account abstraction. Gaps: output schemas not documented in source; error handling returns generic _error() without recovery guidance; no tool annotations (readOnlyHint/destructiveHint); descriptions could be more LLM-optimized (some lack 'when to use' context).
Run an explicit bounded authentication check for one account.
Create or update a custom recipe in Kaloricke Tabulky.
Get diary summary for a specific date.
Return safe process/config health without active account login probes.
List configured account aliases without exposing secrets.
List private KT custom recipes/meals and their GUIDs.
Resolve recipe ingredients for KT custom recipe creation preview.
Output schemas not documented. Tool responses (e.g., search_food returns {account, query, results}) lack formal schema definitions. LLMs cannot reliably extract fields or plan downstream calls without knowing response structure.
Error handling lacks recovery guidance. _error() function returns generic error objects without actionable next steps. E.g., 'Account not found' should suggest 'Call list_accounts() to see available accounts.'
No tool annotations. Tools lack readOnlyHint (for search_food, list_accounts) and destructiveHint (for record_food, create_custom_recipe, upload_custom_recipe_image). Agents cannot distinguish safe reads from writes without explicit hints.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 67 | 2026-07-28+ | v2 |
Read-only probe for private KT custom meal/recipe form endpoints.
Preview or record a single food/drink item. Writes only with commit=true.
Preview or record normalized food items from assistant/Mealie workflows.
Preview or record a serving of a recipe.
Preview or record a weight measurement.
Search Kaloricke Tabulky food or drink records.
Upload an image for a custom recipe.
Descriptions lack 'when to use' context. E.g., probe_user_meal_endpoints (65 chars) does not explain when an agent should call it vs other recipe tools. Descriptions should answer: what does it do, when to use it, what does it return.
Parameter dependencies undocumented. record_food has mutually exclusive params (query vs food_guid, unit vs unit_guid) but descriptions do not state this. Agents may pass both, causing ambiguous behavior.