Cursor Pro Limits MCP Server

Instructions

Implementation Reference

• src/index.ts:255-303 (handler)

  Primary MCP tool handler for 'check_alerts'. Calls monitor.checkAlerts(), formats alerts into Markdown summary with status emojis and details if any, or no-alerts message.

    private async handleCheckAlerts() {
      const alerts = this.monitor.checkAlerts();
  
      if (alerts.length === 0) {
        return {
          content: [
            {
              type: 'text',
              text: '✅ No alerts - all services are within normal limits.',
            },
          ],
        };
      }
  
      const alertContent = alerts
        .map(alert => {
          const status = alert.isCritical ? '🔴 CRITICAL' : '🟡 WARNING';
          return `- **${alert.service.toUpperCase()}**: ${status} (${alert.percentage.toFixed(1)}% used)`;
        })
        .join('\n');
  
      const content = `
  # Alert Summary
  
  ${alertContent}
  
  ## Details
  ${alerts
    .map(alert =>
      `
  ### ${alert.service.toUpperCase()}
  - Current: ${alert.current}/${alert.max}
  - Percentage: ${alert.percentage.toFixed(1)}%
  - Remaining: ${alert.remaining}
  - Status: ${alert.isCritical ? 'CRITICAL' : 'WARNING'}
      `.trim()
    )
    .join('\n')}
      `.trim();
  
      return {
        content: [
          {
            type: 'text',
            text: content,
          },
        ],
      };
    }

• src/index.ts:63-70 (registration)

  Tool registration in ListTools response: defines name 'check_alerts', description, and empty input schema (no parameters required).

  {
    name: 'check_alerts',
    description: 'Check for services approaching or exceeding limits',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/cursorLimitsMonitor.ts:172-183 (helper)

  Helper method in CursorLimitsMonitor that checks all services for warning (>=80%) or critical (>=95%) usage and returns array of ServiceUsage for alerting services.

  public checkAlerts(): ServiceUsage[] {
    const services: Array<'sonnet45' | 'gemini' | 'gpt5' | 'total'> = [
      'sonnet45',
      'gemini',
      'gpt5',
      'total',
    ];
  
    return services
      .map(service => this.getServiceUsage(service))
      .filter(usage => usage.isWarning || usage.isCritical);
  }

• src/types.ts:73-81 (schema)

  TypeScript interface defining ServiceUsage structure used for alert outputs, including flags for warning and critical thresholds.

  export interface ServiceUsage {
    service: ServiceType;
    current: number;
    max: number;
    percentage: number;
    remaining: number;
    isWarning: boolean;
    isCritical: boolean;
  }