Setup
Install the CLI and sign in once:.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
What the agent gets
Nineteen curated tools covering the golden paths (create and run agents, follow runs withwait_for_run, skills, storage, publishing, usage) plus api_request, a raw authenticated escape hatch to every /api/* operation, self-documented by the orca://openapi resource.
Headless login inside Cursor
orca login detects agent contexts (including Cursor) and uses the device flow automatically: it prints a one-time code and a URL to approve on any device, then stores the key itself. For scripted setups, export ORCA_API_KEY instead; details in Headless authentication.