generate_with_options

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/generate_with_options for the schema, then POST the same URL with its arguments for the data.

Generate formatted placeholder text with headers, code blocks, and lists (HTML). Specify which elements to include: headers, code blocks, unordered lists, ordered lists.

Parameters

NameTypeRequiredDescription
countnumberyesNumber of paragraphs to generate (1–10)
lengthstringyesLength of each paragraph
headersbooleannoInclude random headers (h1–h6)
codebooleannoInclude code blocks
unordered_listsbooleannoInclude unordered (bullet) lists
ordered_listsbooleannoInclude ordered (numbered) lists

Example call

Arguments

{
  "count": 2,
  "length": "short",
  "headers": true,
  "code": false,
  "unordered_lists": true,
  "ordered_lists": false
}

curl

curl -X POST https://gateway.pipeworx.io/lorem/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_with_options","arguments":{"count":2,"length":"short","headers":true,"code":false,"unordered_lists":true,"ordered_lists":false}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('generate_with_options', {
  "count": 2,
  "length": "short",
  "headers": true,
  "code": false,
  "unordered_lists": true,
  "ordered_lists": false
});

More examples

{
  "count": 4,
  "length": "medium",
  "headers": true,
  "code": true,
  "unordered_lists": true,
  "ordered_lists": true
}

Response shape

Always returns: count, length, options, html, plain_text

FieldTypeDescription
countnumberNumber of paragraphs requested
lengthstringLength of each paragraph
optionsobject
htmlstringFormatted HTML output
plain_textstringPlain text version with HTML tags stripped
Full JSON Schema
{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of paragraphs requested"
    },
    "length": {
      "type": "string",
      "enum": [
        "short",
        "medium",
        "long",
        "verylong"
      ],
      "description": "Length of each paragraph"
    },
    "options": {
      "type": "object",
      "properties": {
        "headers": {
          "type": "boolean",
          "description": "Include random headers"
        },
        "code": {
          "type": "boolean",
          "description": "Include code blocks"
        },
        "unordered_lists": {
          "type": "boolean",
          "description": "Include unordered lists"
        },
        "ordered_lists": {
          "type": "boolean",
          "description": "Include ordered lists"
        }
      },
      "required": [
        "headers",
        "code",
        "unordered_lists",
        "ordered_lists"
      ]
    },
    "html": {
      "type": "string",
      "description": "Formatted HTML output"
    },
    "plain_text": {
      "type": "string",
      "description": "Plain text version with HTML tags stripped"
    }
  },
  "required": [
    "count",
    "length",
    "options",
    "html",
    "plain_text"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

Regenerated from source · build September 22, 2026