Use the Cursor CLI from KosmoKrator to call Cursor tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.
Cursor can be configured headlessly with `kosmokrator integrations:configure cursor`.
# Install KosmoKrator first if it is not available on PATH.curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash# Configure and verify this integration.kosmokrator integrations:configure cursor --set api_key="$CURSOR_API_KEY" --enable --read allow --write ask --jsonkosmokrator integrations:doctor cursor --jsonkosmokrator integrations:status --json
Credentials
Authentication type: API keyapi_key. Configure credentials once, then use the same stored profile from
scripts, coding CLIs, Lua code mode, and the MCP gateway.
Key
Env var
Type
Required
Label
api_key
CURSOR_API_KEY
Secret secret
yes
API Key
url
CURSOR_URL
URL url
no
API URL
Call Cursor Headlessly
Use the generic call form when another coding CLI or script needs a stable universal interface.
Every function below can be called headlessly. The generic form is stable across all integrations;
the provider shortcut is shorter but specific to Cursor.
cursor.cursor_list_workspaces
Read read
List all Cursor workspaces accessible to the authenticated user. Returns workspace IDs you can use with other Cursor tools.
Headless calls still follow the integration read/write permission policy. Configure read/write defaults
with integrations:configure. Add --force only for trusted automation that should bypass that policy.