provision_agent_identity
Provision a complete ENS identity for an AI agent in one call. Describe your agent's purpose and budget — get back recommended available names, a multi-step registration recipe (commit → register → set agent records), and ready-to-sign transaction data.
The registration recipe includes agent identity records (ENSIP-25: ai.agent, ai.purpose, ai.capabilities + ENSIP-26: agent-context) as a mandatory step — these records make the agent discoverable in the ENS Agents directory. ENSIP-25 agent-registration binding is included ONLY when an agentRegistry is provided; it is OPTIONAL — do not ask for or wait on a registry address / agent ID, and never block the launch on it. The recipe then OPTIONALLY mints the on-chain ERC-8004 agent identity via the register_agent tool (default route binds the agent to the name per ERC-8217, so it transfers with the name), and finishes with launch_hosted_agent — the gas-free, no-signature step that gives the agent a brain and takes it LIVE at namewhisper.ai/agent/.
IMPORTANT: The calling AI MUST execute all steps in the recipe, including the final set_ens_records step. Agent identity is not complete until the text records are on-chain.
Example: "DeFi trading bot, 0.05 ETH budget" → names like swiftswap.eth with full registration + identity setup instructions.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| purpose | Yes | What the agent does (e.g. "DeFi trading bot", "data analytics agent", "social media manager", "infrastructure monitor") | |
| budgetEth | No | Maximum budget in ETH for name acquisition (default: 0.1) | |
| preferences | No | Optional naming preferences | |
| agentRegistry | No | ENSIP-25 agent registry binding. If provided, the provisioning flow will include the agent-registration text record that links this ENS name to your on-chain agent identity. | |
| walletAddress | Yes | Agent wallet address (will own the name and sign transactions) |