> For the complete documentation index, see [llms.txt](https://docs.panora.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panora.exchange/ai/cli.md).

# CLI

## CLI

[`@panora/cli`](https://www.npmjs.com/package/@panora/cli) is a TypeScript CLI that ships two binaries from one npm package:

| Binary           | What it is                                                              |
| ---------------- | ----------------------------------------------------------------------- |
| **`panora`**     | Human / scripting CLI with `--json` output mode                         |
| **`panora-mcp`** | Stdio MCP server for AI agents (Claude Code, Cursor, Codex, Gemini CLI) |

Designed to be LLM-friendly: non-interactive, JSON-native, deterministic output, no TTY prompts mid-command.

### Install

```bash
npm install -g @panora/cli

# Or run without installing
npx @panora/cli --help
npx -y -p @panora/cli panora-mcp     # start the MCP server
```

### First run

The CLI ships with a bundled shared API key — works on a fresh machine, no setup.

```bash
panora quote APT USDC 1 --json
panora prices APT USDC --json
panora tokens ls --json
panora whoami
```

Bring your own key for a higher tier:

```bash
panora apikey set panora_...
```

### Command groups

| Group             | Description                                     |
| ----------------- | ----------------------------------------------- |
| `panora swap`     | Execute a swap — signs and submits              |
| `panora quote`    | Get a swap quote (read-only)                    |
| `panora dca`      | DCA orders — create / list / cancel             |
| `panora limit`    | Limit orders — create / list / cancel           |
| `panora prices`   | Live token prices                               |
| `panora tokens`   | List / search / info                            |
| `panora balances` | Wallet balances                                 |
| `panora markets`  | Markets / terminal data                         |
| `panora charts`   | Chart pair mappings                             |
| `panora account`  | `add` / `import` / `generate` / `ls` / `remove` |
| `panora config`   | Manage CLI config                               |
| `panora apikey`   | Manage the Panora API key                       |
| `panora whoami`   | Show the active wallet                          |
| `panora sign`     | Sign an unsigned tx                             |

Run `panora <group> --help` for sub-command detail.

### Use as an MCP server

The same CLI install gives you `panora-mcp`. Wire it into Claude Code:

```bash
claude mcp add --scope user --transport stdio \
  -- panora npx -y -p @panora/cli panora-mcp
```

Full setup for every client → MCP Servers.

### Pair with the agent skill

```bash
npx skills add panora-exchange/agent-skills --skill panora
```

Now your agent knows when to use which command vs. which MCP tool.

### Resources

* [`@panora/cli` on npm](https://www.npmjs.com/package/@panora/cli)
* [README — auth chain, storage model, security](https://github.com/panora-exchange/cli)
* [Agent skill source](https://github.com/panora-exchange/agent-skills)s