# CLI and MCP

> What the CLI and the MCP server each do, tool by tool and command by command.

<Callout title="In brief">

- The [CLI](/docs/cli) (`npx extraorbital`) and the [MCP server](/docs/mcp) (`https://extraorbital.dev/mcp`) have the same features.
- Previews and branches are on the MCP server only, with the tools that act on a preview's files and the cards drawn in a conversation.
- What needs your machine is on the CLI only: the folder and its `.env`, your browser, a resource's password. So is everything that hands out or replaces a credential: credentials never come back over MCP.

</Callout>

Every row below comes from one map in the CLI's code (`platform/cli/src/parity.ts`). A test fails when a command or a tool is added without a row, so this page stays true.

{/* parity:start — generated from platform/cli/src/parity.ts: npm run docs:parity */}

## On both

| MCP tool | CLI | Note |
|---|---|---|
| `whoami` | `extraorbital whoami` |  |
| `upgrade_to_paid` | `extraorbital upgrade` |  |
| `usage` | `extraorbital usage`, `extraorbital ledger` | `usage` with lines: true is `ledger`. |
| `credits` | `extraorbital credits` | Read only on both: credit is bought, and auto-reload changed, in the dashboard. |
| `list_teams` | `extraorbital teams` |  |
| `create_team` | `extraorbital teams new` |  |
| `update_team` | `extraorbital teams update` |  |
| `team_members` | `extraorbital teams members` |  |
| `invite_member` | `extraorbital teams add-member` |  |
| `remove_member` | `extraorbital teams remove-member` |  |
| `list_projects` | `extraorbital projects` |  |
| `list_services` | `extraorbital catalog` |  |
| `create_project` | `extraorbital projects new` | The MCP also starts the project's `default` preview; the CLI creates the project only. |
| `get_project` | `extraorbital projects show` |  |
| `git_info` | `extraorbital git` |  |
| `list_resources` | `extraorbital list` |  |
| `set_lifetime` | `extraorbital lifetime` |  |
| `set_backup_policy` | `extraorbital backups policy` |  |
| `list_backups` | `extraorbital backups` |  |
| `backup_resource` | `extraorbital backup` |  |
| `env_add` | `extraorbital add` | The MCP sets the variables on a preview; the CLI writes them to the folder's `.env`. |
| `deploy` | `extraorbital deploy` | The MCP deploys a preview; the CLI deploys a folder. |
| `list_deployments` | `extraorbital deployments` |  |
| `deployment_status` | `extraorbital deployments` | `deployments` gives every version's status; `deploy` waits for its own build. |
| `deployment_logs` | `extraorbital logs --prod` |  |
| `rollback` | `extraorbital rollback` |  |
| `check_domain` | `extraorbital domains check` |  |
| `buy_domain` | `extraorbital domains buy` |  |
| `add_domain` | `extraorbital domains attach` |  |
| `set_primary_domain` | `extraorbital domains primary` |  |
| `domain_status` | `extraorbital domains verify`, `extraorbital domains inspect` |  |
| `retry_domain` | `extraorbital domains retry` |  |
| `list_domains` | `extraorbital domains`, `extraorbital domains --all` |  |
| `set_auto_renew` | `extraorbital domains auto-renew` |  |
| `renew_domain` | `extraorbital domains renew` |  |
| `remove_domain` | `extraorbital domains detach` |  |
| `list_dns_records` | `extraorbital dns ls` |  |
| `add_dns_record` | `extraorbital dns add` |  |
| `remove_dns_record` | `extraorbital dns rm` |  |
| `list_emails` | `extraorbital emails`, `extraorbital emails status` |  |
| `enable_emails` | `extraorbital emails enable` |  |
| `set_email_forward` | `extraorbital emails forward` |  |
| `remove_email_forward` | `extraorbital emails rm` |  |
| `disable_emails` | `extraorbital emails disable` |  |
| `search` | `extraorbital docs` |  |
| `fetch` | `extraorbital docs read` |  |
| `list_snippet_platforms` | `extraorbital snippets platforms` |  |
| `list_snippet_actions` | `extraorbital snippets actions` |  |
| `get_snippet` | `extraorbital snippets` |  |
| `send_feedback` | `extraorbital feedback` |  |

### What only one side of a shared command does

