`random_meal`

Pack: recipes · Endpoint: https://gateway.pipeworx.io/recipes/mcp

Get a random meal recipe with full ingredients and cooking instructions. Use when you need recipe inspiration without a specific search.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/recipes/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"random_meal","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('random_meal', {});

Response shape

Always returns: id, name, category, area, instructions, thumbnail_url, youtube_url, source_url, tags, ingredients

Field	Type	Description
`id`	string	TheMealDB meal ID
`name`	string	Meal name
`category`	string \| null	Meal category (e.g., dessert, seafood)
`area`	string \| null	Cuisine area/region (e.g., Italian, Indian)
`instructions`	string \| null	Step-by-step cooking instructions
`thumbnail_url`	string \| null	URL to meal thumbnail image
`youtube_url`	string \| null	YouTube video URL for recipe
`source_url`	string \| null	Source website URL
`tags`	array	List of meal tags/keywords
`ingredients`	array	List of ingredients with measurements

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "TheMealDB meal ID"
    },
    "name": {
      "type": "string",
      "description": "Meal name"
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "Meal category (e.g., dessert, seafood)"
    },
    "area": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cuisine area/region (e.g., Italian, Indian)"
    },
    "instructions": {
      "type": [
        "string",
        "null"
      ],
      "description": "Step-by-step cooking instructions"
    },
    "thumbnail_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL to meal thumbnail image"
    },
    "youtube_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "YouTube video URL for recipe"
    },
    "source_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Source website URL"
    },
    "tags": {
      "type": "array",
      "description": "List of meal tags/keywords",
      "items": {
        "type": "string"
      }
    },
    "ingredients": {
      "type": "array",
      "description": "List of ingredients with measurements",
      "items": {
        "type": "object",
        "properties": {
          "ingredient": {
            "type": "string",
            "description": "Ingredient name"
          },
          "measure": {
            "type": "string",
            "description": "Measurement quantity and unit"
          }
        },
        "required": [
          "ingredient",
          "measure"
        ]
      }
    }
  },
  "required": [
    "id",
    "name",
    "category",
    "area",
    "instructions",
    "thumbnail_url",
    "youtube_url",
    "source_url",
    "tags",
    "ingredients"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "recipes": {
      "url": "https://gateway.pipeworx.io/recipes/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

random_meal