Skip to main content
Glama
Sign In
enesjakozh

RandomUser MCP Server

by rycid
GitHub
JavaScript
MIT License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Supports SQL output format with MySQL dialect for random user data, including CREATE TABLE statements and proper type handling.

  • Supports SQL output format with PostgreSQL dialect for random user data, including CREATE TABLE statements and proper type handling.

  • Supports SQL output format with SQLite dialect for random user data, including CREATE TABLE statements and proper type handling.

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

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

  1. Installation
    1. Usage
      1. Available Tools
      2. Output Formats
      3. Field Selection
      4. Supported Nationalities
    2. Development
      1. License

        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
          13
          2
          TypeScript
          MIT License

        • Coin Flip MCP Server

          TeglonLabs
          A
          security
          F
          license
          A
          quality
          Enables interaction with a tool for generating true random coin flips via random.org's API, supporting multiple custom side configurations and illustrating the Model Context Protocol.
          Last updated -
          1
          JavaScript
          • Apple

        • Wegene Assistant MCP Server

          xraywu
          A
          security
          F
          license
          A
          quality
          Leverages large language models to analyze users' WeGene genetic testing reports, providing access to report data via custom URI schemes and enabling profile and report management through OAuth authentication and API utilization.
          Last updated -
          4
          2
          Python
          • Apple

        • ServeMyAPI

          Jktfe
          -
          security
          F
          license
          -
          quality
          A personal MCP server for securely storing and accessing API keys across projects using the macOS Keychain, letting AI assistants and applications retrieve credentials through natural language.
          Last updated -
          10
          TypeScript
          • Apple

        View all related MCP servers

        New MCP Servers

        ID: bbia3jeo9b