// cli

The rocketsloth CLI

Every Rocket Sloth MCP tool as a subcommand. Install once, login with your token, and apply, integrate, report, and manage payouts from the terminal.

Install

One line on Linux and macOS. The script detects your OS and architecture, downloads the matching binary, installs it to ~/.local/bin/rocketsloth, and adds an rs alias when that name is free on your PATH.

curl -fsSL https://rocketsloth.ai/install.sh | sh

Prefer to download a binary directly (or on Windows)? Grab the artifact for your platform, make it executable, and put it on your PATH:

PlatformDownload
Linux (x86_64)rocketsloth-linux-amd64
Linux (arm64)rocketsloth-linux-arm64
macOS (Intel)rocketsloth-darwin-amd64
macOS (Apple silicon)rocketsloth-darwin-arm64
Windows (x86_64)rocketsloth-windows-amd64.exe

Quickstart

No token yet? apply needs none — it returns your application token. Already have one (at_... or sk_...)? Save it once and every command picks it up.

rocketsloth about                                            # the tool catalog, no auth
rocketsloth apply --site https://example.com --email [email protected] --agent-name "My Agent"
rocketsloth login at_...                                     # validate + save the token
rocketsloth integration                                      # your script tag + ad units
rocketsloth status                                           # poll for approval
rocketsloth reporting --start 2026-07-01 --end 2026-07-30    # after approval (sk_)

Commands

Each command calls the MCP tool of the same name (statusapplication_status, ad-settingsad_settings). rocketsloth help <command> shows a command’s flags.

CommandAuthWhat it does
aboutnoneWhat Rocket Sloth is; the full tool catalog.
ask --question "…" [--thread-id …]noneAsk the setup agent about integration, ads, or payments.
apply --site … --email … --agent-name … [--google-email …] [--description …]noneApply as a publisher; returns an application token (at_...).
recover --action start|confirm --site … [--code …]noneRecover lost tokens via a code emailed to the account owner.
reclaim --action start|verify --site … [--method dns|file|meta]noneFree a site with an inactive previous registration.
statusat_Check application status; returns the API token (sk_...) once on approval.
integration [--verify]at_/sk_Script tag, ad-unit markup, placement guidance, ads.txt target.
checklistat_/sk_Onboarding checklist with every step’s status and the next action.
reporting [--action …] [--start YYYY-MM-DD] [--end YYYY-MM-DD]sk_Revenue and traffic reporting.
payments [--action settings|history]sk_Payout method name and threshold, amount owed, payout history.
account [--action view|update|rotate_token] [--email …] [--agent-name …]sk_View or update your account; rotate the API token.
video [--resource …] [--action …] [--param k=v …]sk_Manage video monetization; no --resource lists what’s available.
subscriptions [--resource …] [--action …] [--param k=v …]sk_Manage reader subscriptions and donations.
ad-settings [--resource …] [--action …] [--param k=v …]sk_View and adjust ad settings (anchor, video formats, rewarded, …).
login <token> / logoutSave or remove the token used by every other command.
version / helpPrint the CLI version / help text.

Flags, tokens, and environment

Tools print their JSON payload to stdout; failures go to stderr with a non-zero exit code.

Flag / variableWhat it does
--tokenToken for this call only; wins over everything else.
--jsonPrint the full MCP result envelope instead of just the text content.
ROCKETSLOTH_TOKENToken used when --token is absent.
ROCKETSLOTH_URLOverride the server origin (default https://rocketsloth.ai).
~/.config/rocketsloth/config.jsonThe saved login (mode 0600), written by rocketsloth login.

Token precedence: --token flag > ROCKETSLOTH_TOKEN > the saved login file.

The agent skill

Building an agent that can’t reach the MCP server directly? Give it the Rocket Sloth skill file (/skill.md) — a SKILL.md that teaches the full workflow: apply, integrate, approval, reporting, payouts, and recovery. MCP config and connect options live on the connect page.