# TheMealDB MCP for AI Agents AI Agent Connect > TheMealDB connects your AI client to a massive database of global recipes and culinary data. It allows you to search for specific dishes, filter by cuisine or ingredients, and discover new meals from around the world. Whether you need a full recipe with step-by-step instructions or just a quick random meal idea for dinner, this Connector makes it happen instantly. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_tCC4deQfCpXtEFPQwzeuEnQIGh8ZgwzPFDOG8bNo/ai-agent-connect - **Tags:** recipes, cooking, culinary-arts, meal-planning, database-search, global-cuisine ## Description TheMealDB connects your AI client to a massive database of global recipes and culinary data. Instead of scrolling through endless blog posts or copy-pasting ingredients into a notes app, you can just ask your agent to find a specific dish or suggest a dinner idea based on what's in your fridge. If you're trying to figure out what to cook with chicken or need a list of authentic Italian meals, this Connector handles the heavy lifting. It pulls in full recipes, including step-by-step instructions and ingredient lists, so you can get straight to the cooking. You can also browse by cuisine, category, or even just get a random suggestion when you're stuck. Since Vinkius hosts this and many other tools, it's easy to plug into your existing workflow without worrying about managing individual API keys. It makes finding your next meal feel like having a personal chef who knows every recipe in the world. You can go from 'I'm bored of my usual routine' to having a full list of Moroccan tagines or Japanese ramen recipes in seconds. It takes the guesswork out of meal planning and lets you explore international flavors without the friction of manual searching. ## Tools ### filter_by_ingredient Find meals that feature a specific main ingredient. This helps when you're trying to use up what's left in your pantry. ### get_random_meal Get a completely random meal suggestion. Use this when you have zero ideas and just want to cook something new. ### filter_by_area Filter recipes by a specific geographic region. Find authentic dishes from Italy, Mexico, or India instantly. ### filter_by_category Filter meals by a specific food type. Quickly find all the seafood or vegetarian options in the database. ### list_ingredients Browse every ingredient available in the database. Use this to see the full scope of what you can cook. ### list_areas See a full list of all available cuisine areas. This is great for exploring different global flavors. ### list_categories Get a list of all meal categories like Beef, Chicken, or Dessert. Use this to narrow down your search. ### lookup_meal Get the complete details for a specific meal using its ID. This retrieves the full recipe and instructions. ### search_by_letter Find meals starting with a specific letter. This is a quick way to browse the database alphabetically. ### search_meals Search for meals by name and get up to 100 results. Use this for broad searches when you have a general idea of what you want. ## Prompt Examples **Prompt:** ``` I have some chicken and I want to cook something spicy. What are some options? ``` **Response:** ``` I found a few spicy chicken recipes for you: | Dish Name | Cuisine | Key Ingredients | | :--- | :--- | :--- | | **Jerk Chicken** | Jamaican | Jerk seasoning, chicken, peppers | | **Buffalo Chicken Dip** | American | Buffalo sauce, chicken, cheese | | **Spicy Kung Pao Chicken** | Chinese | Peanuts, Sichuan peppers, chicken | Would you like the full step-by-step instructions for one of these? ``` **Prompt:** ``` Give me a random dinner idea from Italian cuisine. ``` **Response:** ``` Here is a random Italian suggestion for you: **Osso Buco alla Milanese** * **Category:** Beef * **Description:** A classic braised veal shank dish. * **Serves:** 4 people Would you like me to pull up the full recipe and ingredient list for this? ``` **Prompt:** ``` What are some different categories of meals I can cook? ``` **Response:** ``` The database includes a wide variety of meal categories. Here are the main ones you can browse: * **Beef** * **Chicken** * **Seafood** * **Dessert** * **Pasta** * **Vegetarian** Let me know if you'd like to see the specific meals available in any of these categories! ``` ## Capabilities ### Find recipes by name Search the database for specific dishes and get back a list of results with basic info. ### Filter by cuisine area Narrow down your search to specific regions like Italian, Mexican, or Indian. ### Browse by food category Explore meals grouped by types like Beef, Chicken, Seafood, or Dessert. ### Search by main ingredient See what you can cook based on a primary ingredient you have on hand. ### Get random meal ideas Get a completely random meal suggestion to break through dinner decision fatigue. ### Retrieve full recipe details Get complete instructions and ingredient lists for any specific meal in the database. ## Use Cases ### Cooking with leftovers You have chicken and peppers. You ask your agent what you can make, and it uses filter_by_ingredient to find three matching recipes. ### Planning a themed dinner You want to host an Italian night. You ask your agent to find 5 authentic dishes, and it uses filter_by_area to pull the best options. ### Finding a random dessert You're craving something sweet but don't know what. Your agent uses get_random_meal to suggest a specific dessert with full instructions. ### Broad culinary research You're looking for variety. You ask your agent to list all meal categories, and it uses list_categories to show you every option. ## Benefits - Stop manual searching. Use search_meals to find exactly what you want without clicking through dozens of recipe blogs. - Better meal planning. Use filter_by_area and filter_by_category to build balanced, diverse weekly menus in seconds. - Cook with what you have. Use filter_by_ingredient to see recipes based on the specific items you already have in your pantry. - Explore new flavors. Use list_areas to discover authentic cuisines from around the world and expand your cooking skills. - End decision fatigue. Use get_random_meal when you can't decide what to eat and need a fresh, unexpected dinner idea. - Get full details instantly. Use lookup_meal to grab complete instructions and ingredients without hunting for a 'jump to recipe' button. ## How It Works The bottom line is you get instant access to a global recipe database without the manual searching. 1. Subscribe to the TheMealDB MCP on the Vinkius marketplace. 2. Connect the Connector to your AI client like Claude, Cursor, or Windsurf. 3. Ask your agent to find recipes, browse cuisines, or suggest a random meal. ## Frequently Asked Questions **Can TheMealDB MCP help me find recipes based on what I have in my fridge?** Yes, it can. You can ask your agent to find meals based on a specific main ingredient, like 'what can I make with salmon?' **Does TheMealDB MCP have recipes from different countries?** Yes, it covers a wide range of global cuisines, including Italian, Indian, Mexican, and many more. **Can I get a random meal idea with TheMealDB MCP?** Absolutely. You can ask for a random meal suggestion whenever you're feeling stuck on what to cook for dinner. **Is it hard to set up TheMealDB MCP?** No, it's very easy. Once you subscribe on Vinkius and connect it to your AI client, you can start searching immediately. **Can I use TheMealDB MCP to find specific meal types like desserts?** Yes, you can browse by category to find specific types of meals, including desserts, seafood, and more. **What happens when I ask for a recipe with TheMealDB MCP?** Your agent will pull the full details for that meal, including a complete list of ingredients and step-by-step cooking instructions. **Do I need an API key to use TheMealDB?** No! TheMealDB is completely free and open. No API key is required to search and retrieve recipes. **Can I get full recipe details with ingredients and instructions?** Yes! Use the `lookup_meal` tool with a meal ID to retrieve the full recipe including all ingredients with measurements, category, area, and detailed instructions. **How do I find recipes by ingredient?** Use the `filter_by_ingredient` tool with the ingredient name. It returns all meals that have that ingredient as their main component.