MCP Tool Reference#

This page is generated from the Agent API endpoint catalog, MCP tool-name derivation, and inline MCP session tools. It documents 68 tools exposed by tools/list.

Mutating Agent API tools that require idempotency require a tool-level idempotency_key input. Hightop does not synthesize one from the JSON-RPC id.

Tool Catalog#

Tool	Title	Endpoint	Scope	Rate class	Idempotency input required	Read-only hint	Description
`agent_account_get`	Get Account	`GET /v1/agent/account`	`agent:read`	`read`	No	Yes	Return a scoped account summary for the authenticated agent wallet.
`agent_activity_list`	Get Activity	`GET /v1/agent/activity`	`agent:read`	`read`	No	Yes	List scoped Activity rows for the authenticated agent wallet without marking them read.
`agent_assets_list`	Get Assets	`GET /v1/agent/assets`	`agent:read`	`read`	No	Yes	List assets visible to the authenticated agent.
`agent_balances_cash_list`	Get Balances Cash	`GET /v1/agent/balances/cash`	`agent:read`	`read`	No	Yes	List cash balances for the authenticated agent wallet.
`agent_balances_list`	Get Balances	`GET /v1/agent/balances`	`agent:read`	`read`	No	Yes	List balances for the authenticated agent wallet.
`agent_borrow_collateral_add_create`	Create Borrow Collateral Add	`POST /v1/agent/borrow/collateral/add`	`agent:borrow:write`	`write`	Yes	No	Create a collateral add operation.
`agent_borrow_collateral_list`	Get Borrow Collateral	`GET /v1/agent/borrow/collateral`	`agent:read`	`read`	No	Yes	List collateral for the authenticated agent wallet.
`agent_borrow_collateral_remove_create`	Create Borrow Collateral Remove	`POST /v1/agent/borrow/collateral/remove`	`agent:borrow:write`	`write`	Yes	No	Create a collateral remove operation.
`agent_borrow_create`	Create Borrow	`POST /v1/agent/borrow`	`agent:borrow:write`	`write`	Yes	No	Create a borrow operation for USDC or GREEN.
`agent_borrow_deleverage_create`	Create Borrow Deleverage	`POST /v1/agent/borrow/deleverage`	`agent:borrow:write`	`write`	Yes	No	Create a target-LTV deleverage operation.
`agent_borrow_get`	Get Borrow	`GET /v1/agent/borrow`	`agent:read`	`read`	No	Yes	Return borrow summary for the authenticated agent wallet.
`agent_borrow_repay_create`	Create Borrow Repay	`POST /v1/agent/borrow/repay`	`agent:borrow:write`	`write`	Yes	No	Create a debt repayment operation.
`agent_capabilities_list`	Get Capabilities	`GET /v1/agent/capabilities`	`agent:read`	`read`	No	Yes	Return Agent API capabilities for the authenticated agent.
`agent_capabilitiesJson_list`	Get Capabilities JSON	`GET /v1/agent/capabilities.json`	`agent:read`	`read`	No	Yes	Return Agent API capabilities as JSON.
`agent_conversions_create`	Create Conversions	`POST /v1/agent/conversions`	`agent:conversions:write`	`write`	Yes	No	Execute a conversion from a quote.
`agent_conversions_get`	Get Conversions	`GET /v1/agent/conversions/{id}`	`agent:read`	`read`	No	Yes	Get one conversion operation for the authenticated agent.
`agent_conversions_list`	Get Conversions	`GET /v1/agent/conversions`	`agent:read`	`read`	No	Yes	List conversion operations for the authenticated agent.
`agent_conversions_quote`	Quote Conversion	`POST /v1/agent/conversions/quote`	`agent:simulate`	`simulate`	Yes	No	Create a stateful conversion quote.
`agent_depositAddress_list`	Get Deposit Address	`GET /v1/agent/deposit-address`	`agent:read`	`read`	No	Yes	Return a Base deposit address for an asset.
`agent_depositMethods_list`	Get Deposit Methods	`GET /v1/agent/deposit-methods`	`agent:read`	`read`	No	Yes	List deposit methods for the authenticated agent wallet.
`agent_earn_deposit_create`	Create Earn Deposit	`POST /v1/agent/earn/deposit`	`agent:earn:write`	`write`	Yes	No	Create an earn deposit operation.
`agent_earn_get`	Get Earn	`GET /v1/agent/earn/{id}`	`agent:read`	`read`	No	Yes	Get one earn position for the authenticated agent wallet.
`agent_earn_list`	Get Earn	`GET /v1/agent/earn`	`agent:read`	`read`	No	Yes	List earn positions for the authenticated agent wallet.
`agent_earn_move_create`	Create Earn Move	`POST /v1/agent/earn/move`	`agent:earn:write`	`write`	Yes	No	Create an earn move operation.
`agent_earn_opportunities_list`	Get Earn Opportunities	`GET /v1/agent/earn/opportunities`	`agent:read`	`read`	No	Yes	List earn opportunities available to the authenticated agent.
`agent_earn_rewards_claim_create`	Create Earn Rewards Claim	`POST /v1/agent/earn/rewards/claim`	`agent:earn:write`	`write`	Yes	No	Create a rewards claim operation.
`agent_earn_withdraw_create`	Create Earn Withdraw	`POST /v1/agent/earn/withdraw`	`agent:earn:write`	`write`	Yes	No	Create an earn withdrawal operation.
`agent_oneOffPayments_create`	Create One Off Payments	`POST /v1/agent/one-off-payments`	`agent:payments:write`	`write`	Yes	No	Create a one-off payment operation.
`agent_oneOffPayments_get`	Get One Off Payments	`GET /v1/agent/one-off-payments/{id}`	`agent:read`	`read`	No	Yes	Get a one-off payment operation for the authenticated agent.
`agent_oneOffPayments_list`	Get One Off Payments	`GET /v1/agent/one-off-payments`	`agent:read`	`read`	No	Yes	List one-off payment operations for the authenticated agent.
`agent_operations_get`	Get Operations	`GET /v1/agent/operations/{id}`	`agent:read`	`read`	No	Yes	Get one AgentOperation for the authenticated agent.
`agent_operations_list`	Get Operations	`GET /v1/agent/operations`	`agent:read`	`read`	No	Yes	List AgentOperation rows for the authenticated agent.
`agent_operations_wait_for_status`	Wait for Operation Status	inline	`agent:read`	`read guard`	No	Yes	Block until an AgentOperation reaches a terminal status (or the deadline elapses), then return its latest snapshot. Use this tool right after submitting a write call (payments, conversions, withdrawals, earn moves, etc.) when your MCP client does not consume `notifications/hightop/agent_webhook` notifications on the SSE stream — it is the polling fallback for finalization. Returns the latest operation snapshot regardless of whether the wait terminated naturally or timed out; check `_meta.hightop.terminal` to disambiguate.
`agent_payments_create`	Create Payments	`POST /v1/agent/payments`	`agent:payments:write`	`write`	Yes	No	Create a payment operation.
`agent_payments_get`	Get Payments	`GET /v1/agent/payments/{id}`	`agent:read`	`read`	No	Yes	Get one payment operation for the authenticated agent.
`agent_payments_list`	Get Payments	`GET /v1/agent/payments`	`agent:read`	`read`	No	Yes	List payment operations for the authenticated agent.
`agent_protocols_list`	Get Protocols	`GET /v1/agent/protocols`	`agent:read`	`read`	No	Yes	List protocols visible to the authenticated agent.
`agent_recipients_get`	Get Recipients	`GET /v1/agent/recipients/{id}`	`agent:read`	`read`	No	Yes	Get one recipient visible to the authenticated agent wallet.
`agent_recipients_list`	Get Recipients	`GET /v1/agent/recipients`	`agent:read`	`read`	No	Yes	List payment recipients visible to the authenticated agent wallet.
`agent_recipients_resolve`	Resolve Recipient	`POST /v1/agent/recipients/resolve`	`agent:read`	`read`	No	Yes	Resolve an agent-facing recipient identifier.
`agent_recurringPayments_get`	Get Recurring Payments	`GET /v1/agent/recurring-payments/{id}`	`agent:read`	`read`	No	Yes	Get one recurring payment recipient visible to the authenticated agent wallet.
`agent_recurringPayments_list`	Get Recurring Payments	`GET /v1/agent/recurring-payments`	`agent:read`	`read`	No	Yes	List recurring payment recipients visible to the authenticated agent wallet.
`agent_self_get`	Get Self	`GET /v1/agent/self`	`agent:read`	`read`	No	Yes	Return the authenticated agent and scoped wallet context.
`agent_self_usage_list`	Get Self Usage	`GET /v1/agent/self/usage`	`agent:read`	`read`	No	Yes	Return current Agent API rate-limit and usage state.
`agent_simulate`	Simulate Operation	`POST /v1/agent/simulate`	`agent:simulate`	`simulate`	No	No	Simulate a write request without broadcasting.
`agent_trustedDestinations_cancel_create`	Create Trusted Destinations Cancel	`POST /v1/agent/trusted-destinations/{id}/cancel`	`agent:trusted_destinations:write`	`write`	Yes	No	Cancel a pending trusted destination for the authenticated agent wallet.
`agent_trustedDestinations_confirm_create`	Create Trusted Destinations Confirm	`POST /v1/agent/trusted-destinations/{id}/confirm`	`agent:trusted_destinations:write`	`write`	Yes	No	Confirm a pending trusted destination for the authenticated agent wallet.
`agent_trustedDestinations_delete`	Delete Trusted Destinations	`DELETE /v1/agent/trusted-destinations/{id}`	`agent:trusted_destinations:write`	`write`	Yes	No	Remove a trusted destination from the authenticated agent wallet.
`agent_trustedDestinations_get`	Get Trusted Destinations	`GET /v1/agent/trusted-destinations/{id}`	`agent:read`	`read`	No	Yes	Get one trusted destination visible to the authenticated agent wallet.
`agent_trustedDestinations_list`	Get Trusted Destinations	`GET /v1/agent/trusted-destinations`	`agent:read`	`read`	No	Yes	List trusted destinations visible to the authenticated agent wallet.
`agent_webhooks_create`	Create Webhooks	`POST /v1/agent/webhooks`	`agent:webhooks:manage`	`webhook_management`	Yes	No	Create an outbound webhook endpoint.
`agent_webhooks_delete`	Delete Webhooks	`DELETE /v1/agent/webhooks/{id}`	`agent:webhooks:manage`	`webhook_management`	Yes	No	Delete or disable an outbound webhook endpoint.
`agent_webhooks_deliveries_get`	Get Webhooks Deliveries	`GET /v1/agent/webhooks/{id}/deliveries`	`agent:read`	`read`	No	Yes	List webhook delivery attempts for one outbound webhook endpoint.
`agent_webhooks_get`	Get Webhooks	`GET /v1/agent/webhooks/{id}`	`agent:read`	`webhook_management`	No	Yes	Get one outbound webhook endpoint for the authenticated agent.
`agent_webhooks_list`	Get Webhooks	`GET /v1/agent/webhooks`	`agent:read`	`webhook_management`	No	Yes	List outbound webhook endpoints for the authenticated agent.
`agent_webhooks_rotateSecret_create`	Create Webhooks Rotate Secret	`POST /v1/agent/webhooks/{id}/rotate-secret`	`agent:webhooks:manage`	`webhook_management`	Yes	No	Rotate an outbound webhook signing secret.
`agent_webhooks_test_create`	Create Webhooks Test	`POST /v1/agent/webhooks/{id}/test`	`agent:webhooks:manage`	`webhook_management`	Yes	No	Send a webhook.test delivery to an outbound webhook endpoint.
`agent_webhooks_update`	Update Webhooks	`PATCH /v1/agent/webhooks/{id}`	`agent:webhooks:manage`	`webhook_management`	Yes	No	Update an outbound webhook endpoint.
`agent_withdrawalMethods_list`	Get Withdrawal Methods	`GET /v1/agent/withdrawal-methods`	`agent:read`	`read`	No	Yes	List withdrawal methods visible to the authenticated agent wallet.
`agent_withdrawals_get`	Get Withdrawals	`GET /v1/agent/withdrawals/{id}`	`agent:read`	`read`	No	Yes	Get one withdrawal operation for the authenticated agent.
`agent_withdrawals_list`	Get Withdrawals	`GET /v1/agent/withdrawals`	`agent:read`	`read`	No	Yes	List withdrawal operations for the authenticated agent.
`agent_withdrawals_toBank_create`	Create Withdrawals To Bank	`POST /v1/agent/withdrawals/to-bank`	`agent:withdrawals:write`	`write`	Yes	No	Create a bank withdrawal operation.
`agent_withdrawals_toCrypto_create`	Create Withdrawals To Crypto	`POST /v1/agent/withdrawals/to-crypto`	`agent:withdrawals:write`	`write`	Yes	No	Create a crypto withdrawal operation.
`agent_x402_purchase`	Purchase x402 Resource	`POST /v1/agent/x402/purchase`	`agent:payments:write`	`write`	Yes	No	Fetch a URL, satisfy an x402 challenge when required, and return the upstream response.
`agent_x402_quote`	Quote x402 Resource	`POST /v1/agent/x402/quote`	`agent:simulate`	`simulate`	No	Yes	Fetch a URL and return its supported x402 price without paying.
`agent_x402_sign`	Sign x402 Payment	`POST /v1/agent/x402/sign`	`agent:payments:write`	`write`	Yes	No	Sign a Base USDC x402 payment authorization from an x402 payment requirement.
`mcp_subscribe`	Subscribe to Agent Events	inline	`agent:read`	`read guard`	No	No	Set the event types delivered on this MCP session stream.
`mcp_unsubscribe`	Unsubscribe from Agent Events	inline	`authenticated session`	`session update`	No	No	Stop delivering agent webhook events on this MCP session stream.

