stackgate.ai
All integrations

Spoonacular

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

Manual setup 10 tools

Example questions

Try asking your AI client

  • What can I cook tonight with chicken, rice, and leftover spinach?

  • Did that pasta recipe I saved ever list a dairy-free version?

  • Write a draft shopping list for a three-day dinner plan - do not order anything.

  • Find a 30 minute recipe under 600 calories.

  • Parse this ingredient line: 2 tbsp olive oil and tell me the amount in grams.

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)

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

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

  • search_recipes_by_ingredients

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

  • get_recipe_information

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

  • get_analyzed_recipe_instructions

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

  • autocomplete_recipe_search

    Autocomplete recipe titles for a partial search query.

  • get_similar_recipes

    Find recipes similar to a given recipe ID.

  • search_ingredients

    Search the Spoonacular ingredient database by name.

  • get_ingredient_substitutes

    Get substitute ingredients for a given ingredient name.

  • parse_ingredients

    Parse plain-text ingredient lines into structured ingredient objects.

  • convert_amounts

    Convert an ingredient amount from one unit to another.

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

Related workflows

Multi-integration playbooks that use Spoonacular to solve concrete business outcomes.

Create account Documentation