Random Web3 Mcp
@suxiongye
RandomWeb3MCP is a random element generation service based on EVM block hash. The service provides various random element generation tools that can be used in games, finance, testing, and other fields.
Overview
What is Random Web3 Mcp?
Random Web3 Mcp is an MCP server that provides a suite of random number generation tools using blockchain hashes as an entropy source. It is designed for developers needing verifiable randomness in game development, financial simulation, test data generation, and scientific computing.
How to use Random Web3 Mcp?
Clone the repository and install with pip install -e ., then configure the server in Cursor settings by adding a random-web3-mcp service with the uv command pointing to the local project directory.
Key features of Random Web3 Mcp
- Offers over 10 tools: basic random, weighted selection, distributions, shuffling, etc.
- Uses blockchain hash (Trust Chain) for high-entropy randomness.
- Supports salt parameter for increased randomness in production.
- Provides probability distributions (uniform, normal, exponential, binomial).
- Includes special tools: rarity allocation, coordinate generation, random event triggering.
Use cases of Random Web3 Mcp
- Game development: random item drops, character attributes, map generation.
- Financial application: risk simulation, market behavior modeling.
- Test data: random test cases, load test samples, performance test data.
- Scientific calculation: Monte Carlo simulation, particle systems, random sampling.
FAQ from Random Web3 Mcp
Does Random Web3 Mcp require a network connection?
Yes, all random number generation depends on the blockchain hash of the Trust Chain, so a normal network connection is required.
What are the valid parameter ranges for weighted selection?
The weighted random selector accepts weight values from 0 to 1000, representing 0–100% probability.
What error codes can the service return?
Common error codes include INVALID_PARAMS (parameter error), NETWORK_ERROR, CHAIN_ERROR (blockchain access error), and INTERNAL_ERROR.
Is there any performance consideration when using Random Web3 Mcp?
Each random generation request accesses the blockchain, which may introduce latency. It is recommended to cache frequently used random numbers and manage request frequency for large volumes.