Skip to main content
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).

​
Install

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

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

npm install -g @percio/agent@latest

​
Uninstall

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