> 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.panora.exchange/ai/cli.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.