Kitchen

Kitchen — connector documentation

• MCP endpoint: https://kitchen.connectorbay.com/mcp
• REST API: POST https://kitchen.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://kitchen.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://kitchen.connectorbay.com/health · Tool schemas: https://kitchen.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/kitchen · agent@connectorbay.com

What Kitchen is for

Cooking questions answered with real recipes rather than improvised ones: the recipe for a named dish with exact measures and ordered steps, something to cook from a cuisine or category, what can be made from the ingredients on hand, the same recipe doubled or halved with sensible fractions, a week of dinners that stays the same when re-read, how to mix a cocktail or a mocktail, what to use when an ingredient is missing, and what an unfamiliar ingredient is.

What it does

Recipe search by name (full recipes), by main ingredient, category (Vegetarian, Vegan, Seafood, Chicken, Beef, Lamb, Pork, Pasta, Dessert, Breakfast, Side, Starter, Goat) or cuisine, with an any-of fallback when a combination has no match. Full recipes with ingredients and measures, steps, tags, image, video and source, scaled by any factor with kitchen-fraction rounding. What-can-I-cook from up to four ingredients with all-matched or best-partial results. Deterministic weekly meal plans from a cuisine and/or category. Random recipe. Cocktails by name with measures, glass, IBA status and method; lists by base spirit or non-alcoholic; random pick. Substitutions for ~100 staples with ratios and caveats. Ingredient descriptions and photos with recipes that use them.

What it is not

Kitchen is not a nutrition calculator (see the Plate connector for barcodes and nutrition) and does not cover copyrighted cookbook recipes: its recipes are the community-contributed TheMealDB collection (a few hundred dishes, strongest in British, American, Italian, Asian and Middle Eastern food). The free database returns limited results for some ingredient and cuisine filters.

Tools

Recipes

recipe_search — Find recipes by name, main ingredient, category or cuisine (TheMealDB). Name searches return full recipes; ingredient/category/cuisine searches return a list to pick from (use recipe for the full one). Use for "recipe for X", "vegetarian Indian dishes", "what can I make with salmon". Args: query, ingredient, category, cuisine, max_results.

recipe — A full recipe: ingredients with measures (optionally scaled), numbered steps, category, cuisine, tags, image, video and source link. Use for "give me the full recipe", "double it", "halve the ingredients". Args: recipe_id, name, scale.

what_can_i_cook — Recipes that use ALL of the ingredients given (up to four), falling back to any-of when nothing matches all, with a note saying which. Use for "what can I make with chicken and spinach", "dinner from eggs and potatoes". Args: ingredients, max_results.

meal_plan — A meal plan — one dinner per day — drawn from a cuisine and/or category, the same plan for the same week so it can be re-read, with recipe ids to expand. Use for "plan my dinners this week", "seven vegetarian meals", "a week of Mexican food". Args: cuisine, category, days, week_of.

random_recipe — A random full recipe, optionally from a category — for "surprise me", "what should I cook tonight". Args: category.

recipe_lists — The categories and cuisines the recipe database understands, for building searches and meal plans.

Drinks

cocktail — Cocktails and mocktails (TheCocktailDB): by name with full ingredients, measures, glass, category, IBA status and method; by base ingredient or non-alcoholic as a list; or a random pick. Use for "how do I make a margarita", "gin cocktails", "a mocktail", "surprise me with a drink". Args: name, ingredient, non_alcoholic, random_pick, max_results.

Pantry

substitute — What to use instead of an ingredient — ranked substitutes with ratios and caveats for ~100 staples: dairy, eggs, flours and leavening, sugars and syrups, oils, sauces, herbs and spices (Indian and East Asian included), proteins, produce and thickeners. Use for "I'm out of buttermilk", "egg-free binder", "vegan substitute for paneer". Args: ingredient.

ingredient — What an ingredient is: a description from TheMealDB's ingredient index, its type and a photo, plus recipes that use it. Use for "what is asafoetida", "what does tahini taste like". Args: name.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/kitchen/support

Kitchen — Privacy Policy

Effective 23 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Kitchen is. Kitchen is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for recipes, meal plans, cocktails, ingredient substitutions and ingredient facts. You interact with your assistant; the assistant sends us only the dish, ingredient, cuisine or category needed for the lookup.

What we receive. The arguments of each tool call (a dish name, ingredient names, a cuisine or category, a scaling factor), the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Lookups are forwarded, not stored. Dish and ingredient names are passed to TheMealDB or TheCocktailDB and the answer is returned to your assistant; substitutions are answered from a table bundled with the server and never leave it. We do not keep a record of what you cook, infer dietary or religious preferences, or build a profile. Nothing you send is stored, logged in request bodies or used to train anything. Successful upstream answers are cached in memory for up to 24 hours, keyed by the query, to reduce load on the sources.

What we do not receive or store. We do not receive your conversation with the assistant, your name, contacts, accounts or credentials for any service. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. TheMealDB and TheCocktailDB (public API). Each receives the query and our server's IP address, never yours. Hosting: Vercel (United States regions).

Legal bases and your rights. For users in California, the EU/UK and elsewhere, our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Kitchen is a general-audience service operated by the adult using the assistant.

Changes. We will post changes here with a new effective date.

Kitchen — Terms of Service

Effective 23 September 2026. These terms govern use of the Kitchen connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Kitchen returns recipes, meal plans, cocktail recipes, ingredient substitutions and ingredient facts from public recipe databases and a bundled substitutions table. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Recipes are community content. Recipes and images come from TheMealDB and TheCocktailDB, contributed by their communities, under those sites' terms. Quantities, times and temperatures are as contributed; use judgement, especially for food safety (meat, eggs, canning) and allergens. Scaled measures are arithmetic on the stated amounts.
3. Not dietary or medical advice. Substitutions are general cooking guidance and do not guarantee allergen safety; check labels for allergies and intolerances. Cocktail recipes are for adults of legal drinking age.
4. Acceptable use. Do not use the Service to bulk-download the recipe databases or to circumvent rate limits. Automated use within the published limits is welcome.
5. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
6. Data. Our Privacy Policy describes what we process. In short: your query is forwarded and nothing is stored.
7. Attribution. TheMealDB; TheCocktailDB.
8. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
9. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service. Our total liability is limited to US $100.
10. Governing law. California law; venue in San Mateo County, California.
11. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/kitchen

Kitchen support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://kitchen.connectorbay.com/mcp
• REST API: https://kitchen.connectorbay.com/openapi.json
• Live status: https://kitchen.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Kitchen never asks for them.