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": "[email protected]",
      "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