Give your agent real-world accounts

CitizenAI holds the identity, the credentials and the approvals. Your agent gets scoped access to the accounts you decide it should have — nothing more.

Pair Hermes, provision the email addresses, phone numbers, wallets and social accounts your agent needs, and keep every approval on your side of the line. OpenClaw pairing is coming soon.

Quickstart

Run this on the machine that hosts the agent.

curl -fsSL https://api.citizenagent.ai/api/install | bash
citizenai pair --runtime hermes
# open the approval link it prints, then
citizenai status --runtime hermes

A paired runtime reports paired, a reachable MCP endpoint, and an installed signup worker.

Step	What it did
Install	Fetched the CLI from the same API your agent will call. The installer is content-addressed — no repository checkout, no package-registry credential.
Pair	Started a device authorization on your machine. You approved one link; the short code was already embedded in it.
Verify	Confirmed MCP access, the account skill, and the signup worker all landed.

Pairing buys nothing. Paid provisioning is approved separately, every time.

Connect your agent walks the same path with the failure cases attached.

Everything in these docs

Section	What it covers
Start here	What the product is, what it deliberately does not do, and one account end to end.
Connect a runtime	Pair Hermes, the `citizenai` CLI, and keeping a runtime paired. OpenClaw is coming soon.
Marketplace	Twelve categories, and the three ways an agent gets into a service.
Accounts	Email, phone, crypto wallets, social accounts, identity, credentials.
Live signup	Watch the browser work, take over when a page needs you, hand it back.
Payments	Fund in USD or USDC, and read the record of every purchase.
Agent access	The `/mcp` endpoint and the tools your agent is given.
Reference	Troubleshooting, health, supported versions, terms.

All pages lists every page on this site, and names what is deliberately not here.

What your agent can be given

Capability	What your agent gets	How it arrives
Email addresses	A mailbox it can read verification codes from	Paid
Phone numbers	A rented number for SMS codes, one service at a time	Paid
Crypto wallets	A server-custodied wallet, with balances and transfers	Provisioned
Social accounts	A signup run in a real browser you can watch and take over	Live
Provider connections	Reviewed third-party tools, connected without sharing keys	Reviewed

How it fits together

Your machine                      CitizenAI                     The real world
Hermes (OpenClaw soon) ──MCP──▶   identity, credentials,   ──▶   email, phone, wallet,
signup worker          ──jobs─▶   approvals, payments            social, provider tools
                       ◀─video──  live preview relay

Every connection is outbound, from your machine to CitizenAI. CitizenAI never opens a connection into your runtime, and it does not store a gateway URL.

How it fits together covers each path, and what travels over it.

When something breaks

Symptom	Start here
The agent shows as offline	Reconnect or repair
A verification code never arrived	When a signup fails
`Provider unavailable.` at checkout	Service purchases
A signup is stuck waiting for you	Taking over

On this page

Give your agent real-world accounts#

Quickstart#

Everything in these docs#

What your agent can be given#