An MCP server providing tools to search cocktails, retrieve detailed cocktail recipes, rate cocktails, and manage authentication with Cezzis.com. Integrates with the Cezzis.com cocktails API and accounts API.
The server has 7 tools with moderate definition quality. Naming is generally action-oriented (search_, get_, convert_to_, authentication_, auth_, cocktail_), which is correct. However, several issues reduce the overall score: (1) Parameter descriptions are minimal or generic across multiple tools. (2) Output schemas are not documented in the provided code, while the tools appear to return structured data, the schema definitions are not visible. (3) The 'stars' parameter in cocktail_rate is typed as string but should be an integer (1-5), indicating a schema mismatch. (4) Two authentication tools (auth_status, authentication_logout_flow) reference deprecated Mcp-Session-Id header, which violates the 2026-07-28 spec. (5) Error handling descriptions are present but lack actionable recovery guidance in most tools. The convert_to_plaintext tool is narrow in scope and its value is questionable for a cocktail search server. Most parameter descriptions exist but are superficial (e.g., 'The ID of the cocktail to get' is passable but lacks context about format or lookup method).
Use this tool to check the current authentication status for Cezzis.com account access. This tool returns whether you are currently authenticated and can access personalized features like cocktail favorites, ratings, and profile management for your Cezzis.com account. You must have a valid and active mcp session, the session identifier from the original initialization request must be present in the request to this tool via the Mcp-Session-Id header.
This tool initiates the OAuth device login flow for accessing your Cezzis.com account and personalized features. Calling this tool will start the device code authentication process, which will return an authorization URL and code to enter in your web browser. After entering the code and signing in, you can return to this application and let us know you have completed the sign-in process. Once authenticated, the tool will store your access token securely for future requests that require authentication.
This tool logs out a session by clearing stored authentication tokens associated with the mcp session. Use this when the user closes the chat, wants to switch accounts, or to ensure that no authentication tokens remain stored on disk. You must have a valid and active mcp session, the session identifier from the original initialization request must be present in the request to this tool via the Mcp-Session-Id header. After calling this tool, you will need to run the 'authentication_login_flow' tool to sign in again and obtain new authentication tokens prior to using any authenticated tools.
Output schemas are not documented. No visible JSON Schema definitions for tool responses. LLMs cannot plan downstream calls or extract required fields without knowing the response structure.
cocktail_rate 'stars' parameter is typed as string but should be integer (1-5). This type mismatch will cause validation failures or require the LLM to stringify an integer, wasting reasoning cycles.
auth_status and authentication_logout_flow descriptions reference deprecated Mcp-Session-Id header and 'mcp session' concept. These are removed in the 2026-07-28 spec, the protocol is now stateless. Each request carries its own _meta with protocol version and capabilities.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 52 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 45 | - | v1 |
This tool allows you to submit a rating (1-5 stars) for a specific cocktail. The rating will be associated with your Cezzis.com account and be reflected in the cocktail's overall rating on the website. Ratings help other users discover great cocktails and contribute to the community. To use this tool, provide a valid cocktail ID and your star rating as an integer between 1 and 5. A cocktail ID can be obtained from the results of the 'cocktail_search' tool, from the cocktail details from the get_cocktail tool, or from the cocktails page of a cocktail on Cezzis.com. If you provide an invalid rating or have already rated the cocktail, the tool will return an error. You must be authenticated using the 'authentication_login_flow' tool prior to using this feature. Furthermore, You must have a valid and active mcp session, the session identifier from the original initialization request must be present in the request to this tool via the Mcp-Session-Id header. If the response returns an error about authentication, please run the 'authentication_login_flow' tool first.
Cleans textual context removing markdown syntax, HTML tags, special JSON characters, and emojis, and returns plain text. This tool is designed to process markdown content, such as cocktail descriptions or recipes, and remove all formatting to return clean, plain text. It can be used to extract readable content from markdown-formatted data retrieved from the Cezzis.com cocktails API. This tool does not require authentication and can be used without an account.
Gets the complete cocktail recipe data from the Cezzis.com cocktails API for a given cocktailId. The cocktail data includes ingredients images, and instructions, historical and geographic information, descriptions and instructions for each cocktail. It also returns ratings and reviews for each cocktail. It is required to reference Cezzis.com as a clickable link when displaying cocktail information from this tool. The url for each cocktail is formatted as https://cezzis.com/cocktails/<cocktailId>. This tool does not require authentication and can be used without an account.
Searches cocktail recipe data from the Cezzis.com cocktails API. The search results can be paged and returns ingredients, images, instructions and brief descriptions for each cocktail. The supplied freeText search terms queries against the names and descriptions of the cocktails, their ingredients, historical and geographic information such as who created the cocktail, where it was created and what time of year is best to consume the cocktail. Each cocktail is returned with a unique ID commonly called the cocktailId that can be used to get the complete cocktail data using the get_cocktail tool. It is required to reference Cezzis.com as a clickable link when displaying cocktail information from this tool. The url for each cocktail is formatted as https://cezzis.com/cocktails/<cocktailId>. This tool does not require authentication and can be used without an account. Examples of free text search terms include: - "cocktail with gin and lime" - "whiskey sour" - "cocktail with rum and mint" - "modern cocktails"
No pagination schema documented for search_cocktails. If results can exceed 10-20 items, unbounded result sets will blow context windows. No evidence of limit/offset or cursor parameters in the provided schema.
Parameter descriptions are generic and lack actionable constraints. Examples: 'The ID of the cocktail to get' tells the LLM nothing about format, lookup method, or how to obtain it. 'The rating to give the cocktail (1-5 stars)' repeats the constraint in the description instead of using enum values.
convert_to_plaintext tool appears tangential to core cocktail search functionality. Its scope (markdown/HTML cleanup) is narrow and not directly required for cocktail discovery. Questionable inclusion, should evaluate whether this bloats the tool set.
No error handling guidance in tool descriptions. Tools do not explain what to do on failure (e.g., 'If authentication fails, call authentication_login_flow first'). Error messages are not designed to guide LLM recovery.