Random User

live Utilities

Generate realistic random user profiles with names, addresses, and photos via randomuser.me

2 tools

0ms auth

free tier 50 calls/day

Tools

generate_users

Generate one or more random user profiles with realistic names, addresses, emails, and photos. Optionally filter by nationality.

Parameters

Name Type Description

count opt number Number of users to generate (default 1, max 100).

nationality opt string 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.

▶ Try it

Response

generate_by_gender required: gender

Generate random user profiles filtered to a specific gender.

Parameters

Name Type Description

gender req string Gender to filter by. One of: male, female.

count opt number Number of users to generate (default 1, max 100).

▶ Try it

Response

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools

bash

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

Call a tool

bash

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

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("generate_users", {});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("generate realistic random user profiles with names, addresses, and photos via randomuser");

Related packs

Other Pipeworx packs in the same categories (Utilities):

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-randomuser": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/randomuser/mcp"
      ]
    }
  }
}