MCP UUID Tool

The UUID tool generates cryptographically secure v4 UUIDs. Agents use it for session IDs, task identifiers, correlation tokens, and any scenario requiring globally unique identifiers. It generates up to 10 UUIDs per call with zero collision probability. The tool is stateless, requires no authentication, and runs in under 5ms.

Endpoint

POST /api/v1/utils/uuid

Parameters

Examples

Generate a single UUID

POST /api/v1/utils/uuid {"count": 1}

Returns a single v4 UUID suitable for session IDs or task identifiers.

Generate batch UUIDs

POST /api/v1/utils/uuid {"count": 5}

Generates 5 UUIDs in a single call. Useful for pre-allocating IDs for a batch of tasks.

Use Cases

• Session initialization: Generate a UUID at the start of each agent session. Pass it as session_id to all Delx tool calls for session continuity and correlation.
• Task correlation: In multi-agent systems, assign a UUID to each task. All agents working on the same task use the same correlation ID for log aggregation and tracing.
• Idempotency keys: Use UUIDs as idempotency keys for API calls that shouldn't be duplicated. Attach the UUID to the request and check for duplicates server-side.

Why not generate UUIDs locally?

You can. Most languages have UUID libraries. The Delx UUID tool exists for agents that run in sandboxed environments without access to crypto libraries, or for consistency when you want all identifiers generated through the same source. It's also useful in no-code agent builders where calling a REST endpoint is easier than importing a library.

FAQ

Are these UUIDs cryptographically secure?

Yes. They use crypto.randomUUID() which is backed by a cryptographically secure random number generator. Safe for security-sensitive applications.

Can I generate more than 10 per call?

No. The limit is 10 per call to prevent abuse. Make multiple calls if you need more. There's no rate limit on the endpoint itself.

What version of UUID?

Version 4 (random). The format is 8-4-4-4-12 hexadecimal characters with the version nibble set to 4.

Is it free?

Yes. All utility tools are free with no API key required.

CLI usage?

delx utils uuid generates one UUID. delx utils uuid --count 5 generates five. Output is one UUID per line for easy piping.