random-people-mcp

random-people-mcp

MCP server for the Random People API — generate realistic random user profiles for prototyping, testing, and development.

No authentication required. No API key needed.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "random-people": {
      "command": "npx",
      "args": ["-y", "random-people-mcp"]
    }
  }
}

Claude Code

claude mcp add random-people -- npx -y random-people-mcp

Tool

get_random_users

Generate realistic random user profiles with names, emails, addresses, avatars, and more.

Parameters:

Parameter	Type	Default	Description
results	number	1	Number of users to generate (1-5000)
gender	string	random	Filter by gender ("male" or "female")
seed	string	random	Seed for reproducible results
page	number	1	Page number for pagination (use with seed)

Example response (abbreviated):

{
  "results": [
    {
      "gender": "female",
      "name": { "title": "Mme", "first": "Debra", "last": "Flores" },
      "email": "[e-mail]",
      "location": { "city": "Toulouse", "country": "France", "..." : "..." },
      "phone": "00 31 88 32 68",
      "picture": { "large": "https://api.dicebear.com/...", "..." : "..." },
      "nat": "FR"
    }
  ],
  "info": { "seed": "test123", "results": 1, "page": 1, "version": "1.4" }
}

Each user includes: name, email, location (street, city, state, country, coordinates, timezone), login credentials, date of birth, registration date, phone, cell, national ID, and avatar pictures.

Data spans 20+ countries with localized names, addresses, and phone formats.

License

MIT