Tool inventory
What a paired agent can call. Every tool runs in the authenticated agent's scope.
Current as of this page
The catalogue grows. tools/list on your own endpoint is always the authoritative answer for what your agent has.
Accounts
| Tool | Purpose |
|---|---|
list_accounts |
List the agent's active accounts and public identifiers |
get_account |
Read public details for one scoped account |
reveal_credential |
Decrypt one non-wallet credential for the agent's own use |
citizenai_create_credential_reveal_link |
Create a one-time owner URL for a provisioned account's credentials |
Profile
| Tool | Purpose |
|---|---|
get_profile |
Read the agent's identity profile |
Provisioning
| Tool | Purpose |
|---|---|
provision_email |
Return or provision the agent's email account, including payment when required |
provision_phone |
Return or provision the agent's phone account, including payment when required |
provision_wallet |
Return or provision the agent's crypto wallet |
Sign-in
| Tool | Purpose |
|---|---|
create_citizenai_sign_in_code |
Issue a short-lived, one-use owner sign-in code |
Marketplace and integrations
| Tool | Purpose |
|---|---|
citizenai_browse_marketplace |
Search providers and resolve an explicit connect-existing or create-new intent |
citizenai_start_provider_connection |
Create a short-lived authorization handoff for one reviewed provider |
citizenai_list_connections |
List active provider connections assigned to the agent |
citizenai_list_tool_capabilities |
Rank accountless public-read tools for a query, with schema, affordability and price |
citizenai_search_tools |
Search approved tools within one assigned toolkit or accountless capability |
citizenai_get_tool_schema |
Retrieve a discovered tool's full input schema |
citizenai_execute_tool |
Execute through an assigned connection or an accountless public-read provider |
Internal wallet
| Tool | Purpose |
|---|---|
citizenai_wallet_balance |
Read internal USD balance, plus checkout availability and limits |
create_citizenai_wallet_top_up |
Create an owner-scoped, short-lived checkout for internal USD credit |
get_citizenai_wallet_top_up |
Read and reconcile one checkout's status, without returning the URL or provider secrets |
On-chain wallet
| Tool | Purpose |
|---|---|
wallet_balance |
Read the native-token balance |
wallet_usdc_balance |
Read the native USDC balance on a supported Base network |
wallet_send_eth |
Sign and broadcast a native-token transfer, server-side |
wallet_token_balance |
Read an ERC-20 balance |
wallet_token_transfer |
Sign and broadcast an ERC-20 transfer, server-side |
wallet_tx_status |
Read transaction receipt status |
Two hard rules
reveal_credentialrejects wallet credentials. Private keys are never returned.- On-chain wallet tools never receive internal checkout credit. The two money systems stay separate.
On this page