Random User

liveDeveloperTechnology

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

2tools
0msauth
free tier50 calls/day

Tools

generate_users

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

Parameters
NameTypeDescription
countoptnumberNumber of users to generate (default 1, max 100).
nationalityoptstringComma-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
generate_by_genderrequired: gender

Generate random user profiles filtered to a specific gender.

Parameters
NameTypeDescription
genderreqstringGender to filter by. One of: male, female.
countoptnumberNumber of users to generate (default 1, max 100).
▶Try it

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");