| CLI | Note |
|---|---|
| `extraorbital add` | A local secret (`add SESSION_SECRET`, `add JWT_PRIVATE_KEY`) is the CLI's only: it is generated on this machine. |
| `extraorbital teams` | `teams switch` (this machine's default team) is the CLI's only. |
| `extraorbital projects` | `projects rm` is the CLI's only: the MCP server deletes no project. |
| `extraorbital backup` | A sensitive resource without a backup credential is backed up from the CLI only: it needs the password. |
| `extraorbital backups` | `backups download` and `backups sync` write files to a folder on this machine: the CLI's only. |
| `extraorbital deploy` | `deploy --check` (the variables production lacks, from the folder's code) is the CLI's only. |
| `extraorbital logs` | Production's only (`--prod`): a preview's logs are the MCP's `logs`. |

## MCP only

| MCP tool | Why |
|---|---|
| `list_features` | slices.sh features are code added to a preview (create_project, add_feature): previews are on the MCP server only. |
| `list_previews` | Acts on a preview: previews are on the MCP server only. |
| `create_preview` | Acts on a preview: previews are on the MCP server only. |
| `delete_preview` | Acts on a preview: previews are on the MCP server only. |
| `Read` | A file tool on a preview VM: previews are on the MCP server only. |
| `Write` | A file tool on a preview VM: previews are on the MCP server only. |
| `Edit` | A file tool on a preview VM: previews are on the MCP server only. |
| `MultiEdit` | A file tool on a preview VM: previews are on the MCP server only. |
| `ApplyPatch` | A file tool on a preview VM: previews are on the MCP server only. |
| `Glob` | A file tool on a preview VM: previews are on the MCP server only. |
| `Grep` | A file tool on a preview VM: previews are on the MCP server only. |
| `LS` | A file tool on a preview VM: previews are on the MCP server only. |
| `Tree` | A file tool on a preview VM: previews are on the MCP server only. |
| `Bash` | Runs a command on a preview VM: previews are on the MCP server only. On this machine, it is your own shell. |
| `typecheck` | Runs tsc on a preview VM: previews are on the MCP server only. |
| `logs` | A preview's logs: previews are on the MCP server only. Production's are `logs --prod` (`deployment_logs`). |
| `restart_preview` | Acts on a preview: previews are on the MCP server only. |
| `preview_login` | Acts on a preview: previews are on the MCP server only. |
| `add_feature` | Writes slices.sh features into a preview's code: previews are on the MCP server only. |
| `add_collection` | Writes a collection into a preview's code: previews are on the MCP server only. |
| `env_set` | A preview's environment variables: previews are on the MCP server only. A folder's are its `.env`, which `add` and `provision` write. |
| `show_preview` | A card drawn in the conversation (Claude, ChatGPT). Previews are on the MCP server only. |
| `show_deployment` | A card drawn in the conversation (Claude, ChatGPT). `deploy` prints the build as it runs. |
| `show_errors` | A card drawn in the conversation (Claude, ChatGPT). `logs --prod --unread` prints production's unread errors. |
| `show_domain_options` | A card drawn in the conversation (Claude, ChatGPT). `domains check` prints the same names and prices. |
| `show_domain` | A card drawn in the conversation (Claude, ChatGPT). `domains inspect` prints the same setup. |
| `show_versions` | A card drawn in the conversation (Claude, ChatGPT). `deployments` prints the same versions. |
| `open_console` | A card drawn in the conversation (Claude, ChatGPT). A preview's live site beside the chat: previews are on the MCP server only. |

## CLI only

| CLI | Why |
|---|---|
| `extraorbital provision` | Reads the folder's code for the variables it needs and writes them to `.env`. |
| `extraorbital push` | Sends the folder's `.env` to where the app runs (Vercel, a file, CI): credentials, which never come back over MCP. |
| `extraorbital remote` | What reads the variables `push` sent, and `remote verify` run from CI: credentials, which never come back over MCP. |
| `extraorbital remove` | Deletes a resource and its entries in `.env`. The MCP server deletes no resource. |
| `extraorbital migrate` | Moves a legacy resource (mongo) to the managed provider and rewrites its connection string in `.env`. |
| `extraorbital login` | Connects this machine's identity to an account. The MCP signs in with OAuth. |
| `extraorbital logout` | Signs this machine out. |
| `extraorbital link` | Links a folder to a project (`.extraorbital.json`). |
| `extraorbital open` | Opens the dashboard in this machine's browser. The MCP draws cards instead. |
| `extraorbital operations` | Lists a resource's lifecycle operations (restores, clones, rotations…), most of which only the CLI starts; on the MCP, `list_backups` shows a backup's state. |
| `extraorbital operation` | Follows one lifecycle operation, sending a sensitive resource's key when it waits for one. |
| `extraorbital cancel` | Stops a lifecycle operation the CLI started. |
| `extraorbital delete` | Deletes a resource and reports what is left. The MCP server deletes no resource. |
| `extraorbital restore` | Replaces a resource's data, or makes a new resource whose credentials go to `.env`; an encrypted backup needs the resource's password. |
| `extraorbital clone` | Makes a new resource whose credentials go to `.env`: credentials never come back over MCP. |
| `extraorbital freeze` | Stops a resource answering, production's included: kept off the agent's tools, like deleting. |
| `extraorbital unfreeze` | Lets a frozen resource answer again; a sensitive one needs its password. |
| `extraorbital rotate` | Replaces credentials and writes the new ones to `.env` and pushed destinations: credentials never come back over MCP. |
| `extraorbital credentials` | Lists, creates and reveals credentials: they never come back over MCP. |
| `extraorbital run` | Runs a program on this machine with the credentials in its environment. |
| `extraorbital protect` | Needs the resource's password, typed on this machine; it never leaves it. |
| `extraorbital unprotect` | Needs the resource's password, typed on this machine; it never leaves it. |
| `extraorbital rekey` | Needs the resource's password, typed on this machine; it never leaves it. |
| `extraorbital reset-key` | Needs the resource's password, typed on this machine; it never leaves it. It also replaces every credential. |
| `extraorbital backup-credential` | Needs the resource's password, typed on this machine; it never leaves it. |
| `extraorbital love` | This machine's beneficiary, kept in `~/.extraorbital` and sent with `login`. |
| `extraorbital version` | The CLI's own version, and the server it talks to. |

{/* parity:end */}

---

More for agents: [Sitemap](https://extraorbital.dev/sitemap.md) · [llms.txt](https://extraorbital.dev/llms.txt) · [agents.md](https://extraorbital.dev/agents.md)
