food-recipe-mcp

Simple connectivity test. Returns a greeting to confirm the server is running.

{
  "type": "object",
  "properties": {
    "name": {
      "default": "world",
      "description": "Arbitrary label included in the response, e.g. 'healthcheck'",
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "description": "Generic wrapper for non-object return types.",
  "x-fastmcp-wrap-result": true
}

Search a database of recipes using hybrid semantic search (dense + sparse) with reranking. The database contains ~50,000 recipes from Food.com covering a wide range of cuisines, meal types, and cooking styles. Recipes include nutritional information, difficulty ratings, and user ratings. Use natural language in the query to describe what you are looking for — cuisine, style, main ingredient, occasion, or mood all work well. Norwegian and English are both supported natively. Examples: 'quick Italian pasta for weeknight dinner' 'Swedish meatballs with gravy' 'healthy high-protein chicken bowl' 'easy chocolate cake for beginners' 'something with salmon and lemon' 'Indian curry chicken' 'traditional Norwegian kjøttkaker' 'hurtig pasta med kylling' 'enkel sjokoladekake' Args: query: What you are looking for — describe the dish, cuisine, main ingredient, cooking style or mood freely. Any language is supported. diet: Optional — filter by dietary requirement: 'vegetarian', 'vegan', 'gluten-free', 'dairy-free', 'low-carb', 'keto', 'paleo' max_minutes: Optional — maximum total time in minutes, e.g. 30 difficulty: Optional — 'easy', 'medium' or 'hard' servings: Optional — not used for filtering (servings vary), but include in query for scaling context, e.g. 'pasta dish for 6 people' limit: Number of results to return after reranking (default 5, max 20) Returns: List of recipes ranked by relevance. Each result includes rerank_score, rrf_score (hybrid fusion), title, total_time, difficulty, diet labels, ingredients, instructions, nutrition, rating, and source URL context.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Natural language description of what you want, e.g. 'quick Italian pasta' or 'enkel sjokoladekake'",
      "type": "string"
    },
    "diet": {
      "default": "",
      "description": "Optional dietary filter: vegetarian, vegan, gluten-free, dairy-free, low-carb, keto, or paleo",
      "type": "string"
    },
    "max_minutes": {
      "default": 0,
      "description": "Optional maximum total cooking time in minutes, e.g. 30. Use 0 for no limit",
      "type": "integer"
    },
    "difficulty": {
      "default": "",
      "description": "Optional difficulty filter: easy, medium, or hard",
      "type": "string"
    },
    "servings": {
      "default": 0,
      "description": "Not used for filtering — include serving size context in query instead, e.g. 'pasta for 6 people'",
      "type": "integer"
    },
    "limit": {
      "default": 5,
      "description": "Number of results to return after reranking (1–20, default 5)",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "description": "Generic wrapper for non-object return types.",
  "x-fastmcp-wrap-result": true
}