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

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_credential rejects 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