Summary

The mplx agents fetch command reads the on-chain agent identity PDA for an MPL Core asset and displays registration info, lifecycle hooks, and the agent's built-in wallet (Asset Signer PDA).

Input: An MPL Core asset address (from agents register)
Output: Identity PDA, wallet PDA, registration URI, lifecycle hooks
No required flags: Only the asset address is required; --json is optional

Jump to: Quick Reference · Usage · Output · Notes

Quick Reference

Item	Value
Command	`mplx agents fetch <ASSET_ADDRESS>`
Required argument	`ASSET_ADDRESS` — the MPL Core asset to look up
Optional flags	`--json` — machine-readable output

Usage

Fetch agent identity

mplx agents fetch <ASSET_ADDRESS>

Output

Expected output (registered agent)

{
  registered: true,
  asset: '<asset_address>',
  owner: '<owner_address>',
  identityPda: '<identity_pda_address>',
  wallet: '<asset_signer_pda_address>',
  registrationUri: 'https://...',
  lifecycleChecks: { ... }
}

If the asset does not have a registered agent identity:

Expected output (not registered)

No agent identity found for this asset. The asset may not be registered.

Notes

The wallet field is the Asset Signer PDA — the agent's built-in wallet used for signing transactions and holding funds
The registrationUri points to the JSON document uploaded during registration containing the agent's name, description, services, and trust models
Use --json for machine-readable output