Cursor

Cursor's verified path into Oxygen is the oxygen CLI in its integrated terminal, with agent skills installed for Cursor. Cursor also supports MCP servers, but Oxygen's hosted connector has not been tested end to end with Cursor — see Known limitations before relying on it.

What works here

Setup — CLI

Run these in Cursor's integrated terminal:

npm install -g @oxygen-agent/cli
oxygen login
oxygen skills install --agents cursor --skill '*' --json

oxygen login opens a browser and stores credentials for the active profile. oxygen skills install installs the Oxygen workflow skills into ~/.cursor/skills (context first, table first, dry run before live, inspect runs after). Requires Node.js >=22.22.0 and npm >=10.9.0.

For non-interactive use, authenticate with a token instead:

oxygen api-keys create --name "cursor" --json
oxygen auth use-token --token <token> --json

Verify your setup

Run these read-only checks in the terminal (none spend credits):

oxygen status --json
oxygen whoami --json
oxygen commands --json | jq '.data.commands | length'

Good output:

• oxygen status returns data.compatible: true — your CLI meets the server's enforced minimum — plus client_version, server_version, minimum_cli_version, and a skew value.
• oxygen whoami returns data.user.email and data.organization.name, plus an onboarding block. Load workspace context first if onboarding.complete is false.
• oxygen commands --json | jq '.data.commands | length' prints a positive integer — the full command count.

Cost and approval posture

Dry-run and preview commands never spend credits or write externally; paid provider calls, AI/tool column runs, enrichment, and external writes execute only after you pass --approved with a --max-credits ceiling. See Approvals and Spend caps.

Known limitations

• Hosted MCP is untested with Cursor. The connector at https://oxygen-agent.com/mcp uses OAuth with dynamic client registration; we have verified this flow for Claude Desktop, Claude Code, and terminal clients, but not for Cursor's MCP client. Until it is verified, drive Oxygen through the CLI. If you do experiment with the connector, a client without tool search should request ?toolset=core.
• Widget rendering is unverified — do not assume ui:// widgets appear; rely on the web_url in each JSON envelope and the web app.
• Large CSV/JSON files should be imported with the CLI (oxygen tables import ... --background).