@pipeworx/spoonacular
Connect: https://gateway.pipeworx.io/spoonacular/mcp · Install: one-click buttons
Tools: 18
Spoonacular Food API MCP — recipes, nutrition, ingredients, meal planning. Free 150 req/day.
Auth
- Platform:
PLATFORM_SPOONACULAR_KEY. BYO:?_apiKey=….
Tools (recipes)
recipe_search(query?, cuisine?, excludeCuisine?, diet?, intolerances?, includeIngredients?, excludeIngredients?, type?, instructionsRequired?, fillIngredients?, addRecipeInformation?, addRecipeNutrition?, maxReadyTime?, sort?, sortDirection?, offset?, number?, ...)— complex searchrecipe_information(id, includeNutrition?)— recipe detailrecipe_random(tags?, number?)— random recipesrecipe_summary(id)— short summaryrecipe_similar(id, number?)— similar recipesrecipe_nutrition(id)— nutrition breakdownrecipe_ingredients(id)— ingredient listrecipe_taste(id, normalize?)— taste widgetrecipe_price_breakdown(id)— cost breakdown
Tools (ingredients/products)
ingredient_search(query, number?, sort?, intolerances?)— ingredient searchingredient_information(id, amount?, unit?)— ingredient detailproduct_search(query, minCalories?, maxCalories?, number?, offset?)— branded product searchproduct_information(id)— product detail
Tools (meal planning + utils)
meal_plan_generate(timeFrame?, targetCalories?, diet?, exclude?)— generated meal planmeal_plan_week(targetCalories?, diet?, exclude?)— 7-day planwine_pairing(food, maxPrice?)— wine pairingwine_recommendation(wine, minRating?, price?, number?)— wine recommendationconvert_amount(ingredientName, sourceAmount, sourceUnit, targetUnit)— unit conversion
Data source
https://api.spoonacular.com
Tools
- recipe_search — Search Spoonacular recipes with complex filters passed as query params (query keyword, cuisine, diet, intolerances, includeIngredients, excludeIngredients, maxReadyTime, sort, etc.). Returns recipe id
- recipe_information — Fetch full details for a Spoonacular recipe by numeric
id. Returns title, ingredients, instructions, cuisines, diets, ready time, servings, source URL, and optionally full nutrition data if `include - recipe_random — Fetch one or more random Spoonacular recipes, optionally filtered by comma-separated
tags(e.g. “vegetarian,dessert”) andnumberof results. Returns full recipe details including ingredients and i - recipe_summary — Fetch a short human-readable summary paragraph for a Spoonacular recipe by
id. Returns the recipe title and a 1-2 sentence description of ingredients and preparation style. - recipe_similar — Fetch Spoonacular recipes similar to a given recipe by
id. Returns up tonumbersimilar recipes with title, image URL, ready time, and servings. - recipe_nutrition — Fetch the full nutrition breakdown for a Spoonacular recipe by
id. Returns calories, macros (protein/fat/carbs), and detailed per-nutrient values including percent daily values. - recipe_ingredients — Fetch the ingredient list for a Spoonacular recipe by
id. Returns each ingredient’s name, amount, unit, image URL, and estimated cost in US cents. - recipe_taste — Fetch taste profile scores for a Spoonacular recipe by
id. Returns numeric scores for sweetness, saltiness, sourness, bitterness, savoriness, fattiness, and spiciness. Optionally normalize scores 0– - recipe_price_breakdown — Fetch the estimated ingredient cost breakdown for a Spoonacular recipe by
id. Returns per-ingredient price in US cents and the total estimated cost per serving. - ingredient_search — Ingredient search.
- ingredient_information — Fetch details for a Spoonacular ingredient by numeric
id. Returns name, category, possible units, and nutrition data for the givenamountandunit. Useingredient_searchto get the id first. - product_search — Branded product search.
- product_information — Fetch details for a branded grocery product by Spoonacular numeric
id. Returns product title, UPC, brand, ingredients, nutrition facts, and image URL. - meal_plan_generate — Generate a Spoonacular meal plan for a given
timeFrame(“day” or “week”) matchingtargetCalories,diet(e.g. vegetarian/vegan/paleo), and comma-separatedexcludeingredients. Returns meals wit - meal_plan_week — Generate a Spoonacular 7-day meal plan matching
targetCalories,diet, and comma-separatedexcludeingredients. Returns meals per day with recipe ids, titles, images, and per-day nutrition totals - wine_pairing — Fetch wine pairing suggestions for a
fooddish or ingredient (e.g. “salmon”, “pasta primavera”) with optionalmaxPricefilter. Returns paired wine types and specific product recommendations with n - wine_recommendation — Fetch specific wine product recommendations for a wine type name (e.g. “merlot”, “chardonnay”) with optional
minRating,pricetarget, andnumberof results. Returns product name, price, average - convert_amount — Convert a cooking measurement amount for a specific ingredient between units using Spoonacular. Requires
ingredientName,sourceAmount,sourceUnit, andtargetUnit. Returns the converted amount
Tools
-
convert_amount— Convert a cooking measurement amount for a specific ingredient between units using Spoonacular. Requires `ingredientName`, `sourceAmount`, `sourceUnit`, and `targetUnit`. Returns the converted amount -
ingredient_information— Fetch details for a Spoonacular ingredient by numeric `id`. Returns name, category, possible units, and nutrition data for the given `amount` and `unit`. Use `ingredient_search` to get the id first. -
ingredient_search— Ingredient search. -
meal_plan_generate— Generate a Spoonacular meal plan for a given `timeFrame` ( day or week ) matching `targetCalories`, `diet` (e.g. vegetarian/vegan/paleo), and comma-separated `exclude` ingredients. Returns meals with -
meal_plan_week— Generate a Spoonacular 7-day meal plan matching `targetCalories`, `diet`, and comma-separated `exclude` ingredients. Returns meals per day with recipe ids, titles, images, and per-day nutrition totals -
product_information— Fetch details for a branded grocery product by Spoonacular numeric `id`. Returns product title, UPC, brand, ingredients, nutrition facts, and image URL. -
product_search— Branded product search. -
recipe_information— Fetch full details for a Spoonacular recipe by numeric `id`. Returns title, ingredients, instructions, cuisines, diets, ready time, servings, source URL, and optionally full nutrition data if `include -
recipe_ingredients— Fetch the ingredient list for a Spoonacular recipe by `id`. Returns each ingredient's name, amount, unit, image URL, and estimated cost in US cents. -
recipe_nutrition— Fetch the full nutrition breakdown for a Spoonacular recipe by `id`. Returns calories, macros (protein/fat/carbs), and detailed per-nutrient values including percent daily values. -
recipe_price_breakdown— Fetch the estimated ingredient cost breakdown for a Spoonacular recipe by `id`. Returns per-ingredient price in US cents and the total estimated cost per serving. -
recipe_random— Fetch one or more random Spoonacular recipes, optionally filtered by comma-separated `tags` (e.g. vegetarian,dessert ) and `number` of results. Returns full recipe details including ingredients and in -
recipe_search— Search Spoonacular recipes with complex filters passed as query params (query keyword, cuisine, diet, intolerances, includeIngredients, excludeIngredients, maxReadyTime, sort, etc.). Returns recipe id -
recipe_similar— Fetch Spoonacular recipes similar to a given recipe by `id`. Returns up to `number` similar recipes with title, image URL, ready time, and servings. -
recipe_summary— Fetch a short human-readable summary paragraph for a Spoonacular recipe by `id`. Returns the recipe title and a 1-2 sentence description of ingredients and preparation style. -
recipe_taste— Fetch taste profile scores for a Spoonacular recipe by `id`. Returns numeric scores for sweetness, saltiness, sourness, bitterness, savoriness, fattiness, and spiciness. Optionally normalize scores 0– -
wine_pairing— Fetch wine pairing suggestions for a `food` dish or ingredient (e.g. salmon , pasta primavera ) with optional `maxPrice` filter. Returns paired wine types and specific product recommendations with nam -
wine_recommendation— Fetch specific wine product recommendations for a wine type name (e.g. merlot , chardonnay ) with optional `minRating`, `price` target, and `number` of results. Returns product name, price, average ra