`generate_by_gender`

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

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

Generate random user profiles by gender (“male” or “female”). Returns names, contact info, photos, and demographics. Specify count for multiple profiles.

Parameters

Name	Type	Required	Description
`gender`	string	yes	Gender to filter by. One of: male, female.
`count`	number	no	Number of users to generate (default 1, max 100).

Example call

Arguments

{
  "gender": "male"
}

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_by_gender","arguments":{"gender":"male"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('generate_by_gender', {
  "gender": "male"
});

More examples

{
  "gender": "female",
  "count": 10
}

Response shape

Always returns: count, gender, users

Field	Type	Description
`count`	number	Number of users returned
`gender`	string	Gender filter applied (male or female)
`users`	array	Array of formatted user profiles

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of users returned"
    },
    "gender": {
      "type": "string",
      "description": "Gender filter applied (male or female)"
    },
    "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",
    "gender",
    "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_by_gender