Random.org MCP Server

Instructions

Implementation Reference

• src/server.ts:434-444 (handler)

  The MCP server handler for the 'getUsage' tool. It calls RandomOrgClient.getUsage() and returns the result formatted as JSON text content.
  private async handleGetUsage(args: any) { const result = await this.randomOrgClient.getUsage(); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }
• src/server.ts:255-262 (registration)

  Registration of the 'getUsage' tool in the ListTools response, including name, description, and empty input schema.
  { name: 'getUsage', description: 'Get API usage statistics', inputSchema: { type: 'object', properties: {}, }, },
• src/types.ts:103-110 (schema)

  TypeScript interface defining the structure of the UsageResult returned by the Random.org API 'getUsage' endpoint.
  export interface UsageResult { status: string; creationTime: string; bitsLeft: number; requestsLeft: number; totalBits: number; totalRequests: number; }
• src/randomOrgClient.ts:118-120 (helper)

  Helper method in RandomOrgClient that makes the actual API request to Random.org's 'getUsage' endpoint using makeRequest.
  async getUsage(): Promise<UsageResult> { return this.makeRequest<UsageResult>('getUsage', {}); }