MCP server exposing 18 tools for spoonacular.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/spoonacular/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}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, title, image, and ready-in minutes.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 `includeNutrition` is true.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 instructions.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 to `number` similar 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–100.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 given `amount` and `unit`. Use `ingredient_search` to 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") matching `targetCalories`, `diet` (e.g. vegetarian/vegan/paleo), and comma-separated `exclude` ingredients. Returns meals with recipe ids, titles, images, and nutrition summary.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.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 name, price, and description.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 rating, and description.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 and unit (e.g. 1 cup flour → 125 grams).Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/spoonacular/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io