Skip to main content
Glama
Sign In
enesjakozh
RandomUser MCP Server

RandomUser MCP Server

by rycid
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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

Related MCP server: mcp-rando-server

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

Available Tools

2 tools
get_multiple_usersC

Get multiple random users

Inputs: count (required), gender, nationality, nationalityWeights, +3 more.

get_random_userC

Get a single random user

Inputs: gender, nationality, fields, format, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    C2.9/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one retrieves a single random user, while the other retrieves multiple random users. There is no overlap or ambiguity in their functions, making it easy for an agent to select the appropriate tool based on the desired outcome.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern with 'get' as the verb and descriptive nouns ('random_user', 'multiple_users'). The naming is uniform and predictable, using snake_case throughout without any deviations.

    Tool Count2/5

    With only 2 tools, the server feels thin for a 'RandomUser' domain, as it lacks operations like filtering users by criteria, updating user data, or handling user-related workflows. While the tools cover basic retrieval, the count is too low for a comprehensive user management or data generation scope.

    Completeness2/5

    The tool surface is severely incomplete for a user-related server, offering only retrieval of random users without any ability to create, update, delete, or filter users. There are significant gaps that would limit agent functionality, such as no way to specify user attributes or manage user data beyond basic fetching.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-randomuser

      pipeworx-io
      A
      license
      Not graded
      quality
      C
      maintenance
      Wraps the randomuser.me API to generate random user profiles with names, contact info, and demographics, optionally filtered by gender and count.
      274 npm
      MIT

    • mcp-rando-server

      hesreallyhim
      A
      license
      Not graded
      quality
      D
      maintenance
      Cryptographically secure random number generation and randomized resources, including tools for numbers, strings, dice rolls, UUIDs, and passphrases.
      4
      MIT

    • password_generator20

      BACH-AI-Tools
      A
      license
      C
      quality
      D
      maintenance
      Generates passwords with customizable length, special characters, numbers, and umlauts via the Password Generator20 API.
      1
      MIT

    • Softalleys Utilities MCP

      SoftalleysPlayground
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables generation of UUIDs (v4, v7) and ULIDs, UTC time retrieval, and customizable random string creation with options for length, case, numbers, and special characters.
      MIT

    Appeared in Searches