Random number

$0.003 per call · failed calls are never charged · no account or API key needed

One or more random whole numbers in a range (inclusive), optionally all different, from a cryptographic random source. Use for draws, sampling and games.

Run it free (25 free calls) Buy credits by card (from $5) Example result (JSON)

Inputs

NameTypeDescription
minintegerLowest value (default 1)
maxintegerHighest value (default 100)
countintegerHow many (1-1000, default 1)
uniquestringtrue for no repeats

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/random/number?min=1"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/random/number?min=1&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.

Example result

{
  "numbers": [
    42,
    7,
    93
  ]
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is random_number, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools