# Spoonacular MCP for AI Agents AI Agent Connect > Spoonacular. Search recipes, find meals by ingredients, and analyze nutritional data directly from your AI agent using the Spoonacular food database. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_yjI5yn918FuEkcEwpHO16nHg2ZrbWaXQIStlrTZ9/ai-agent-connect - **Tags:** recipes, cooking, nutrition, meal-planning, ingredients ## Description You can turn your AI into a personal sous-chef that actually knows what is in your fridge. Instead of scrolling through blogs filled with ads, you just tell your agent what you have on hand and it pulls up real recipes. It handles the heavy lifting of filtering for specific diets like keto or gluten-free, and it can even pull nutritional data to make sure you are hitting your protein goals. If you find a recipe on a messy blog, you can just give your agent the link and it will grab the structured steps for you. It makes planning a week of healthy meals feel like a conversation rather than a chore. Because it is hosted on the Vinkius catalog, you get a reliable connection to a massive database of ingredients and meals without having to manage the underlying API yourself. It is about getting back to the cooking while the agent handles the data hunting. ## Tools ### search_recipes This finds thousands of meals based on your specific filters. You can search by cuisine, diet, or intolerance. ### find_recipes_by_ingredients This shows you what you can cook using only what you have in your kitchen. It helps you use up your groceries. ### find_recipes_by_nutrients This filters meals to match your daily protein, carb, or calorie targets. It is perfect for fitness tracking. ### generate_meal_plan This creates a full schedule of meals for your upcoming week. It takes the guesswork out of what to eat next. ### get_ingredient_information This provides details about specific food items and their properties. You can learn more about any ingredient. ### get_ingredient_substitutes This tells you what to use when you are missing a specific ingredient. It helps you keep cooking when the store is closed. ### search_grocery_products This searches for general grocery items in the database. You can find products based on your needs. ### compute_ingredient_amount This calculates how much of an item you need to hit a calorie or protein goal. It is great for precise dieting. ### extract_recipe This pulls structured cooking instructions from a website URL. It removes the ads and fluff from blog posts. ### add_to_meal_plan This tool adds a specific dish to your scheduled eating plan. It helps you keep track of what you want to eat each day. ### autocomplete_ingredient_search This helps you finish typing ingredient names quickly. It makes searching for items much faster. ### autocomplete_recipe_search This suggests recipe titles as you start typing a query. It helps you find the right dish faster. ### get_meal_plan_week This fetches your pre-made meal plan for a specific week. Use it to see your schedule at a glance. ### get_menu_item_information This gives you details on specific items from a restaurant menu. It is useful for checking restaurant options. ### get_product_information This provides data on specific grocery products. You can get details on items you find in the store. ### get_random_recipes This gives you a random meal idea when you can't decide what to eat. It is great for breaking out of a cooking rut. ### get_recipe_information This pulls the full details and instructions for a specific dish. It gives you everything you need to start cooking. ### get_shopping_list This retrieves the list of items you need to buy for your plan. It makes your next trip to the store much easier. ### get_similar_recipes This finds other dishes that are like the one you are currently looking at. It helps you find variety. ### search_ingredients This lets you look up specific ingredients in the database. It is a quick way to find information on any food item. ### search_menu_items This searches for specific dishes across various restaurant menus. You can compare options before you go out. ### search_products_by_upc This identifies a grocery product using its unique barcode. It is helpful for looking up specific store items. ## Prompt Examples **Prompt:** ``` I have chicken, spinach, and heavy cream. What can I make for dinner? ``` **Response:** ``` Based on what you have, here is a great option: **Creamy Spinach Chicken** * **Prep time:** 10 mins * **Cook time:** 20 mins * **Key Ingredients:** Chicken, spinach, heavy cream Would you like me to get the full instructions for this dish? ``` **Prompt:** ``` Find me a vegan dinner under 600 calories with at least 20g of protein. ``` **Response:** ``` I found a few options that fit those requirements: | Dish | Calories | Protein | | :--- | :--- | :--- | | **Lentil Curry** | 450 kcal | 22g | | **Tofu Stir Fry** | 520 kcal | 25g | | **Chickpea Salad** | 380 kcal | 18g | Would you like the full details for the Tofu Stir Fry? ``` **Prompt:** ``` I found this recipe online: https://example.com/best-pasta. Can you turn this into a shopping list? ``` **Response:** ``` I've extracted the recipe from that page. Here is your shopping list: * **Produce:** * Garlic (3 cloves) * Fresh Basil * **Dairy/Pantry:** * Heavy Cream * Parmesan Cheese* **Proteins:** * Chicken Breast Would you like me to add these to your meal plan? ``` ## Capabilities ### Search recipes by diet Find meals that fit specific health requirements like vegan or gluten-free. ### Cook with available ingredients Get recipe ideas based only on what you already have in your kitchen. ### Check nutritional facts See exact calorie, protein, and carb counts for any dish. ### Extract recipes from links Convert a blog URL into a clean, structured list of instructions. ### Create weekly meal plans Generate a full schedule of meals for your upcoming week. ### Find ingredient substitutes Get suggestions for what to use when you are missing a specific item. ## Use Cases ### Pantry clearout You have salmon, lemon, and spinach. You ask your agent what to cook, and it uses `find_recipes_by_ingredients` to suggest a sheet pan meal. ### Macro tracking You need a high-protein dinner under 500 calories. Your agent uses `find_recipes_by_nutrients` to find a turkey chili that fits your goals. ### Recipe scraping You find a great recipe on a blog but hate the long intro. You give the link to your agent, which uses `extract_recipe` to pull just the steps. ### Weekly meal prep You want to eat healthy all week. Your agent uses `generate_meal_plan` to create a schedule and then `get_shopping_list` to tell you what to buy. ## Benefits - Stop hunting through blogs. Use `extract_recipe` to get clean instructions instantly without the ads. - Cook with what you have. `find_recipes_by_ingredients` saves you from making extra grocery trips. - Hit your fitness goals. Use `find_recipes_by_nutrients` to see exact protein and calorie counts for every meal. - Simplify your week. `generate_meal_plan` handles the what to eat next decision for you automatically. - Handle dietary restrictions easily. Filter for vegan or gluten-free options with `search_recipes` to stay safe. - Never run out of ideas. Use `get_random_recipes` to find a new dish to cook when you are feeling uninspired. ## How It Works The bottom line is you get a direct line to a massive food database without the manual searching. 1. Subscribe to the Spoonacular MCP on Vinkius. 2. Add your Spoonacular API key to the configuration. 3. Ask your agent for recipes, nutrition info, or meal plans. ## Frequently Asked Questions **Does Spoonacular MCP help with specific diets like keto or vegan?** Yes, it allows your agent to filter the entire database for specific dietary needs. You can ask for recipes that are vegan, gluten-free, keto, or low-carb, and it will only show you relevant options. **Can I use Spoonacular MCP to find substitutes for missing ingredients?** Yes, it includes a tool to find substitutes. If you're in the middle of cooking and realize you're out of an item, just ask your agent for an alternative. **How does Spoonacular MCP handle nutritional information?** It pulls real data for calories, protein, carbs, and fats. This means you can get accurate macro information for any dish in the database to help with your fitness goals. **Can Spoonacular MCP turn a website into a structured recipe?** Yes, it can extract data from a URL. It pulls the structured steps and ingredient lists from a blog post so you don't have to copy and paste manually. **Can I use Spoonacular MCP to plan my whole week of meals?** Absolutely. It can generate a full meal plan for your week and even create a shopping list based on those meals to make your grocery trips easier. **Is Spoonacular MCP good for reducing food waste?** Yes, because it can find recipes based specifically on the ingredients you already have in your fridge. This helps you use up your groceries before they go bad. **Can I find recipes based on specific ingredients I already have?** Yes! Use the `find_recipes_by_ingredients` tool. Just list your ingredients, and the agent will return recipes that maximize the use of what you have while minimizing missing items. **How do I get the full nutritional breakdown of a specific recipe?** You can use the `get_recipe_information` tool with the recipe ID and set `includeNutrition` to true. This provides calories, macros, and vitamins for the dish. **Can the AI extract a recipe from a website link?** Absolutely. Use the `extract_recipe` tool and provide the URL. The agent will parse the website and return a structured recipe with ingredients and instructions.