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.
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
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 |