---
name: api.x402node.dev
description: api.x402node.dev exposes a single UUID generation endpoint that produces v4 or v7 UUIDs, individually or in small batches, returning the UUID string alongside version and count metadata. It is a remote utility service for agents that cannot or should not run local ID generation code.
host: api.x402node.dev
---

# api.x402node.dev

This host is a narrow-purpose utility that offloads UUID generation to a remote API call. It serves agents operating in environments where local crypto libraries are unavailable or where a consistent, externally-sourced unique identifier is required for idempotency keys, correlation IDs, or record creation. It does not provide any data storage, lookup, or broader identity management capabilities.

## When to use this host

Use this host when an agent needs a remotely generated UUID v4 or v7 and cannot rely on local library calls — for example, in sandboxed runtimes or when a verifiable external source of randomness is preferred for idempotency keys or correlation IDs. Do not use it for sequential or deterministic identifiers; use a database sequence or ULID generator instead. Do not use it for high-volume bulk ID generation where the per-call cost of a paid API endpoint would be prohibitive — local UUID libraries (e.g., Python uuid, Node crypto.randomUUID) are more appropriate in that case. This host has no skills for ID lookup, storage, validation, or any domain beyond generation.

## Capabilities

### UUID Generation

Generates cryptographically random UUID v4 or v7 identifiers, optionally in small batches, and returns the UUID value along with version and count metadata.

- **`fetch-uuid`** — Generates a UUID v4 or v7 (single or batch) and returns the UUID string along with version and count metadata.

## Skill reference

### `fetch-uuid`

**UUID Forge** — Generates a UUID v4 or v7 (single or batch) and returns the UUID string along with version and count metadata.

*Use when:* Use when an agent needs a cryptographically random UUID for record creation, idempotency keys, correlation IDs, or any context requiring a unique identifier without running local generation code.

*Not for:* Do not use for sequential or deterministic IDs; use a database sequence or ULID generator instead. Not suitable for high-volume bulk ID generation where per-call cost would be prohibitive.

**Returns:** Returns a single UUID v4 string with version number, count, and generator metadata from Node.js crypto.

**Example:** `GET https://api.x402node.dev/dev/uuid`

---
