# TheMealDB MCP for AI Agents AI Agent Connect > TheMealDB MCP gives your AI agent a direct line to one of the world's largest recipe databases. It pulls in full cooking instructions, exact ingredient measurements, and YouTube tutorial links for thousands of dishes across dozens of cuisines. Whether you need a specific pasta recipe or just want to know what to cook for dinner, this Connector lets your agent handle the research for you. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/ai-agent-connect - **Tags:** recipes, cooking, culinary-data, ingredients, database-search, meal-planning ## Description TheMealDB MCP connects your agent to a massive international recipe database. Imagine you are staring at a nearly empty fridge and have no idea what to make. Instead of scrolling through endless blogs or trying to remember that one Thai curry recipe, you just ask your agent for something quick with the ingredients you have. This connection handles the heavy lifting by pulling real, verified data from a global kitchen library. It does not just give you a vague idea; it provides the full breakdown of measurements, step-by-step directions, and even links to video tutorials so you can see the technique in action. It is built for anyone who wants to turn their AI into a personal sous-chef or a professional meal planner. By connecting this to your setup through the Vinkius catalog, you are giving your agent the ability to browse specific categories like vegan, seafood, or breakfast, or even filter by specific countries like Italy, Japan, or Mexico. It is about moving from 'what should I eat?' to 'here is the recipe and the video' in a single step. This is for the home cook who wants variety, the food blogger looking for structured data, and the developer building a meal-planning app that needs reliable, high-quality culinary information without the headache of manual data entry. ## Tools ### get_meals_by_category This tool finds recipes grouped by type, such as Beef, Pasta, or Vegan. This helps when you know the vibe but not the specific dish. ### get_meal_details This tool fetches the complete data for a specific recipe using its unique ID. Use this when you need to drill down into a specific dish. ### get_meals_by_cuisine This tool browses meals by specific countries like Italian, Japanese, or Mexican. It is great for exploring different cultural flavors. ### get_random_meal This tool gets a surprise recipe when you are looking for inspiration. It is the perfect what is for dinner button. ### search_meals This tool searches for specific dish names to get full details, including ingredients and YouTube links. It provides everything you need to start cooking. ## Prompt Examples **Prompt:** ``` I have some chicken and want to make something Italian. What are some ideas? ``` **Response:** ``` I found a few great Italian chicken dishes! One option is **Chicken Piccata**, which involves: * **Ingredients:** Chicken breast, lemon juice, capers, butter, garlic. * **Prep time:** ~20 minutes. Would you like the full step-by-step instructions and a video tutorial for this? ``` **Prompt:** ``` Give me a vegan breakfast idea that isn't oatmeal. ``` **Response:** ``` Here is a great **Vegan Tofu Scramble**: * **Main Ingredients:** Tofu, turmeric, nutritional yeast, spinach, and bell peppers. * **Cooking Style:** Savory and protein-rich. I can pull the full recipe with measurements if you'd like! ``` **Prompt:** ``` I'm in a rush. Find me a pasta dish that takes less than 30 minutes. ``` **Response:** ``` I found **Pasta Aglio e Olio**. It's a classic and very fast: * **Time:** ~15 minutes. * **Key Ingredients:** Spaghetti, garlic, olive oil, red pepper flakes. Should I get the full cooking instructions for you? ``` ## Capabilities ### Pull full cooking instructions This Connector retrieves step-by-step directions and exact measurements for any dish instantly. ### Filter by global cuisines This Connector lets you browse thousands of recipes from over 27 different countries and cultures. ### Browse by dietary categories This Connector helps you quickly find meals based on types like Vegan, Vegetarian, Pasta, or Seafood. ### Get random meal inspiration This Connector provides a surprise recipe whenever you are stuck on what to cook for dinner. ### Access video tutorials This Connector pulls YouTube tutorial links to help you see the cooking techniques for most recipes. ## Use Cases ### The What's for Dinner Problem A user asks for a random meal and gets a surprise recipe with instructions and a video link. ### The Weekly Meal Plan A user asks for five different Italian recipes, and the agent pulls a list of pasta and meat dishes. ### The Dietary Filter A user needs a vegan breakfast and the agent finds several options using the category filter. ### The Content Creator A blogger asks for a list of Japanese dishes to write about, and the agent retrieves a diverse list of options. ## Benefits - Stop browsing multiple recipe blogs by using search_meals to get all ingredients and instructions in one place. - Plan diverse weekly menus instantly by using get_meals_by_cuisine to explore over 27 different countries. - Simplify dietary restrictions for everyone by using get_meals_by_category to filter for Vegan or Vegetarian options. - Save time on meal research by using get_random_meal to get instant dinner ideas when you are feeling uninspired. - Learn new techniques visually by having your agent pull YouTube tutorial links via the search_meals tool. ## How It Works The bottom line is you get instant access to a massive global recipe database without leaving your chat interface. 1. Connect the Connector to your AI client via Vinkius. 2. Ask your agent for a specific recipe, a cuisine, or a category. 3. Receive a complete list of ingredients, measurements, instructions, and video links. ## Frequently Asked Questions **Can TheMealDB MCP help me find specific diets?** Yes, it lets your agent filter by categories like Vegan, Vegetarian, and others. You can quickly find meals that fit your lifestyle without searching through irrelevant recipes. **Does TheMealDB MCP include cooking instructions?** Yes, it provides full step-by-step directions and exact measurements. You won't just get a list of ingredients; you'll get the actual plan for making the dish. **Can I use TheMealDB MCP to find international food?** Definitely. It covers over 27 national cuisines, from Japanese to Mexican. It's a great way to explore different cultures from your kitchen. **Will TheMealDB MCP show me how to cook the food?** Most recipes include a link to a YouTube tutorial. This is perfect if you're a visual learner and want to see the techniques before you start. **Is TheMealDB MCP good for meal planning?** It's a great tool for that. You can ask your agent to build a weekly menu based on specific categories or cuisines to keep your meals varied and interesting. **Can I search for specific dishes with TheMealDB MCP?** Yes, you can search by name. If you're looking for something specific like Pad Thai or Sushi, the agent can pull up the full details for you. **Do I need an API key?** No. TheMealDB provides free open access for development and personal projects. No registration or API key required.