Cursor Cloud Agents
Overview
Cursor Cloud Agents
Pass-through endpoints for the Cursor Cloud Agents 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 |
| 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.
2. Launch a Cursor Agent
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:
{
"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.
Click on any log entry to see full request details including provider, API base, and metadata.
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
curl http://0.0.0.0:4000/cursor/v0/models \\
-H "Authorization: Bearer <your-litellm-key>"
Check Agent Status
curl http://0.0.0.0:4000/cursor/v0/agents/bc_abc123 \\
-H "Authorization: Bearer <your-litellm-key>"
List All Agents
curl http://0.0.0.0:4000/cursor/v0/agents \\
-H "Authorization: Bearer <your-litellm-key>"
Add Follow-up to Agent
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
curl -X POST http://0.0.0.0:4000/cursor/v0/agents/bc_abc123/stop \\
-H "Authorization: Bearer <your-litellm-key>"
Delete an Agent
curl -X DELETE http://0.0.0.0:4000/cursor/v0/agents/bc_abc123 \\
-H "Authorization: Bearer <your-litellm-key>"
Get API Key Info
curl http://0.0.0.0:4000/cursor/v0/me \\
-H "Authorization: Bearer <your-litellm-key>"