privy_get_wallet_action
Get a single wallet action by id. Hits `GET /v1/wallets/{wallet_id}/actions/{action_id}`. The handler does the same ownership check as `privy_get_wallet`. Returns the full `WalletAction` record. Use this for a per-action status check (e.g. to confirm a `prepare_transaction` has actually been picked up by the user, or to read the per-step `steps` array after a failed action).
Get a single wallet action by id. Hits GET /v1/wallets/{wallet_id}/actions/{action_id}. The handler does the same ownership check as privy_get_wallet.
Endpoint
GET /v1/wallets/{wallet_id}/actions/{action_id}
Input
The tool takes a single JSON object. Every field, its type, and an example are on the generated reference at GET /mcp/tools, under this tool's name.
Calling it
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "privy_get_wallet_action", "arguments": {} }
}Put your arguments in place of the empty object. A call that fails comes back as a normal result carrying isError: true and a message naming what went wrong, not as a JSON-RPC protocol error.
Notes
Returns the full WalletAction record. Use this for a per-action status check (e.g. to confirm a prepare_transaction has actually been picked up by the user, or to read the per-step steps array after a failed action).
The full request and response shape, and a live playground, live on the generated reference at GET /mcp/tools.
privy_list_wallet_actions
List a wallet's in-flight and completed actions. Hits `GET /v1/wallets/{wallet_id}/actions`. The handler does the same ownership check as `privy_get_wallet`. Returns `{ data: WalletAction[], next_cursor: string | null }` — each record carries the action type (`transfer`, `swap`, `custom`, ...), status, the chain, and a `steps` array with the per-step status. The list is cursor-paginated. Use this to surface transactions the agent has initiated but the user has not yet confirmed, or to check the status of a previously-queued action; for a single action, use `privy_get_wallet_action`.
Transactions
Read a transaction, poll for its status, and prepare one for the user to