`generate_users`

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

Generate random user profiles with names, addresses, emails, and photos. Filter by nationality (e.g., “US”, “GB”, “AU”) and specify count for multiple profiles.

Parameters

Name	Type	Required	Description
`count`	number	no	Number of users to generate (default 1, max 100).
`nationality`	string	no	Comma-separated nationality codes to filter by (e.g. “us,gb,au”). Supported: AU, BR, CA, CH, DE, DK, ES, FI, FR, GB, IE, IN, IR, MX, NL, NO, NZ, RS, TR, UA, US.

Example call

Arguments

{
  "count": 1
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('generate_users', {
  "count": 1
});

More examples

{
  "count": 5,
  "nationality": "us,gb,au"
}

Response shape

Always returns: count, users

Field	Type	Description
`count`	number	Number of users returned
`users`	array	Array of formatted user profiles

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of users returned"
    },
    "users": {
      "type": "array",
      "description": "Array of formatted user profiles",
      "items": {
        "type": "object",
        "properties": {
          "gender": {
            "type": "string",
            "description": "Gender (male or female)"
          },
          "name": {
            "type": "string",
            "description": "Full name with title"
          },
          "email": {
            "type": "string",
            "description": "Email address"
          },
          "username": {
            "type": "string",
            "description": "Login username"
          },
          "uuid": {
            "type": "string",
            "description": "Unique user identifier"
          },
          "date_of_birth": {
            "type": "string",
            "description": "ISO date of birth"
          },
          "age": {
            "type": "number",
            "description": "Age in years"
          },
          "phone": {
            "type": "string",
            "description": "Phone number"
          },
          "cell": {
            "type": "string",
            "description": "Mobile/cell number"
          },
          "nationality": {
            "type": "string",
            "description": "Nationality code"
          },
          "location": {
            "type": "object",
            "description": "Address information",
            "properties": {
              "street": {
                "type": "string",
                "description": "Street address"
              },
              "city": {
                "type": "string",
                "description": "City name"
              },
              "state": {
                "type": "string",
                "description": "State or region"
              },
              "country": {
                "type": "string",
                "description": "Country name"
              },
              "postcode": {
                "type": "string",
                "description": "Postal code"
              }
            },
            "required": [
              "street",
              "city",
              "state",
              "country",
              "postcode"
            ]
          },
          "picture": {
            "type": "string",
            "description": "URL to medium-sized profile picture"
          }
        },
        "required": [
          "gender",
          "name",
          "email",
          "username",
          "uuid",
          "date_of_birth",
          "age",
          "phone",
          "cell",
          "nationality",
          "location",
          "picture"
        ]
      }
    }
  },
  "required": [
    "count",
    "users"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

generate_users