cursor2api#

cursor2api bridges Cursor IDE's AI models with OpenClaw/Claude Code by converting Cursor's internal API into standard Anthropic/OpenAI formats.

Architecture:

text

OpenClaw / Claude Code
         ↓ (ANTHROPIC_BASE_URL)
cursor2api Docker/Node (:3010)
         ↓ (Session Token)
Cursor Official API

Prerequisites#

• Docker (for containerized deployment) or Node.js 18+ (for local)
• A Cursor account with active AI subscription
• WorkosCursorSessionToken from Cursor

Quick Start#

bash

# 1. Get your WorkosCursorSessionToken (see references/token.md)

# 2. Start the service
docker run -d \
  --name cursor-api \
  -p 3010:3000 \
  -e WORKOS_CURSOR_SESSION_TOKEN=your_token \
  waitkafuka/cursor-api:latest

# 3. Configure OpenClaw
export ANTHROPIC_BASE_URL="http://localhost:3010/v1"
export ANTHROPIC_API_KEY="your_token"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"

# 4. Restart OpenClaw
openclaw gateway restart

Core Operations#

OperationCommandInstalldocker run -d --name cursor-api -p 3010:3000 -e WORKOS_CURSOR_SESSION_TOKEN=token waitkafuka/cursor-api:latestStatusdocker ps | grep cursor-apiRefresh TokenSee references/token.mdUninstalldocker stop cursor-api && docker rm cursor-api

API Endpoints#

EndpointFormatCompatible Withhttp://localhost:3010/v1/messagesAnthropic Messages APIOpenClaw, Claude Codehttp://localhost:3010/v1/chat/completionsOpenAI Chat CompletionsCC Switch, Universal

Documentation#

DocumentDescriptionInstallation GuideDocker deployment, verification, troubleshootingToken ManagementObtaining and refreshing WorkosCursorSessionTokenConfigurationOpenClaw, Claude Code, CC Switch setupQuick ReferenceOne-page cheat sheet

⚠️ Important Notes#

• ToS Risk: Using third-party proxies may violate Cursor's Terms of Service
• Token Expiry: Session tokens expire periodically; monitor and refresh as needed
• API Stability: Cursor's internal API may change without notice