Random.org MCP Server

Instructions

Implementation Reference

• src/server.ts:396-413 (handler)

  Primary MCP handler for generateUUIDs tool: delegates to RandomOrgClient.generateUUIDs and formats response as MCP content
  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/randomOrgClient.ts:108-111 (handler)

  Core implementation handler: validates parameters and makes JSON-RPC request to Random.org API for UUID generation
  async generateUUIDs(params: UUIDParams): Promise<UUIDResult> { this.validateUUIDParams(params); return this.makeRequest<UUIDResult>('generateUUIDs', params); }
• src/server.ts:214-225 (schema)

  JSON Schema for generateUUIDs input validation used in MCP tool registration
  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 UUIDParams for type safety
  export interface UUIDParams { n: number; }
• src/server.ts:211-227 (registration)

  Tool registration entry in ListTools response defining name, description, and 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/randomOrgClient.ts:189-193 (helper)

  Parameter validation helper for UUIDParams ensuring n is in valid range
  private validateUUIDParams(params: UUIDParams): void { if (params.n < 1 || params.n > 1000) { throw new Error('n must be between 1 and 1,000'); } }