Mint an on-chain agent into the Metaplex Agent Registry
mint_onchain_agentDeploy an AI agent on Solana by minting a Metaplex Core asset and registering its EIP-8004 identity, visible on metaplex.com/agents with a built-in wallet.
Instructions
Deploy an AI agent on-chain, Genesis-333 style: mints a Metaplex Core asset (data: URI metadata, verified creator, royalties, immutable metadata) AND registers its EIP-8004 Agent Identity, so it appears on metaplex.com/agents with its own built-in wallet. Runs as ONE atomic transaction when it fits Solana's 1232-byte limit, otherwise as create followed by register (how the Genesis 333 landed). Signs with the configured SOLANA_SECRET_KEY (or a per-call secret) and spends ~0.007 SOL in rent + fees, plus a flat SOL deploy fee on mainnet that funds $THREE buybacks (holding $THREE halves it, then waives it; devnet is free; see three_status). The fee rides in the same transaction as the mint, so a failed mint pays nothing. Without confirm:true it returns a full preview (both JSON documents, the paying wallet, every cost line including the fee and its recipient) and broadcasts NOTHING. For Phantom/Solflare users, use prepare_agent_mint.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Agent name. Becomes the Core asset name and the registration name. | |
| image | No | Thumbnail/avatar image URL (PNG or similar). Shown on metaplex.com/agents, wallets, and explorers. | |
| owner | No | Mint the asset to this owner instead of the signing wallet. | |
| active | No | Registration active flag. Default true. | |
| secret | No | Per-call signing key (base58 secret key or JSON byte array). Overrides SOLANA_SECRET_KEY. | |
| confirm | No | Must be true to broadcast. Anything else returns a spend-nothing preview. | |
| network | No | Solana cluster. Defaults to the configured network (mainnet unless overridden). | |
| services | No | Services the agent offers, listed on its Metaplex agent page ({name, endpoint}). | |
| model_url | No | 3D model URL (GLB). Written as the asset metadata animation_url and as model.uri in the registration, Genesis style. | |
| attributes | No | On-chain Attributes plugin entries (real bytes in the asset account). | |
| collection | No | Mint into this Metaplex Core collection. The signer must be the collection authority. | |
| add_blocker | No | Attach AddBlocker so no further plugins can be added. Default false. | |
| description | No | What this agent is or does. Stored in the EIP-8004 registration document. | |
| external_url | No | Optional external_url in the asset metadata (e.g. the agent home page). | |
| metadata_uri | No | Full override for the asset metadata URI (https or data:). Skips the built-in metadata builder. | |
| x402_support | No | Advertise x402 payment support in the registration document. Default false. | |
| registrations | No | External registry registrations. Defaults to the chain registry entry, or the three.ws entry when threews_agent_id is set. | |
| permanent_burn | No | Attach PermanentBurnDelegate. Default false. | |
| supported_trust | No | Trust models the agent supports. Default ['reputation'] (Genesis style). | |
| permanent_freeze | No | Attach PermanentFreezeDelegate (unfrozen). Default false. | |
| registration_uri | No | Full override for the Agent Identity registration URI (https or data:). Skips the built-in registration builder. | |
| royalty_creators | No | Royalty split. Percentages must sum to 100. Defaults to the signing wallet at 100%. | |
| threews_agent_id | No | three.ws agent UUID. Adds the Genesis-exact registration entry {agentId, agentRegistry: "https://three.ws"}. | |
| verified_creator | No | Attach the VerifiedCreators plugin with the signing wallet verified. Default true (Genesis style). | |
| immutable_metadata | No | Attach the ImmutableMetadata plugin so the metadata can never change. Default true (Genesis style). | |
| permanent_transfer | No | Attach PermanentTransferDelegate. Default false. | |
| metadata_attributes | No | Off-chain attributes array inside the asset metadata JSON (trait_type/value pairs). | |
| royalty_basis_points | No | Royalty in basis points. Default 500 (5%), the Genesis value. 0 removes the Royalties plugin. |