Quickstart
Three ways to connect — the CLI, an MCP client, or an AI assistant. Pick one and start asking for what you want.
All three reach the same workspace, the same approvals, and the same credit balance.
Signing up lands you in a working workspace on the free tier — no card required, no trial deadline. Eligible billing owners receive a one-time grant of 1,000 credits when signup grants are enabled; Free has no monthly refill. Check oxygen billing balance --json for your available credits. Sending, supported publishing and managed email purchases use credits on Free when oxygen billing estimate --json reports sender_billing: credit_reservations; the legacy model also requires a paid plan and sending seats. Your own provider keys and Instagram, TikTok, YouTube and Facebook publishing still require a paid plan.
From the CLI
Requires Node.js >=22.22.0 and npm >=10.9.0.
npm install -g @oxygen-agent/cli
oxygen loginA global install keeps itself up to date; see Updates to check the version or pin a build server.
oxygen login opens your browser and shows a confirmation code — approve the terminal there and it connects. No browser? Create a token under Settings → CLI and MCP and run the oxygen login --token <token> command it shows.
Now describe what you want. The CLI ships its own discovery, so you do not need to memorise commands:
oxygen capabilities search "find companies hiring sales reps" --json
oxygen commands search "import a csv" --jsonEvery command is in the CLI reference.
From an MCP client
Point any MCP-capable client at the hosted server:
https://oxygen-agent.com/mcpAuthenticate with OAuth in the client, or a bearer token from Settings → CLI and MCP. Then ask for what you want in plain language — the client picks the tools.
A fresh connection sees the core tools. Find any other customer tool with oxygen_capabilities_search, inspect its arguments with oxygen_capabilities_schema, then run it through oxygen_capabilities_read or oxygen_capabilities_call. A domain pack (?toolset=<pack>) optionally lists its tools directly. Every tool is in the MCP reference.
Client-specific setup: Claude Code, Claude Desktop, Claude Cowork, Codex, Cursor, any other client.
With an AI assistant
Same connection as above, with the assistant driving.
claude mcp add --transport http oxygen https://oxygen-agent.com/mcpThen talk to it:
Build me a list of Seed-stage B2B SaaS companies in the US that are hiring their first AE, find work emails, and show me what it will cost before you run anything.
The assistant plans the work, previews the spend, and asks before anything paid or outbound happens. You approve or you don't.
Anything that spends credits or reaches a real person previews first. Read the preview, then approve it on purpose — --approved with --max-credits <n> from the CLI, or the button in the app.
Choose a Recipe or Blueprint
Connected, and not sure what to run? Browse the catalogs and choose the outcome that fits your workspace.
oxygen recipes list --json
oxygen blueprints list --jsonRecipes transfer the operating judgment for a proven business case. Blueprints describe installable Tables, Workflows, and other workspace resources. Inspect the selected item before applying or running it; paid work and external actions still require their own preview and approval.
Next
The guides walk the whole journey: source leads, enrich them, set up sending, launch a sequence, handle replies, and track deals.