Lightning Wallet MCP

Instructions

Implementation Reference

• src/index.ts:1398-1414 (handler)

  Tool handler for 'get_rate_limits' in src/index.ts.

  case 'get_rate_limits': {
    GetRateLimitsSchema.parse(args);
    const result = await session.requireClient().getRateLimits();
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({
            success: true,
            requests_per_minute: result.requestsPerMinute,
            requests_remaining: result.requestsRemaining,
            reset_at: result.resetAt,
          }, null, 2),
        },
      ],
    };
  }

• src/lightning-faucet.ts:941-960 (handler)

  Method implementation in the LightningFaucetClient class.

  async getRateLimits(): Promise<{
    requestsPerMinute: number;
    requestsRemaining: number;
    resetAt: string;
    rawResponse: ApiResponse;
  }> {
    const result = await this.request<ApiResponse & {
      requests_per_minute?: number;
      rate_limit_per_minute?: number;
      requests_remaining?: number;
      reset_at?: string;
    }>('get_rate_limits');
  
    return {
      requestsPerMinute: result.requests_per_minute || result.rate_limit_per_minute || 60,
      requestsRemaining: result.requests_remaining || 60,
      resetAt: result.reset_at || new Date(Date.now() + 60000).toISOString(),
      rawResponse: result,
    };
  }

• src/index.ts:213-213 (schema)

  Input validation schema for get_rate_limits.

  const GetRateLimitsSchema = z.object({});