RandomUser MCP Server

An MCP server that provides enhanced access to the randomuser.me API with additional features like custom formatting, password generation, and weighted nationality distribution.

Installation

Clone the repository:

git clone https://github.com/rycid/randomuserMCP.git
cd randomuserMCP

# Install dependencies
npm install

# Build the project
npm run build

Usage

Add to your MCP settings file (claude_desktop_config.json or cline_mcp_settings.json):

{
  "mcpServers": {
    "randomuser": {
      "command": "node",
      "args": ["path/to/randomuserMCP/build/index.js"]
    }
  }
}

Available Tools

get_random_user

Get a single random user with customizable options.

{
  "gender": "female",
  "nationality": "US",
  "fields": {
    "mode": "include",
    "values": ["name", "email", "phone"]
  },
  "format": {
    "type": "json",
    "structure": {
      "flattenObjects": true,
      "nameFormat": "full"
    }
  },
  "password": {
    "charsets": ["special", "upper", "lower", "number"],
    "minLength": 8,
    "maxLength": 12
  }
}

get_multiple_users

Get multiple random users with weighted nationality distribution.

{
  "count": 10,
  "nationality": ["US", "GB", "FR"],
  "nationalityWeights": {
    "US": 0.5,
    "GB": 0.3,
    "FR": 0.2
  },
  "fields": {
    "mode": "include",
    "values": ["name", "email", "nat"]
  },
  "format": {
    "type": "csv",
    "csv": {
      "delimiter": ",",
      "includeHeader": true
    }
  }
}

Output Formats

The server supports multiple output formats:

JSON (default)

Nested or flattened objects
Customizable name formats (full, first_last, separate)
Date formatting options (iso, unix, formatted)

CSV

Customizable delimiter
Optional headers
Automatically flattened data structure

SQL

Multiple dialect support (MySQL, PostgreSQL, SQLite)
Optional CREATE TABLE statements
Proper escaping and type handling

XML

Standard XML format
Nested data structure
Proper escaping of special characters

Field Selection

Include or exclude specific fields:

{
  "fields": {
    "mode": "include",  // or "exclude"
    "values": [
      "name",
      "phone",
      "email",
      "location",
      "picture",
      "dob",
      "login",
      "registered",
      "id",
      "cell",
      "nat"
    ]
  }
}

Supported Nationalities

AU: Australia
BR: Brazil
CA: Canada
CH: Switzerland
DE: Germany
DK: Denmark
ES: Spain
FI: Finland
FR: France
GB: United Kingdom
IE: Ireland
IN: India
IR: Iran
MX: Mexico
NL: Netherlands
NO: Norway
NZ: New Zealand
RS: Serbia
TR: Turkey
UA: Ukraine
US: United States

Development

# Install dependencies
npm install

# Build the project
npm run build

# Start in development mode (with watch mode)
npm run dev

# Start the server
npm start

License

MIT

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Provides enhanced access to the randomuser.me API with advanced features like custom formatting, password generation, and weighted nationality distribution.

Related MCP Servers

MCP Rand
turlockmike
A
security
A
license
A
quality
Provides random number generation utilities, including a secure UUID generator powered by Node's crypto module.
Last updated -
7
253
3
TypeScript
MIT License
ntropy-mcp MCP Serverofficial
ntropy-network
-
security
A
license
-
quality
Enables enriching banking data with the Ntropy API, providing tools to create account holders and enrich transactions efficiently.
Last updated -
3
Python
MIT License
Ntropy MCP Server
smithery-ai
-
security
F
license
-
quality
Enables enrichment of banking data through the Ntropy API, including creating account holders and enriching transaction details.
Last updated -
mcp-server-requests
coucya
-
security
A
license
-
quality
Web Content Retrieval (full webpage, filtered content, or Markdown-converted), Custom User-Agent, Multi-HTTP Method Support (GET/POST/PUT/DELETE/PATCH), LLM-Controlled Request Headers, LLM-Accessible Response Headers, and more.
Last updated -
3
Python
MIT License

View all related MCP servers

RandomUser MCP Server