Skip to content
MCPBytes

Physical randomness.One tool call.

Random numbers drawn from physical hardware, not a formula, whenever your agent needs to roll the dice.

1 credit per job300 free credits to start

Available
  • API
  • MCP
MCP tool: get_random_numbers

Before

count, min, max10 integers from 1 to 6

After

[5, 4, 3, 6, 1, 3, 2, 5, 2, 6]
  • numbers.json
  • numbers.txt
D1Get random numbersUse a new request key for a fresh draw. Reuse a key to retrieve the same result.

Real chance, not a formula.

Most computer random numbers come from a formula that repeats if you know where it started. MCPBytes draws fresh randomness from physical hardware for every new job. Use it when chance should come from outside your computer: to pick a creative direction, break a tie, roll dice, sample candidates or feed a simulation. Ask for how many numbers and in what range; repeats can happen, just like real dice. Not for passwords or keys.

Randomness
Hardware-generated; fresh draws for new jobs
Input
count, min and max; no file
Outputs
numbers.json and numbers.txt
Range
Signed 32-bit bounds, min less than max
Replay
Reuse a request key to retrieve the same draw

NIST Randomness validation

14 test groups passed every check in our NIST test run on one million output bits. Explore the complete results and what each check means.

View test results

From the physical world.

Every new job draws fresh randomness from hardware, not a repeating formula.

Your range.

A coin flip, a die or a range in the billions, up to 1,000 numbers at a time.

Tested in the open.

See our test results, check by check, and download the sample.

Pay by the job.

Costs 1 credits per job. A job that fails costs nothing.

Pricing details

Start free

Available now

300free credits when you sign up

  • Every MCPBytes tool, one credit balance
  • Sign in with GitHub or email, no card required
  • Each tool states its price before you run it
  • Failed API jobs cost nothing

Price per job

Get random numbers

Per job
1 credit

Limits

Most values per job
1,000

Limits by account

Jobs at once
Free3 jobs
Pay as you go5 jobs
Monthly bundle8 jobs
Results kept
Free1 day
Pay as you go7 days
Monthly bundle30 days
Longest run
Free10 min
Pay as you go14 min 30 s
Monthly bundle14 min 30 s

Free until your first purchase; any credit pack moves you to Pay as you go; a monthly bundle while it lasts. Compare accounts

Your agent or your code.

Connect your agent and it can use this tool right away, or call it from your own code. One key works for both.

Start a job

Send the required parameters as JSON. Options such as count go in the options object.

RequestcURL
curl https://api.mcpbytes.com/v1/tools/get_random_numbers/jobs \
  -H "Authorization: Bearer $MCPBYTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"options":{"count":10,"min":1,"max":6},"idempotency_key":"dice-example-001"}'
Response200 OK · trimmed
{
  "id": "j_vwzd6fj7kgy9c4xzn3d3nd922t",
  "tool": "get_random_numbers",
  "status": "succeeded",
  "input_kind": "parameters",
  "options": {
    "count": 10,
    "min": 1,
    "max": 6
  }
}

Get the result

Poll until the status is final. Download files only after success.

RequestcURL
curl "https://api.mcpbytes.com/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $MCPBYTES_API_KEY"
Response200 OK · trimmed
{
  "id": "j_vwzd6fj7kgy9c4xzn3d3nd922t",
  "tool": "get_random_numbers",
  "status": "succeeded",
  "result": {
    "numbers": [
      5,
      4,
      3,
      6,
      1,
      3,
      2,
      5,
      2,
      6
    ],
    "count": 10,
    "min": 1,
    "max": 6,
    "files": [
      {
        "name": "numbers.json"
      },
      {
        "name": "numbers.txt"
      }
    ]
  }
}

MCP

Connect once. Your agent calls get_random_numbers and gets the download URLs back. This endpoint has only this tool's family, which keeps your agent's tool list short; one endpoint has every tool.

Claude Code

The first form signs in through the browser when you run /mcp. In .mcp.json (project root), ${MCPBYTES_API_KEY} is read from the environment when Claude Code connects. Claude Code docs

claude mcp add --transport http mcpbytes \
  https://api.mcpbytes.com/mcp/random
Codex (CLI, IDE extension, ChatGPT desktop)

Codex reads the key from the environment variable each time it connects. The same table can go in ~/.codex/config.toml by hand; codex mcp add has no --header flag. Codex docs

codex mcp add mcpbytes --url https://api.mcpbytes.com/mcp/random \
  --bearer-token-env-var MCPBYTES_API_KEY
Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Remote servers take no "type". Without the header, the client signs you in with GitHub or an email link (OAuth). Cursor docs

~/.cursor/mcp.json
{
  "mcpServers": {
    "mcpbytes": {
      "url": "https://api.mcpbytes.com/mcp/random",
      "headers": {
        "Authorization": "Bearer ${env:MCPBYTES_API_KEY}"
      }
    }
  }
}
11 more clients in the docs →
MCP tools
get_random_numbers
Returns count random integers between min and max, inclusive, in numbers.json, with numbers.txt inline. Repeated values are allowed. A failed job is refunded. Not for cryptographic secrets. Costs 1 credits per job. Requires idempotency_key; retain it when retrying the same request.
get_job
Status and results of a job; waits up to wait_seconds for it to finish.
cancel_job
Cancel a queued job or a workflow whose can_cancel is true; repeated calls never delete results.
list_jobs
Your most recent jobs, newest first.
read_job_file
Reads a text output (.txt .json .md .csv) of a succeeded job in chunks.
Full reference: inputs, options, outputs, limits and errors

Your first jobs are on us.

Start with 300 free credits. Sign in with GitHub or email and try a tool in your browser. No card required.