> ## Documentation Index
> Fetch the complete documentation index at: https://docs.percio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the agent

> Install the Percio CLI and MCP server

The agent ships as a single npm package that installs both the CLI and the MCP server.

## Requirements

* **Node.js ≥ 18** — check with `node --version`.
* A Percio account and an API key (see [Authentication](/agent/authentication)).

## Install

```bash theme={null}
npm install -g @percio/agent
```

This installs two binaries globally:

* `percio` — the CLI.
* `percio-mcp` — the MCP server used by Cursor and other MCP-capable clients.

## Verify

```bash theme={null}
percio --version
```

should print a version number. If you get `command not found`, your global npm bin isn't on your `PATH`. Run `npm config get prefix` — the `bin` directory inside that prefix needs to be on your `PATH`.

## Upgrade

```bash theme={null}
npm install -g @percio/agent@latest
```

## Uninstall

```bash theme={null}
npm uninstall -g @percio/agent
```

This removes both `percio` and `percio-mcp`. Your stored credentials at `~/.config/percio/credentials.json` are **not** removed — delete that file manually if you want a clean slate.

## What's next

* [Authenticate](/agent/authentication)
* [Run your first test](/agent/cli/test)