# Spoonacular MCP for AI Agents AI Agent Connect > Spoonacular lets your AI agent pull real-world food data. You can search for recipes based on what's in your fridge, get exact nutritional breakdowns for specific dishes, or pull recipes directly from blog URLs. It turns your AI into a personal nutritionist and meal planner by connecting to a massive database of global cuisines and dietary preferences. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_JThQP0L3xcV8iDCwm4LAJIQrbWZXIAIi8oe6TmGj/ai-agent-connect - **Tags:** recipe-search, nutrition-analysis, meal-planning, food-intelligence, dietary-filters, ingredient-discovery ## Description Spoonacular connects the food API to your AI agent so you can handle meal planning and nutrition tracking without the manual research. Instead of asking your agent to guess how many calories are in a dish, it pulls the actual data from a massive database of global cuisines and dietary preferences. You can tell your agent what ingredients you have in your fridge, and it will find recipes that use those items first. If you find a recipe on a blog, you can just give your agent the URL to pull the instructions directly into your chat. This takes the guesswork out of healthy eating because you get real numbers for macros, vitamins, and minerals. It is a way to make your AI actually useful for your daily health goals. Because Vinkius makes it easy to manage these connections, you can get this set up in minutes and start planning your week of dinners without the usual hassle of opening dozens of different tabs. You can search for specific diets like keto or vegan, or look up the nutritional info for packaged grocery products you buy at the store. It turns your AI into a personal nutritionist that knows exactly what is in your food. You can even get a breakdown of the taste profile, like whether a dish is spicy or savory, to help you decide what to cook for dinner tonight. This moves your AI from a general chatbot to a specific tool for your kitchen. ## Tools ### extract_recipe Pull recipe details from a URL so you don't have to copy-paste from a blog. This saves you time when you find a great dish online. ### get_recipe_instructions Get step-by-step analyzed instructions for a specific dish. This makes it easy to follow a recipe without getting lost. ### search_grocery_products Search for packaged food products to see their nutritional info. This helps you see what is actually in your store-bought snacks. ### analyze_recipe Analyze a recipe to get extra enrichment data and insights. This provides a deeper look at the dish's components. ### recipes_by_ingredients Find meals based on what you have in your fridge right now. This helps you cook with what you already have and reduces food waste. ### recipes_by_nutrients Filter recipes to meet your specific calorie or macronutrient goals. This is great for staying on track with a health plan. ### get_recipe_info Get detailed information like cook time and serving size for a recipe. This helps you plan your schedule and portions. ### get_recipe_nutrition Get detailed nutrition data like calories, fats, and proteins for a meal. This gives you the exact numbers you need for your diet. ### get_recipe_taste Get a taste profile to see if a recipe is sweet, salty, or spicy. This helps you find dishes that match your flavor preferences. ### get_recipes_bulk Get information for multiple recipes at once to speed up your planning. This is perfect for creating a full week of meals. ### guess_dish_type Guess the dish type from a list of ingredients or a description. This helps you identify what you can make with random items. ### random_recipes Get random recipe suggestions to find some meal inspiration. This is a great way to break out of a cooking rut. ### search_recipes Search thousands of recipes using filters for cuisine, diet, and calories. This lets you find the perfect meal for any occasion. ## Prompt Examples **Prompt:** ``` I need a high-protein vegan dinner under 600 calories. What are my options? ``` **Response:** ``` I found 4 vegan, high-protein options under 600 calories for you: | Dish | Calories | Protein | | :--- | :--- | :--- | | **Tofu Stir Fry** | 420 | 28g | | **Lentil Curry** | 510 | 22g | | **Chickpea Tacos** | 480 | 20g | | **Tempeh Bowl** | 550 | 30g | Would you like the full instructions for any of these? ``` **Prompt:** ``` I have chicken, spinach, and heavy cream. What can I make for dinner? ``` **Response:** ``` Based on those ingredients, here are the best matches: * **Creamy Spinach Chicken** (Uses all 3 ingredients perfectly) * **Spinach & Chicken Pasta** (Requires: Pasta) * **Creamy Chicken Salad** (Requires: Celery, Onion) I can pull the full instructions for the **Creamy Spinach Chicken** if you'd like! ``` **Prompt:** ``` Can you give me the nutritional breakdown for a classic Beef Stir Fry? ``` **Response:** ``` Here is the nutritional breakdown for a standard Beef Stir Fry: * **Calories:** 450 kcal * **Protein:** 35g * **Fat:** 18g * **Carbs:** 30g * **Key Vitamins:** High in Vitamin B12 and Iron. Let me know if you want to see a different dish! ``` ## Capabilities ### Find recipes with specific ingredients Your agent can look at what you have in your pantry and suggest matching meals. ### Extract instructions from any URL Point your agent at a blog and it will pull the recipe steps for you. ### Get full nutritional breakdowns Get exact calorie, fat, and protein counts for any dish in the database. ### Filter meals by diet and calories Search for keto, vegan, or low-calorie options using specific filters. ### Identify dish types from descriptions The agent can guess what kind of meal a list of ingredients will make. ### Search for packaged grocery products Find nutritional information for store-bought items and snacks. ## Use Cases ### The 20-minute low-carb dinner A busy parent asks their agent for a quick, low-carb dinner. The agent uses `search_recipes` to find a 20-minute meal with specific dietary tags. ### The marathon runner's meal plan A runner needs a high-carb meal with exactly 50g of protein. The agent uses `recipes_by_nutrients` to find the perfect match. ### The 'what's in my fridge' cook Someone has chicken and spinach and wants to cook. The agent uses `recipes_by_ingredients` to suggest three meals they can make right now. ### The recipe blog harvester A user finds a complex recipe on a blog. They give the URL to their agent, which uses `extract_recipe` to pull the instructions into a clean list. ## Benefits - Stop manual searching: Use `search_recipes` to find meals that fit your specific diet and calorie limits instantly. - No more copy-pasting: Use `extract_recipe` to pull instructions from any blog URL directly into your chat. - Precise macro tracking: Get exact data with `get_recipe_nutrition` to stay on track with your fitness goals. - Creative meal ideas: Use `recipes_by_ingredients` to cook with what you already have, reducing food waste. - Flavor exploration: Use `get_recipe_taste` to discover new cuisines based on your preferred flavor profiles. - Grocery planning: Use `search_grocery_products` to find nutritional info for packaged goods you buy at the store. ## How It Works The bottom line is your AI gets a direct line to professional food and nutrition data. 1. Get your Spoonacular API key from their developer site. 2. Add the key to your Connector configuration in Vinkius. 3. Ask your AI client to find recipes, calculate macros, or plan your week. ## Frequently Asked Questions **Can the Spoonacular MCP help me find recipes based on my diet?** Yes, it filters by specific dietary tags like vegan, keto, or low-calorie. It helps you find meals that actually fit your lifestyle without the manual searching. **How does the Spoonacular MCP handle recipes from other websites?** It can pull instructions from a URL. This means you can find a recipe on any blog and have your agent grab the details for you automatically. **Can I use the Spoonacular MCP to track my daily calories?** It provides the exact nutritional data for thousands of dishes. You can use this information to build a daily meal plan that hits your specific calorie goals. **Does the Spoonacular MCP work for packaged foods too?** Yes, it can look up nutritional information for packaged grocery products. This is helpful for seeing the stats on store-bought snacks and meals. **Can the Spoonacular MCP find meals based on what's in my fridge?** Just tell your agent what ingredients you have on hand. It will cross-reference your items with a massive database to suggest recipes you can cook right now. **How do I get a Spoonacular API Key?** Visit [**Spoonacular API**](https://spoonacular.com/food-api), sign up for a free account, and copy your API key from the dashboard. Free tier includes 150 points/day. **Can I find recipes with ingredients I already have?** Yes! Use `recipes_by_ingredient` with a comma-separated list of ingredients. The API finds recipes maximizing the use of your available ingredients. **Can I extract recipes from websites?** Absolutely! Use the `extract_recipe` tool with any recipe URL. It automatically parses the webpage and extracts title, ingredients, instructions, and metadata.