Spoonacular

liveFood

Spoonacular — recipe search, nutrition analysis, meal planning, ingredient details, wine pairings, and grocery products.

18tools
0msauth
free tier50 calls/day

Tools

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

No parameters required.

▶Try it
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 i

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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–

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
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.

No parameters required.

▶Try it
product_information

Fetch details for a branded grocery product by Spoonacular numeric `id`. Returns product title, UPC, brand, ingredients, nutrition facts, and image URL.

No parameters required.

▶Try it
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 wit

No parameters required.

▶Try it
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

No parameters required.

▶Try it
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 n

No parameters required.

▶Try it
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

No parameters required.

▶Try it
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

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/spoonacular/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/spoonacular/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"recipe_search","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("recipe_search", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("spoonacular — recipe search, nutrition analysis, meal planning, ingredient details, wine pairings, and grocery products");