zazencodes avatar

Random Number Mcp

zazencodes/random-number-mcp

Wraps Python's random and secrets modules into seven MCP tools for generating numbers, shuffling lists, and creating secure tokens. You get randint and uniform for basic randomness, choices with optional weights for selection, sample for unique picks, and shuffle for reordering. The secure variants use secrets.token_hex() and secrets.randbelow() when you need cryptographically sound output for tokens or keys. Runs via uvx with stdio transport. Useful when you need Claude to generate test data, pick random items from lists, or create secure identifiers without implementing the randomization logic yourself.

GitHub stars
51
tools
7
transport
STDIO
last updated
Mar 3, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

random_intGenerate a random integer between low and high (inclusive).

Generate a random integer between low and high (inclusive).

No parameter schema in public metadata yet.

random_floatGenerate a random float between low and high.

Generate a random float between low and high.

No parameter schema in public metadata yet.

random_choicesChoose k items from a population with replacement, optionally weighted.

Choose k items from a population with replacement, optionally weighted.

No parameter schema in public metadata yet.

random_shuffleReturn a new list with items in random order.

Return a new list with items in random order.

No parameter schema in public metadata yet.

random_sampleChoose k unique items from population without replacement.

Choose k unique items from population without replacement.

No parameter schema in public metadata yet.

secure_token_hexGenerate a cryptographically secure random hex token.

Generate a cryptographically secure random hex token.

No parameter schema in public metadata yet.

secure_random_intGenerate a cryptographically secure random integer below upper_bound.

Generate a cryptographically secure random integer below upper_bound.

No parameter schema in public metadata yet.

Sponsors

Readme

Random Number MCP

Essential random number generation utilities from the Python standard library, including pseudorandom and cryptographically secure operations for integers, floats, weighted selections, list shuffling, and secure token generation.

Looking for the agent skill version? random-number-skills implements the same random number generation strategy as an agent skill instead of an MCP server.

Demo Video

https://github.com/user-attachments/assets/303a441a-2b10-47e3-b2a5-c8b51840e362

Random Number MCP server

Tools


View the full README on GitHub

Details

Repository
github.com/zazencodes/random-number-mcp
Package
random-number-mcp
Transport
STDIO
Registry
MCP registry, active