Quickstart

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 250 credits when signup grants are enabled; Free has no monthly refill. Check oxygen billing balance --json for your available credits. Connecting an account to send or publish from — a mailbox, LinkedIn, X or WhatsApp account, or a phone number — buying managed inboxes, and using your own provider keys need a paid plan, whatever your credit balance; sending and publishing go through those accounts. oxygen billing estimate --json reports how a connected account is billed under sender_billing: credit_reservations (a monthly credit reservation) or sending_seats.

From the CLI

Requires Node.js >=22.22.0 and npm >=10.9.0.

npm install -g @oxygen-agent/cli
oxygen login

A 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" --json

Every command is in the CLI reference.

From an MCP client

Point any MCP-capable client at the hosted server:

https://oxygen-agent.com/mcp

Authenticate 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/mcp

Then 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.

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 --json

Recipes transfer the operating judgment for a proven business case; the app shows them as plays under Settings → Plays. Blueprints describe installable Tables, Workflows, and other workspace resources; the app shows them as templates under Workflows. 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.