Random.org MCP Server

Instructions

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);