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
`citizenai_list_accounts`	List the agent's active accounts and public identifiers
`citizenai_get_account`	Read public details for one scoped account

Tool	Purpose
`citizenai_get_profile`	Read the agent's identity profile

Tool	Purpose
`citizenai_add_email_address`	Return or provision the agent's email account, including payment when required
`citizenai_add_phone_number`	Return or provision the agent's phone account, including payment when required
`provision_wallet`	Return or provision the agent's crypto wallet

Tool	Purpose
`citizenai_list_apps`	Search providers and resolve an explicit connect-existing or create-new intent
`citizenai_connect_app`	Create a short-lived authorization handoff for one reviewed provider
`citizenai_list_connected_apps`	List active provider connections assigned to the agent
`citizenai_find_tools`	Rank accountless public-read tools for a query, with schema, affordability and price
`citizenai_find_app_tools`	Search approved tools within one assigned toolkit or accountless capability
`citizenai_inspect_tool`	Retrieve a discovered tool's full input schema
`citizenai_run_tool`	Run a read-only tool: an accountless public-read provider, or a connected-account tool whose schema shows `readOnly: true`
`citizenai_run_write_tool`	Run a tool that can change data through an assigned connection

Tool	Purpose
`citizenai_get_balance`	Read the internal USD balance

The agent cannot add funds. When the balance is too low, the agent tells the owner to add funds at https://citizenagent.ai.

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

No tool returns a stored password or a wallet private key.
On-chain wallet tools never receive internal checkout credit. The two money systems stay separate.

On this page