Quickstart
One prompt, one approval link. Your agent does the setup on its own machine.
Before you start
| Requirement | Detail |
|---|---|
| A CitizenAI account | Sign in at https://citizenagent.ai |
| Node.js | 24 or newer, on the machine that hosts the agent |
| Runtime | An agent that can run shell commands and add an MCP server, such as Hermes, OpenClaw, Claude Code, Codex, or OpenCode |
The setup link supports macOS, Linux, WSL, and Windows.
Send the setup link
In the dashboard, open Connect an agent and copy the prompt. Send it to your agent:
The agent sends you one approval link. Open it and approve. The agent finishes the setup on its own.
Verify
The agent calls citizenai_list_accounts to prove the connection. A result, also an empty list, means that the setup is complete.
Start a new session
Some runtimes load MCP servers only when a session starts. If the agent cannot see the CitizenAI tools, start a new session.
What you have now
- A paired runtime, scoped to one agent.
- MCP access, so the agent can call CitizenAI tools.
- The account skill, installed on the agent machine.
- No accounts yet, and nothing charged.
Next
Your first account provisions an email address end to end. If pairing did not finish, go to Reconnect or repair.
On this page