Random.org

Provides access to api.random.org to generate true random numbers, strings, UUIDs, and more via MCP endpoints.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "qianjue-cn-truerandommcp": {
      "command": "npx",
      "args": [
        "random-org-mcp-server"
      ],
      "env": {
        "MAX_RETRIES": "3",
        "RETRY_DELAY_MS": "1000",
        "RANDOM_ORG_API_KEY": "your_api_key_here",
        "REQUEST_TIMEOUT_MS": "10000",
        "RATE_LIMIT_BURST_SIZE": "5",
        "RATE_LIMIT_REQUESTS_PER_SECOND": "1"
      }
    }
  }
}

You run an MCP server that exposes Random.org capabilities, letting you generate true random numbers, strings, UUIDs, and more through structured MCP endpoints. This server acts as a bridge between your MCP client and the api.random.org service, enabling easy integration into your apps, experiments, or workflows while handling rate limits and retries for you.

How to use

Connect to the Random.org MCP server from your MCP client by pointing your client to one of the available MCP server configurations and providing your API key. You can run the server locally or use a hosted instance if available. Once connected, you can request random data such as integers, strings, UUIDs, decimal fractions, Gaussians, and binary blobs using the exposed tools.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Option A — Quick start using npm (recommended for development and testing)

# Install globally
npm install -g random-org-mcp-server

# Verify installation
random-org-mcp --version

How to install

Option B — Run without installation using npx

# Run directly with npx (no installation required)
npx random-org-mcp-server

How to install

Option C — Local project installation

# Install in your project
npm install random-org-mcp-server

# Run from node_modules
npx random-org-mcp-server

How to install

If you want to build from source, follow these steps to clone and build the project.

git clone https://github.com/QianJue-CN/TRUERandomMCP.git
cd TRUERandomMCP

npm install

npm run build

Additional configuration and usage notes

To use the API, you must provide an API key from api.random.org. You can configure the server via environment variables or MCP client configuration.

Available tools

generateIntegers

Generate true random integers within a specified range, with options for count, min, max, replacement, and base.

generateIntegerSequences

Create sequences of true random integers, with configurable sequence length and range.

generateDecimalFractions

Produce random decimal fractions between 0 and 1, with control over quantity.

generateGaussians

Generate random numbers following a Gaussian distribution, with mean and standard deviation parameters.

generateStrings

Generate random strings from a specified character set, with length and replacement controls.

generateUUIDs

Create true random UUIDs (version 4) in bulk.

generateBlobs

Generate random binary data in base64 or hex format.

getUsage

Retrieve API usage statistics and request counts.

Built by

VeilStrat

AI signals for GTM teams