MAWS API
MCP server tools exposed by MAWS (Maroo Agent Wallet Stack) for AI clients to create and operate AI agent wallets on Maroo. Three namespaces — agent. (lifecycle, balance, gas-source), policy. (on-chain spending policy), transfer.* (OKRW value transfer + ownership transfer) — covering 19 tools end-to-end.
agent
Retrieve the current OKRW balance of the specified agent's AA wallet.
Create a new AI agent with its own AA wallet on the Maroo chain. The agent is initially created in a PENDING state and takes 1-3 minutes to become ACTIVE as WaaS registers it on-chain.
Get the full details of a specific agent, including its current status (PENDING, ACTIVE, FROZEN, REVOKED) and onchainAgentId.
Transfer OKRW from the agent's AA wallet back to the owner's primary wallet. Subject to the agent's spendingLimit.
Temporarily disable an agent. A FROZEN agent cannot execute transfers or update its policy.
Transfer OKRW from the owner's primary wallet to the agent's AA wallet. The agent must be ACTIVE.
Retrieve a list of all agents owned by the authenticated user.
Retrieve the OKRW balance of the human owner's primary wallet.
Permanently disable an agent. A REVOKED agent can never be reactivated.
Change which entity pays gas for this agent's transactions. This is a metadata-only update on the WaaS server.
Restore a FROZEN agent back to ACTIVE status.
policy
Read an agent's spending policy from the on-chain IdentityRegistry (ERC-8004 metadata). The agent must be ACTIVE.
Simulate a transfer against the agent's policy off-chain to confirm if it will pass, without actually submitting a transaction.
Update an agent's on-chain spending policy. The owner submits the transaction via WaaS. Omitted fields keep their current value.
transfer
Accept a pending agent ownership transfer. The agent becomes ACTIVE under the new owner.
Cancel a pending agent ownership transfer. The agent is unfrozen and remains with the original owner.
Initiate the transfer of an agent's ownership to another human user. The agent is immediately FROZEN for up to 24 hours while waiting for acceptance.
List all pending agent ownership transfers where the authenticated user is either the sender or the recipient.
Make the agent send OKRW to another address. Enforces the agent's on-chain policy server-side before submitting. The transaction is signed by WaaS on the agent's behalf.