stackgate.ai
All integrations

Spoonacular

Search recipes, parse ingredients, and get cooking instructions from the Spoonacular Food API.

Manual setup 10 tools

Overview

Search recipes, find meals from ingredients on hand, parse ingredient lists, and get step-by-step cooking instructions via the Spoonacular Food API.

Prerequisites

  • A stackgate.ai account
  • A Spoonacular API key or access to a hub configured with SPOONACULAR_API_KEY

Getting credentials

Option A — Hub-wide key (no personal key needed)

If your stackgate.ai operator has configured a hub-wide Spoonacular API key, you can activate this integration without entering any credentials:

  1. Open My Integrations → Spoonacular.
  2. Click Connect & enable without filling in the API key field.

All users without a personal override share the hub key's daily point quota.

Option B — Personal Spoonacular API key

Use your own subscription and quota:

  1. Sign up at spoonacular.com/food-api (a free tier is available for development).
  2. Copy your API key from the Spoonacular console.
  3. In stackgate.ai, open My Integrations → Spoonacular.
  4. Paste your key in Spoonacular API key (optional override) and click Connect & enable.

See Spoonacular API documentation for pricing tiers and daily point limits.

Using with AI clients

  • Dedicated endpoint: POST /mcp/spoonacular with a Sanctum bearer token
  • Private gateway: use spoonacular__* namespaced tools (for example spoonacular__search-recipes-tool)

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — activate Spoonacular under My Integrations. If no hub key is configured, you must provide a personal API key.
  • 401 Unauthorized — your API key is invalid. Regenerate it in the Spoonacular console and update your credentials.
  • 402 Payment Required / quota exhausted — your daily Spoonacular points are used up. Free plans reset daily; paid plans have higher limits. Add a personal key or wait for quota reset.
  • 429 Too many requests — you hit Spoonacular's per-second rate limit. Wait a moment and retry.

Available tools

  • search-recipes-tool

    Search recipes with filters for query, diet, intolerances, ingredients, nutrients, and cooking time.

  • search-recipes-by-ingredients-tool

    Find recipes that maximize ingredients on hand and minimize missing items (what is in your fridge).

  • get-recipe-information-tool

    Get full recipe information including ingredients, diets, and optional nutrition per serving.

  • get-analyzed-recipe-instructions-tool

    Get step-by-step analyzed cooking instructions for a recipe.

  • autocomplete-recipe-search-tool

    Autocomplete recipe titles for a partial search query.

  • get-similar-recipes-tool

    Find recipes similar to a given recipe ID.

  • search-ingredients-tool

    Search the Spoonacular ingredient database by name.

  • get-ingredient-substitutes-tool

    Get substitute ingredients for a given ingredient name.

  • parse-ingredients-tool

    Parse plain-text ingredient lines into structured ingredient objects.

  • convert-amounts-tool

    Convert an ingredient amount from one unit to another.

MCP endpoint: https://stackgate.ai/mcp/spoonacular (HTTP) or via the private gateway.

Create account Documentation