generateUUIDs
Generate true random UUIDs (version 4) for applications requiring cryptographically secure identifiers. Specify quantity from 1 to 1,000.
Instructions
Generate true random UUIDs (version 4)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | Yes | Number of UUIDs to generate (1-1,000) |
Implementation Reference
- src/server.ts:396-413 (handler)MCP tool handler for generateUUIDs: calls RandomOrgClient.generateUUIDs and formats the API response as standardized MCP content block with JSON stringified result.
private async handleGenerateUUIDs(args: any) { const result = await this.randomOrgClient.generateUUIDs(args); return { content: [ { type: 'text', text: JSON.stringify({ data: result.random.data, completionTime: result.random.completionTime, bitsUsed: result.bitsUsed, bitsLeft: result.bitsLeft, requestsLeft: result.requestsLeft, advisoryDelay: result.advisoryDelay, }, null, 2), }, ], }; } - src/server.ts:211-226 (registration)Tool registration in MCP server's ListTools response, defining name, description, and input JSON schema.
{ name: 'generateUUIDs', description: 'Generate true random UUIDs (version 4)', inputSchema: { type: 'object', properties: { n: { type: 'number', description: 'Number of UUIDs to generate (1-1,000)', minimum: 1, maximum: 1000, }, }, required: ['n'], }, }, - src/types.ts:150-152 (schema)TypeScript interface defining input parameters for generateUUIDs (matches MCP inputSchema).
export interface UUIDParams { n: number; } - src/types.ts:79-88 (schema)TypeScript interface defining the output structure from Random.org API for UUID generation.
export interface UUIDResult { random: { data: string[]; completionTime: string; }; bitsUsed: number; bitsLeft: number; requestsLeft: number; advisoryDelay: number; } - src/randomOrgClient.ts:108-110 (helper)Core helper function in RandomOrgClient that performs input validation and makes the HTTP JSON-RPC request to Random.org's generateUUIDs API endpoint.
async generateUUIDs(params: UUIDParams): Promise<UUIDResult> { this.validateUUIDParams(params); return this.makeRequest<UUIDResult>('generateUUIDs', params);