Input and Output Fields#

Tool	Required inputs	Input fields	Top-level output fields
`agent_account_get`	none	none	`account` (required): object `ok` (required): boolean
`agent_activity_list`	none	`cursor`: string `limit`: integer `since`: string `type`: string	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_assets_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_balances_cash_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_balances_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_borrow_collateral_add_create`	`asset`, `idempotency_key`	`allow_conversion`: boolean `amount`: string `amount_usd`: string `asset` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `source_asset`: string	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_borrow_collateral_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_borrow_collateral_remove_create`	`asset`, `idempotency_key`	`amount`: string `amount_usd`: string `asset` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `max_ltv_after`: string `remove_all`: boolean	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_borrow_create`	`asset`, `idempotency_key`	`amount`: string `amount_usd`: string `asset` (required): string - Agent API v1 borrow asset. Only USDC and GREEN are supported. Accepts either the symbol ("USDC" / "GREEN") or the canonical Base contract address. Generated SDK clients should send one of the enum values; the HTTP runtime additionally tolerates case and surrounding whitespace as a convenience for hand-rolled callers. `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `max_ltv_after`: string	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_borrow_deleverage_create`	`idempotency_key`, `target_ltv`	`allow_conversion`: boolean `allow_partial`: boolean `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `max_repay_amount_usd`: string `source_asset`: string `target_ltv` (required): string `use_available_cash_first`: boolean	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_borrow_get`	none	none	`ok` (required): boolean `summary` (required): object
`agent_borrow_repay_create`	`asset`, `idempotency_key`	`allow_conversion`: boolean `amount`: string `amount_usd`: string `asset` (required): string - Agent API v1 repay asset. Only GREEN is supported. Accepts either the symbol ("GREEN") or the canonical Base GREEN contract address. Generated SDK clients should send one of the enum values; the HTTP runtime additionally tolerates case and surrounding whitespace as a convenience for hand-rolled callers. `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `repay_all`: boolean `source_asset`: string	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_capabilities_list`	none	none	`agent_api_contract_version` (required): string `api_version` (required): string `base_path` (required): string `can_claim_loot` (required): object `emitted_webhook_event_types` (required): array `endpoints` (required): array `ok` (required): boolean `operation_statuses` (required): array `operation_types` (required): array `subscribable_webhook_event_types` (required): array `supported_actions` (required): array `target_wrapper_version` (required): string `webhook_event_types` (required): array
`agent_capabilitiesJson_list`	none	none	`agent_api_contract_version` (required): string `api_version` (required): string `base_path` (required): string `can_claim_loot` (required): object `emitted_webhook_event_types` (required): array `endpoints` (required): array `ok` (required): boolean `operation_statuses` (required): array `operation_types` (required): array `subscribable_webhook_event_types` (required): array `supported_actions` (required): array `target_wrapper_version` (required): string `webhook_event_types` (required): array
`agent_conversions_create`	`idempotency_key`, `quote_id`	`idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `quote_id` (required): string	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_conversions_get`	`id`	`id` (required): string `include`: string	`ok` (required): boolean `operation` (required): object
`agent_conversions_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_conversions_quote`	`from_asset`, `idempotency_key`, `to_asset`	`amount`: string `amount_usd`: string `from_asset` (required): string `from_vault_address`: string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `slippage_percent`: number `to_asset` (required): string `to_vault_address`: string	`ok` (required): boolean `quote` (required): object
`agent_depositAddress_list`	`asset`	`asset` (required): string `chain`: string	`address` (required): string `asset` (required): string `chain` (required): string `ok` (required): boolean
`agent_depositMethods_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_earn_deposit_create`	`asset`, `idempotency_key`	`amount`: string `amount_usd`: string `asset` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `use_best_available`: boolean `vault_id`: string - Earn vault identifier. Always a Base ERC4626 vault contract address (case-insensitive). Returned in /v1/agent/earn and /v1/agent/earn/opportunities as `vault_id`.	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_earn_get`	`id`	`id` (required): string	`ok` (required): boolean `position` (required): object
`agent_earn_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_earn_move_create`	`from_position_id`, `idempotency_key`	`amount`: string `amount_usd`: string `from_position_id` (required): string - Existing earn-position identifier. Always a Base ERC4626 vault contract address (case-insensitive) identifying a vault the wallet holds shares in. Read these from /v1/agent/earn. `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `move_all`: boolean `to_best_available`: boolean `to_vault_id`: string - Earn vault identifier. Always a Base ERC4626 vault contract address (case-insensitive). Returned in /v1/agent/earn and /v1/agent/earn/opportunities as `vault_id`.	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_earn_opportunities_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_earn_rewards_claim_create`	`idempotency_key`	`idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `protocols`: array - Rewards-claim protocol identifier. Only `underscore-earn` and `ripe-rewards` are supported in Agent API v1. Omit `protocols` to claim from both. The HTTP runtime additionally tolerates the legacy short forms `underscore` and `ripe` for hand-rolled callers — generated SDK clients should send a canonical value.	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_earn_withdraw_create`	`idempotency_key`, `position_id`	`allow_conversion`: boolean `amount`: string `amount_usd`: string `destination_asset`: string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `position_id` (required): string - Existing earn-position identifier. Always a Base ERC4626 vault contract address (case-insensitive) identifying a vault the wallet holds shares in. Read these from /v1/agent/earn. `withdraw_all`: boolean	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_oneOffPayments_create`	`asset`, `idempotency_key`, `to`	`amount`: string `amount_usd`: string `asset` (required): string `expires_in_seconds`: integer `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `note`: anyOf `to` (required): string `unlock_delay_seconds`: integer	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_oneOffPayments_get`	`id`	`id` (required): string `include`: string	`ok` (required): boolean `operation` (required): object
`agent_oneOffPayments_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_operations_get`	`id`	`id` (required): string `include`: string	`ok` (required): boolean `operation` (required): object
`agent_operations_list`	none	`cursor`: string `limit`: integer `since`: string `status`: string `type`: string	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_operations_wait_for_status`	`operation_id`	`operation_id` (required): string - The AgentOperation id returned by the submitting tool call (e.g. `agent_payments_create`). `terminal_statuses`: array - Statuses that count as terminal for this wait. Defaults to `["executed", "execution_failed", "policy_rejected", "cancelled"]`. `timeout_seconds`: integer - Maximum seconds to wait before returning the latest non-terminal snapshot. Default 60, capped at 240.	`operation` (required): object - Latest snapshot of the AgentOperation row scoped to the authenticated agent.
`agent_payments_create`	`asset`, `idempotency_key`, `to`	`amount`: string `amount_usd`: string `asset` (required): string `deliver_as`: string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `note`: anyOf `prefer`: string `slippage_percent`: number `to` (required): string	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_payments_get`	`id`	`id` (required): string `include`: string	`ok` (required): boolean `operation` (required): object
`agent_payments_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_protocols_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_recipients_get`	`id`	`id` (required): string	`ok` (required): boolean `recipient` (required): object
`agent_recipients_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_recipients_resolve`	`to`	`action`: string `asset`: string `to` (required): string	`ok` (required): boolean `recipient` (required): object
`agent_recurringPayments_get`	`id`	`id` (required): string	`ok` (required): boolean `recipient` (required): object
`agent_recurringPayments_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_self_get`	none	none	`agent` (required): object `cannot` (required): array `current_usage` (required): object `limits` (required): object `ok` (required): boolean `permissions` (required): object
`agent_self_usage_list`	none	none	`current_usage` (required): object `ok` (required): boolean `rate_limits` (required): array `throttled` (required): boolean
`agent_simulate`	`method`, `path`	`body`: unknown `method` (required): string `path` (required): string	`blocks`: array `execution_path` (required): array `ok` (required): boolean `would_succeed` (required): boolean
`agent_trustedDestinations_cancel_create`	`id`, `idempotency_key`	`id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch.	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_trustedDestinations_confirm_create`	`id`, `idempotency_key`	`id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch.	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_trustedDestinations_delete`	`id`, `idempotency_key`	`id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch.	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_trustedDestinations_get`	`id`	`id` (required): string	`ok` (required): boolean `recipient` (required): object
`agent_trustedDestinations_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_webhooks_create`	`event_types`, `idempotency_key`, `url`	`description`: string `event_types` (required): array `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `url` (required): string	`ok` (required): boolean `signing_secret` (required): string `webhook` (required): object
`agent_webhooks_delete`	`id`, `idempotency_key`	`id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch.	`ok` (required): boolean `webhook` (required): object
`agent_webhooks_deliveries_get`	`id`	`cursor`: string `event_id`: string `id` (required): string `limit`: integer `status`: string	`has_more` (required): boolean `items` (required): array `next_cursor` (required): anyOf `ok` (required): boolean
`agent_webhooks_get`	`id`	`id` (required): string `include`: string	`ok` (required): boolean `webhook` (required): object
`agent_webhooks_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_webhooks_rotateSecret_create`	`id`, `idempotency_key`	`id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch.	`ok` (required): boolean `previous_secret_valid_until` (required): string `signing_secret` (required): string `webhook` (required): object
`agent_webhooks_test_create`	`id`, `idempotency_key`	`id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch.	`delivery` (required): object `event` (required): object `ok` (required): boolean
`agent_webhooks_update`	`id`, `idempotency_key`	`description`: anyOf `enabled`: boolean `event_types`: array `id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `url`: string	`ok` (required): boolean `webhook` (required): object
`agent_withdrawalMethods_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_withdrawals_get`	`id`	`id` (required): string `include`: string	`ok` (required): boolean `operation` (required): object
`agent_withdrawals_list`	none	`cursor`: string `limit`: integer	`has_more` (required): boolean `items` (required): array `next_cursor` (required): string\|null `ok` (required): boolean
`agent_withdrawals_toBank_create`	`asset`, `idempotency_key`, `method_id`	`amount`: string `amount_usd`: string `asset` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `method_id` (required): string `note`: anyOf	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_withdrawals_toCrypto_create`	`asset`, `destination_id`, `idempotency_key`	`amount`: string `amount_usd`: string `asset` (required): string `destination_id` (required): string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `note`: anyOf	`estimated_ltv_after`: string `fee_usd` (required): string `human_message`: string `ok` (required): boolean `onchain`: object `operation_id` (required): string `policy_evaluation`: object `repay_amount_usd`: string `resource` (required): object `status` (required): string
`agent_x402_purchase`	`idempotency_key`, `max_amount`, `url`	`body`: unknown `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `max_amount` (required): string `method`: string `url` (required): string	`ok` (required): boolean `operation_id` (required): anyOf `paid` (required): boolean `payment` (required): anyOf `payment_authorized` (required): boolean `recoverable`: boolean `recovery_error`: object `response` (required): anyOf `seller_accepted` (required): boolean `seller_error`: object `settled` (required): boolean `settlement` (required): anyOf
`agent_x402_quote`	`url`	`body`: unknown `method`: string `timeout_ms`: integer `url` (required): string	`ok` (required): boolean `price` (required): anyOf `response` (required): object `supported` (required): boolean `unsupported_details`: object `unsupported_reason`: string `x402_required` (required): boolean
`agent_x402_sign`	`idempotency_key`	`amount`: string `idempotency_key` (required): string - Stable idempotency key for this logical operation. Generate a fresh UUID for each new request; reuse the same value only when retrying the same logical request. Retries with the same key replay the original response; reusing a key with a different payload returns idempotency_key_reuse_mismatch. `max_timeout_seconds`: integer `pay_to`: string `payment_requirements`: object `target_url`: string	`amount` (required): string `nonce` (required): string `ok` (required): boolean `operation_id` (required): string `pay_to` (required): string `payment_header` (required): string `payment_header_name` (required): string `payment_headers` (required): object `payment_id` (required): string `payment_version` (required): number `valid_before` (required): string
`mcp_subscribe`	`event_types`	`event_types` (required): array	`ok` (required): boolean `subscriptions` (required): array
`mcp_unsubscribe`	none	none	`ok` (required): boolean `subscriptions` (required): array