---
title: "Cursor Cloud Agents"
description: "import Image from '@theme/IdealImage';"
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/cursor-1
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:19:15.671Z
license: CC-BY-4.0
attribution: "Cursor Cloud Agents — Claudary (https://claudary.paisolsolutions.com/skills/cursor-1)"
---

# Cursor Cloud Agents
import Image from '@theme/IdealImage';

## Overview

import Image from '@theme/IdealImage';

# Cursor Cloud Agents

Pass-through endpoints for the [Cursor Cloud Agents API](https://docs.cursor.com/account/api) — launch and manage cloud agents that work on your repositories, in native format (no translation).

| Feature | Supported | Notes |
|---------|-----------|-------|
| Cost Tracking | ✅ | Logged as $0.00 (subscription-based, no per-request pricing) |
| Logging | ✅ | All requests logged with operation classification |
| End-user Tracking | ❌ | [Tell us if you need this](https://github.com/BerriAI/litellm/issues/new) |
| Streaming | ❌ | Cursor API does not use streaming |

Just replace `https://api.cursor.com` with `LITELLM_PROXY_BASE_URL/cursor` 🚀

**Supported endpoints:**

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/v0/agents` | GET | List agents |
| `/v0/agents` | POST | Launch an agent |
| `/v0/agents/{id}` | GET | Agent status |
| `/v0/agents/{id}` | DELETE | Delete an agent |
| `/v0/agents/{id}/conversation` | GET | Agent conversation |
| `/v0/agents/{id}/followup` | POST | Add follow-up |
| `/v0/agents/{id}/stop` | POST | Stop an agent |
| `/v0/me` | GET | API key info |
| `/v0/models` | GET | List models |
| `/v0/repositories` | GET | List GitHub repositories |

## Quick Start

### 1. Add Cursor API Key on the UI

Navigate to **Models + Endpoints → LLM Credentials** and click **Add Credential**. Select **Cursor** from the provider dropdown — you'll see the Cursor logo. Enter your API key from [cursor.com/settings](https://cursor.com/settings).

<Image img={require('../../img/cursor_add_credential.png')} alt="Add Cursor credential with logo" style={{maxWidth: '800px'}} />

### 2. Launch a Cursor Agent

```bash
curl -X POST http://0.0.0.0:4000/cursor/v0/agents \\
  -H "Authorization: Bearer <your-litellm-key>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "prompt": {
      "text": "Add a README.md with installation instructions"
    },
    "source": {
      "repository": "https://github.com/your-org/your-repo",
      "ref": "main"
    },
    "target": {
      "autoCreatePr": true
    }
  }'
```

**Expected Response:**

```json
{
  "id": "bc_abc123",
  "name": "Add README Documentation",
  "status": "CREATING",
  "source": {
    "repository": "https://github.com/your-org/your-repo",
    "ref": "main"
  },
  "target": {
    "branchName": "cursor/add-readme-1234",
    "url": "https://cursor.com/agents?id=bc_abc123",
    "autoCreatePr": true
  },
  "createdAt": "2024-01-15T10:30:00Z"
}
```

### 3. View Logs

Navigate to **Logs** in the sidebar. Filter by "cursor" to see your agent requests. Each request shows the operation type (e.g., `cursor/cursor:agent:create`), status, duration, and cost.

<Image img={require('../../img/cursor_logs.png')} alt="Cursor requests in Logs page" style={{maxWidth: '800px'}} />

Click on any log entry to see full request details including provider, API base, and metadata.

<Image img={require('../../img/cursor_log_detail.png')} alt="Cursor log entry detail" style={{maxWidth: '800px'}} />

## Examples

Anything after `http://0.0.0.0:4000/cursor` is treated as a provider-specific route, and handled accordingly.

| **Original Endpoint** | **Replace With** |
|---|---|
| `https://api.cursor.com` | `http://0.0.0.0:4000/cursor` (LITELLM_PROXY_BASE_URL) |
| `-u YOUR_API_KEY:` (Basic Auth) | `-H "Authorization: Bearer <your-litellm-key>"` (LiteLLM Virtual Key) |

### List Available Models

```bash
curl http://0.0.0.0:4000/cursor/v0/models \\
  -H "Authorization: Bearer <your-litellm-key>"
```

### Check Agent Status

```bash
curl http://0.0.0.0:4000/cursor/v0/agents/bc_abc123 \\
  -H "Authorization: Bearer <your-litellm-key>"
```

### List All Agents

```bash
curl http://0.0.0.0:4000/cursor/v0/agents \\
  -H "Authorization: Bearer <your-litellm-key>"
```

### Add Follow-up to Agent

```bash
curl -X POST http://0.0.0.0:4000/cursor/v0/agents/bc_abc123/followup \\
  -H "Authorization: Bearer <your-litellm-key>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "prompt": {
      "text": "Also add a section about troubleshooting"
    }
  }'
```

### Stop an Agent

```bash
curl -X POST http://0.0.0.0:4000/cursor/v0/agents/bc_abc123/stop \\
  -H "Authorization: Bearer <your-litellm-key>"
```

### Delete an Agent

```bash
curl -X DELETE http://0.0.0.0:4000/cursor/v0/agents/bc_abc123 \\
  -H "Authorization: Bearer <your-litellm-key>"
```

### Get API Key Info

```bash
curl http://0.0.0.0:4000/cursor/v0/me \\
  -H "Authorization: Bearer <your-litellm-key>"
```

## Related

- [Cursor Cloud Agents API Docs](https://docs.cursor.com/account/api)
- [Pass-through Endpoints Overview](./intro.md)
- [Virtual Keys](../proxy/virtual_keys.md)

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/cursor-1) · https://claudary.paisolsolutions.com