# TheMealDB MCP for AI Agents AI Agent Connect > TheMealDB MCP gives your AI agent access to a massive global library of recipes, ingredients, and cooking instructions. It lets you search for meals by name, category, or region, and pull up specific cooking steps and measurements instantly. It's the quickest way to turn your AI into a culinary expert that knows exactly what to cook based on what's in your fridge. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_dhRtKcxtyaCQHzizhcQD8PboSErXP3PYFbLIO6nR/ai-agent-connect - **Tags:** recipes, cooking, culinary-database, meal-planning, ingredients ## Description Imagine you're staring at a random assortment of vegetables in your fridge and have no idea what to make for dinner. Instead of browsing dozens of tabs or scrolling through endless blog posts, you can just tell your AI agent what you have on hand. This Connector connects that agent to a deep well of culinary data, allowing it to act like a personal sous-chef. It can pull up specific recipes from across the globe, tell you exactly how much of each ingredient you need, and provide step-by-step instructions for any skill level. If you're building a food app or creating content for a cooking blog, you can use it to pull structured data for hundreds of different dishes without having to manually scrape websites. Vinkius makes it easy to plug this into your existing workflow so you can stop hunting for recipes and start actually cooking. It handles the heavy lifting of data retrieval, whether you're looking for a specific Italian pasta or just want a random suggestion for a vegan breakfast. You get the ability to browse by category, explore regional cuisines, or search for specific meal names without the usual friction of navigating a complex website. It's about moving from 'what do I do now' to 'here is the plan' in a single prompt. ## Tools ### filter_by_ingredient Finds dishes based on your main ingredients. You can use this to see what you can cook with what's in your pantry. ### list_meals_by_first_letter Lists all meals starting with a specific letter of the alphabet. This is a simple way to browse the database. ### filter_by_area Filters meals by specific geographic regions like Canada or Mexico. This helps you find authentic dishes from around the world. ### get_meal_by_id Fetches every detail for a specific meal using its unique ID. Use this when you have a specific recipe in mind and need the full details. ### get_random_meal Grabs one random recipe for when you just need a new idea. It's perfect for breaking out of a cooking rut. ### get_random_meals_selection Pulls a batch of 10 random meals for broader inspiration. This gives you a wider variety of ideas in one go. ### list_all_categories Shows every meal category with a brief description. It helps you see the full scope of the database. ### list_areas Provides a list of all browseable countries and regions. Use this to explore different global cuisines. ### list_categories Lists simple categories like Beef, Chicken, or Dessert. This gives you a quick overview of common meal types. ### list_ingredients Shows a list of all available ingredients in the database. It helps you see the variety of components available. ### search_meals_by_name Searches for recipes using full or partial names. It's the fastest way to find a specific dish you're looking for. ### filter_by_category Lets you find meals grouped by type, such as Seafood or Vegan. It makes it easy to browse specific food groups. ### get_latest_meals Pulls the most recent additions to the recipe database. This is great for seeing what's new in the culinary world. ## Prompt Examples **Prompt:** ``` I have some leftover steak and peppers. What can I make? ``` **Response:** ``` I found a few options for steak and peppers. Here are three you might like: - **Steak Fajitas**: A classic Mexican dish with peppers and onions. - **Pepper Steak**: A quick stir-fry style meal. - **Steak and Peppers**: A simple roasted dish. Would you like the full instructions for one of these? ``` **Prompt:** ``` Give me a list of 5 Italian dishes. ``` **Response:** ``` Here are 5 Italian dishes from the database: - **Spaghetti Carbonara** - **Lasagna** - **Risotto** - **Fettuccine Alfredo** - **Pizza Marinara** I can pull up the full ingredients and steps for any of these! ``` **Prompt:** ``` I want to cook something vegan for breakfast. ``` **Response:** ``` I found several vegan breakfast options for you: - **Tofu Scramble** - **Oatmeal with Berries** - **Vegan Pancakes** - **Avocado Toast** - **Chia Seed Pudding** Let me know if you'd like the recipe for any of these! ``` ## Capabilities ### Search for recipes by name Find specific dishes using full or partial names in one go. ### Filter meals by region Browse authentic dishes from specific countries or geographic areas. ### Identify dishes by ingredients See what you can cook based on the main components you have. ### Get full cooking instructions Retrieve precise measurements and step-by-step directions for any meal. ### Get random meal ideas Get a single random recipe or a batch of ten for quick inspiration. ### Browse all meal categories Explore the full range of meal types from seafood to vegan options. ## Use Cases ### Dinner planning with leftovers A user asks for a Mexican dish with chicken, and the agent finds several options using filter_by_ingredient. ### Recipe research for blogs A blogger needs a list of vegan starters and gets a structured list of categories to organize their content. ### Populating a food app A developer wants to populate a random meal button and uses get_random_meal to fetch data for the UI. ### Pantry clearing A user lists three ingredients and asks for a recipe, getting a specific meal with instructions and measurements. ## Benefits - Stop manual searching: Use search_meals_by_name to find exactly what you want without leaving your chat. - Plan by region: Use list_areas and filter_by_area to explore authentic international cuisines easily. - Cook with what you have: Use list_ingredients to see what's possible with your current pantry items. - Get instant variety: Use get_random_meal to break out of your cooking routine with a new idea. - Scale content creation: Use list_all_categories to quickly gather data for food blogs or apps. ## How It Works The bottom line is that you get instant access to a global recipe database directly inside your AI chat. 1. Subscribe to the Connector and grab your API key. 2. Paste your key into your AI client's configuration. 3. Ask for recipes or meal ideas to see the results. ## Frequently Asked Questions **Can TheMealDB MCP help me plan my weekly meals?** Yes, it can. You can ask your agent to find recipes based on specific regions, categories, or ingredients to help you build a structured weekly menu. **How does TheMealDB MCP find recipes for specific ingredients?** It searches the database for dishes where your chosen items are the main components, providing you with a list of options you can cook right now. **Can I use TheMealDB MCP to find international recipes?** Absolutely. You can browse by specific areas like Italy, Mexico, or Canada to find authentic dishes from different parts of the world. **Is TheMealDB MCP good for food bloggers?** It's a great resource for content creators. You can quickly pull structured data for various meal categories to gather inspiration or data for your blog. **How do I get random meal ideas with TheMealDB MCP?** You can simply ask your agent for a random meal suggestion. It will pull a single recipe or a selection of ten to give you some new ideas. **Can TheMealDB MCP provide full cooking instructions?** Yes, it provides complete details including precise measurements and step-by-step instructions for the recipes it finds. **How do I get the full cooking instructions for a specific meal?** Use the `get_meal_by_id` tool with the unique Meal ID. The agent will return the full recipe, including step-by-step instructions and a complete list of ingredients with measurements. **Can I search for recipes based on what I have in my fridge?** Yes! You can use the `filter_by_ingredient` tool to find meals that feature a specific main ingredient. For Premium V2 users, you can even provide a comma-separated list of multiple ingredients. **What is the difference between the free and premium API access?** The free tier (API key '1') allows standard searching and filtering. Premium V2 access enables advanced tools like `get_latest_meals`, `get_random_meals_selection` (10 at once), and multi-ingredient filtering.