# Spoonacular MCP for AI Agents AI Agent Connect > Spoonacular connects your agent to a massive database of recipes and nutritional data. It lets you search by diet, find meals based on what's in your fridge, and get full calorie breakdowns. It's the go-to for anyone building food-related tools or managing complex meal plans. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_qc0ZVpLKXAuqB2Q5GsSUzhVeqpNYSW4UtidHsris/ai-agent-connect - **Tags:** recipe-search, meal-planning, nutritional-analysis, dietary-filters, food-intelligence, ingredient-data ## Description The Spoonacular MCP connects your agent to a massive database of recipes and food intelligence. It handles the tedious work of searching for dishes based on what's actually in your kitchen. If you're looking for a specific diet like keto or vegan, the Connector pulls those results instantly with full nutritional breakdowns. It's a huge part of why the Vinkius catalog is so effective for food-related projects; it gives your agent the kind of deep data that's usually buried in complex APIs. You get clear instructions, ingredient lists, and health stats in one go, making it way easier to plan your week or just figure out dinner tonight. Instead of jumping between different blogs to find a meal that fits your calorie goals, your agent does the heavy lifting. It can cross-reference your available ingredients with thousands of global cuisines to find the best possible match. Whether you're a fitness enthusiast tracking macros or a busy parent trying to clear out the pantry, this connection gives you a direct line to professional food data. You can ask for specific cooking times, filter out allergens, or get a random suggestion when you're feeling uninspired. It turns your agent into a personal chef that actually knows the nutritional facts of everything it suggests. ## Tools ### get_random_recipes Provides a random dish to help break out of a cooking rut. It's perfect for when you have no idea what to cook for dinner. ### get_recipe_details Pulls the full instructions, ingredients, and nutrition for a specific dish. You can use this to see exactly how to make a meal. ### find_recipes_by_ingredients Suggests meals based on a list of items you have on hand. It helps you clear out your pantry by finding matches for what you already own. ### search_recipes Filters the database by cuisine, diet, and specific nutritional limits. It makes it easy to find meals that fit strict health goals. ## Prompt Examples **Prompt:** ``` What can I make with eggs and avocado? ``` **Response:** ``` Based on what you have, here are some great options: | Dish | Prep Time | Highlights | | :--- | :--- | :---| | **Avocado Toast with Poached Eggs** | 10 mins | Uses both ingredients perfectly. | **Shakshuka with Avocado** | 20 mins | A spicy tomato base with your eggs. | **Egg & Avocado Salad** | 5 mins | Great for a quick lunch. Would you like the full instructions for any of these? ``` **Prompt:** ``` Find a low-carb dessert under 200 calories. ``` **Response:** ``` I found a few delicious options that fit your criteria: * **Baked Cinnamon Apples** (120 calories) - Vegan & Gluten-Free * **Berry Chia Pudding** (180 calories) - High fiber and low carb * **Almond Flour Brownies** (250 calories - *Note: Slightly over limit*) Let me know if you'd like the full recipe for the apples or the pudding! ``` **Prompt:** ``` Give me the nutrition for a chicken stir fry. ``` **Response:** ``` Here is the nutritional breakdown for a standard **Chicken Stir Fry** (per serving): * **Calories**: 350 kcal * **Protein**: 28g * **Fat**: 12g * **Carbs**: 15g Would you like to see the full ingredient list and cooking instructions for this? ``` ## Capabilities ### Find recipes by ingredients Tell your agent what you have in your fridge and get a list of meals that use those items. ### Search by diet and cuisine Filter for specific diets like keto, vegan, or paleo across various global cuisines. ### Get full nutritional breakdowns Access calories, protein, fat, and carb counts for any dish in the database. ### Pull random recipe ideas Get a surprise suggestion for dinner when you don't know what to cook. ### Filter by cooking time and calories Narrow down your search based on how much time you have and your daily calorie limits. ## Use Cases ### I have chicken and spinach, what can I make? The agent uses `find_recipes_by_ingredients` to show you the best matches for your current pantry. It looks at what you have and suggests 5-10 meals you can cook right now without a trip to the store. ### Plan a 7-day keto meal plan. The agent uses `search_recipes` to build a week of meals that fit your strict calorie and carb limits. It creates a structured plan that keeps you in ketosis while ensuring you have variety in your proteins and fats. ### Is this meal okay for a vegan? The agent uses `get_recipe_details` to confirm the ingredients and dietary compatibility of a specific dish. It checks for hidden animal products or non-vegan ingredients so you can eat with confidence. ### I'm bored of my usual dinner. The agent uses `get_random_recipes` to give you a surprise suggestion from a different cuisine. It's a quick way to get a new idea for tonight's meal without having to scroll through a long list of options. ## Benefits - Get precise calorie and macro counts for any dish using `get_recipe_details` to avoid manual math. This ensures you stay on track with your health goals without having to do any tedious calculations yourself. - Cut down on wasted groceries by using `find_recipes_by_ingredients` to see what you can cook now. It helps you identify meals that use what you already have, saving you money and reducing waste. - Stick to your health goals by using `search_recipes` to filter for keto, paleo, or whole30 diets. This allows your agent to find meals that perfectly match your lifestyle requirements instantly. - Break out of a cooking rut with `get_random_recipes` for instant meal ideas when you're stuck. It provides variety and inspiration when you're tired of the same old rotation of dishes. - Access a huge variety of global cuisines through the `search_recipes` tool without browsing dozens of sites. You can explore different cultures and flavors while keeping your dietary restrictions in mind. ## How It Works The bottom line is you get instant access to professional-grade food data without having to manually browse websites. 1. Connect your Spoonacular API key to the Connector. 2. Tell your agent what you need like a vegan pasta under 500 calories. 3. Get a list of recipes with full details and nutrition. ## Frequently Asked Questions **Can Spoonacular MCP help me find vegan recipes?** Yes, it can filter the entire database for vegan, vegetarian, and other specific diets. You just tell your agent what you're looking for and it pulls the best matches instantly. **How does Spoonacular MCP handle nutritional data?** It provides a full breakdown for every recipe, including calories, protein, fat, and carbs. This makes it easy to track your macros without doing any manual math. **Can I use Spoonacular MCP to plan my weekly meals?** Absolutely. You can ask your agent to find a week's worth of meals that fit your calorie goals and dietary preferences. It handles the search and organization for you. **Does Spoonacular MCP support specific diets like Keto?** Yes, it has built-in support for keto, paleo, whole30, and more. Your agent can filter any search to make sure the recipes fit your specific lifestyle. **How does Spoonacular MCP help with food waste?** You can tell your agent what ingredients you have left in your fridge. It uses the database to suggest recipes that use those specific items first. **What dietary filters are available?** Spoonacular supports: vegetarian, vegan, gluten-free, ketogenic, paleo, whole30, lacto-vegetarian, ovo-vegetarian, pescetarian, and primal diets. You can also filter by intolerances like dairy, egg, gluten, peanut, sesame, and soy. **Can I get full nutritional analysis for the recipes?** Yes, every recipe includes a comprehensive nutritional breakdown including calories, macronutrients, and micronutrients. **Is there a limit to the daily requests on the free tier?** Yes, the free tier allows up to 150 points (requests) per day.