Random.org MCP Server

Instructions

Implementation Reference

• src/server.ts:122-148 (registration)

  Tool registration in the ListTools response, defining name, description, and input schema for generateDecimalFractions.
  { name: 'generateDecimalFractions', description: 'Generate true random decimal fractions between 0 and 1', inputSchema: { type: 'object', properties: { n: { type: 'number', description: 'Number of decimal fractions to generate (1-10,000)', minimum: 1, maximum: 10000, }, decimalPlaces: { type: 'number', description: 'Number of decimal places (1-20)', minimum: 1, maximum: 20, }, replacement: { type: 'boolean', description: 'Allow replacement (duplicates)', default: true, }, }, required: ['n', 'decimalPlaces'], }, },
• src/server.ts:339-356 (handler)

  MCP server handler that executes the generateDecimalFractions tool by calling RandomOrgClient and formatting the result as MCP response content.
  private async handleGenerateDecimalFractions(args: any) { const result = await this.randomOrgClient.generateDecimalFractions(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/types.ts:130-134 (schema)

  TypeScript interface defining the input parameters for generateDecimalFractions, matching the inputSchema.
  export interface DecimalParams { n: number; decimalPlaces: number; replacement?: boolean; }
• src/randomOrgClient.ts:93-96 (handler)

  RandomOrgClient method implementing the API call for generateDecimalFractions after validation.
  async generateDecimalFractions(params: DecimalParams): Promise<DecimalResult> { this.validateDecimalParams(params); return this.makeRequest<DecimalResult>('generateDecimalFractions', params); }
• src/randomOrgClient.ts:159-166 (helper)

  Validation helper function ensuring input parameters for generateDecimalFractions are within allowed ranges.
  private validateDecimalParams(params: DecimalParams): void { if (params.n < 1 || params.n > 10000) { throw new Error('n must be between 1 and 10,000'); } if (params.decimalPlaces < 1 || params.decimalPlaces > 20) { throw new Error('decimalPlaces must be between 1 and 20'); } }