Arcadia Finance

write_account_automations_delta

Idempotent

Apply an explicit change to an account's automations and return the unsigned setAssetManagers transaction. Unlike write_account_automations this is a delta, not a full desired state: automations you do not mention are left untouched. Use it to switch one automation on or off without restating the others.

The enable array takes intents to switch on (same shapes as write_account_automations). To turn an automation OFF, call read_asset_manager_current, take the address of the manager serving it, and pass that address in the disable array: an intent with enabled: false in enable is rejected because the backend would ignore it. Superseded or unreadable managers still set on the account are force-disabled in the same transaction regardless.

Intents:

compound_fees: reinvest earned fees/rewards back into the LP. Optional 'tokens' scopes it per yielding token. A staked reward that is not a pool token is swapped in via CowSwap automatically.
claim_rewards: claim yield out. config.mode as_earned pays the tokens as-is, convert_to swaps them to config.buy_token via CowSwap. config.convert_tokens converts only a subset and claims the rest as-earned. config.destination account or wallet.
add_to_lp: fold idle pool-token balances (deposits, rebalance leftovers) back into the LP. Opt-in per token.
claim_merkl: auto-claim Merkl incentive rewards. Independent of the compounder/claimer/cowswapper triad and needs no position context.
rebalance: reposition the LP. strategy out_of_range (default), take_profit (runs on the dedicated profit-taker contract), or protocol_owned_liquidity.

Pass position_id (from assets[] in read_account_info) and the backend fills in protocol, is_staked, token0, token1 and reward_tokens for you; anything you pass explicitly wins. claim_merkl needs no position context.

Rules the backend enforces (a violation is returned as an error, never written on-chain):

Every yielding token must be assigned to exactly one of compound_fees or claim_rewards. Scoping one to a subset without covering the rest is rejected, and no token may be in both.
A wallet or custom-recipient payout requires a pure as-earned claim: nothing converted, and every yielding token claimed. Converts settle in the account.
convert_tokens must be a subset of the claimed tokens, and buy_token cannot be a compounded token, a converted token, or an add_to_lp folded token.
Each intent kind may appear only once, and a token list must not be empty or name a token the position does not yield.

Input Schema

Name	Required	Description
`owner`	No	Account owner EOA. Used to resolve wallet payout targets.
`enable`	No	Intents to switch on. Leave empty when only disabling. This array cannot turn anything off: an entry with enabled: false is rejected, use `disable` instead.
`token0`	No	Pool token0 address.
`token1`	No	Pool token1 address.
`disable`	No	Asset-manager addresses to switch off, as returned by read_asset_manager_current.
`chain_id`	No	Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)
`protocol`	No	Position's DEX protocol. Only needed when position_id is omitted. Accepts the dex_protocol values the read tools return (slipstream, staked_slipstream_v3, uniV3, metadexcl_v1, staked_metadexcl_v1, ...), which imply is_staked, as well as the canonical slipstream_v1 / uniswap_v3 spellings. metadexcl_v1 is Aero CL; staked_metadexcl_v1 covers both the staked module and the wrapper.
`is_staked`	No	Whether the LP position is staked. Implied by a staked_* protocol value.
`position_id`	No	LP position (NFT) id, as listed in assets[] by read_account_info. Supply this and the backend fetches protocol, staked flag, tokens and reward tokens for you. Strongly preferred over passing the position fields by hand.
`reward_tokens`	No	Staking reward token addresses.
`account_address`	Yes	Arcadia account address

Output Schema

Name	Required	Description	Default
`diff`	No
`plan`	Yes
`valid`	Yes
`errors`	Yes
`warnings`	Yes
`description`	Yes
`transaction`	No
`preview_only`	No
`human_summary`	Yes
`simulation_url`	No
`no_changes_needed`	No
`tenderly_sim_status`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed21 schema fields changedOct 22, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

removedInput schema / additionalProperties
```
Removed value: -false
```

changedInput schema / properties / disable / description

Previous value: -"Asset-manager addresses to switch off, as returned by read.asset_manager.current."New value: +"Asset-manager addresses to switch off, as returned by read_asset_manager_current."

removedInput schema / properties / enable / items / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "enabled": {
-        "default": true,
-        "description": "False disables this intent's managers instead of enabling them.",
-        "type": "boolean"
-      },
-      "kind": {
-        "const": "compound_fees",
-        "type": "string"
-      },
-      "position_id": {
-        "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context.",
-        "type": "integer"
-      },
-      "tokens": {
-        "description": "Which tokens' yield to reinvest. Omit for all yielding tokens. 'reward' only exists on a staked position whose reward token is not a pool token. Every yielding token must be assigned to either compound_fees or claim_rewards, so if you scope this to a subset you must add a claim_rewards intent covering the rest.",
-        "items": {
-          "enum": [
-            "token0",
-            "token1",
-            "reward"
-          ],
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "config": {
-        "additionalProperties": false,
-        "default": {},
-        "properties": {
-          "buy_token": {
-            "description": "ERC20 to swap into. Required whenever any token is being converted. It cannot be a token you also compound, one of the tokens being converted, or a token folded by add_to_lp.",
-            "type": "string"
-          },
-          "convert_tokens": {
-            "description": "Subset of this intent's claimed tokens to swap to buy_token; the rest are claimed as-earned. Must be a subset of `tokens`. Omit to defer to mode (convert_to converts all claimed tokens, as_earned converts none). Use this for a partial convert, e.g. tokens: ['token0','reward'] with convert_tokens: ['reward'] swaps only the reward and claims token0 as-is.",
-            "items": {
-              "$ref": "#/properties/enable/items/anyOf/0/properties/tokens/items"
-            },
-            "type": "array"
-          },
-          "destination": {
-            "default": "account",
-            "description": "Payout target ('wallet' is the owner EOA). A wallet payout is only allowed for a pure as-earned claim: nothing converted, and every yielding token claimed. Any convert, or a claim scoped to a subset of tokens, must use 'account' because CowSwap settles there.",
-            "enum": [
-              "account",
-              "wallet"
-            ],
-            "type": "string"
-          },
-          "mode": {
-            "default": "as_earned",
-            "description": "as_earned pays out the claimed tokens as-is; convert_to swaps them to buy_token via CowSwap. Use convert_tokens to convert only some of them.",
-            "enum": [
-              "as_earned",
-              "convert_to"
-            ],
-            "type": "string"
-          },
-          "recipient": {
-            "description": "Explicit payout address. Overrides destination when set, and is subject to the same pure-as-earned rule as a wallet payout unless it equals the account address.",
-            "type": "string"
-          },
-          "tokens": {
-            "description": "Which tokens' yield to claim out. Omit for all yielding tokens. A token cannot be both claimed and compounded, and every yielding token must be assigned to one of the two.",
-            "items": {
-              "$ref": "#/properties/enable/items/anyOf/0/properties/tokens/items"
-            },
-            "type": "array"
-          }
-        },
-        "type": "object"
-      },
-      "enabled": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
-      },
-      "kind": {
-        "const": "claim_rewards",
-        "type": "string"
-      },
-      "position_id": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "enabled": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
-      },
-      "kind": {
-        "const": "add_to_lp",
-        "type": "string"
-      },
-      "position_id": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
-      },
-      "tokens": {
-        "description": "Which pool tokens' idle account balance to fold into the LP. Omit for both. Folding is opt-in per token, and a folded token cannot be the buy_token of a claim_rewards convert.",
-        "items": {
-          "enum": [
-            "token0",
-            "token1"
-          ],
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "config": {
-        "additionalProperties": false,
-        "default": {},
-        "properties": {
-          "destination": {
-            "default": "account",
-            "enum": [
-              "account",
-              "wallet"
-            ],
-            "type": "string"
-          },
-          "reward_recipient": {
-            "description": "Explicit recipient address. Overrides destination when set.",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "enabled": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
-      },
-      "kind": {
-        "const": "claim_merkl",
-        "type": "string"
-      },
-      "position_id": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "enabled": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
-      },
-      "kind": {
-        "const": "rebalance",
-        "type": "string"
-      },
-      "max_tolerance": {
-        "description": "Max price deviation (MEV/slippage cap), 1e18-scaled: 1e18 = 100%, so 5000000000000000 = 0.5% (the default) and 50000000000000000 = 5%. Omit for the pool's default. AAA pools are floored at 5%.",
-        "maximum": 1000000000000000000,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "min_liquidity_ratio": {
-        "description": "Min fraction of liquidity that must survive a rebalance, 1e18-scaled: 990000000000000000 = 99% (the default), i.e. at most 1% value loss. Omit for the default.",
-        "maximum": 1000000000000000000,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "position_id": {
-        "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
-      },
-      "strategy": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "kind": {
-                "const": "out_of_range",
-                "type": "string"
-              },
-              "max_rebalance_time": {
-                "default": 1000000000000,
-                "description": "Seconds before a rebalance is forced. Default is effectively disabled.",
-                "type": "integer"
-              },
-              "min_rebalance_time": {
-                "default": 3600,
-                "description": "Cooldown in seconds between rebalances.",
-                "type": "integer"
-              },
-              "optimal_token0_ratio": {
-                "default": 500000,
-                "description": "Target token0 composition after a rebalance, 1e6-scaled: 500000 = 50% (balanced, the default), 750000 = 75% token0, 0 = all token1.",
-                "maximum": 1000000,
-                "minimum": 0,
-                "type": "integer"
-              },
-              "trigger_lower_tick_ratio": {
-                "default": 0,
-                "description": "Offset from tick_lower as a fraction of the position's tick range, 1e6-scaled. This is TICK distance, not price: 50000 shifts the trigger by 5% of (tick_upper - tick_lower) ticks, which is not 5% of price. 0 = trigger exactly at the boundary. Positive (e.g. 50000) puts the trigger outside the position so price must travel further beyond the range before rebalancing. Negative (e.g. -50000) puts it inside, firing preemptively while price is still in range.",
-                "type": "integer"
-              },
-              "trigger_upper_tick_ratio": {
-                "default": 0,
-                "description": "Same as trigger_lower_tick_ratio, for tick_upper. The two are independent, so asymmetric configs are valid (e.g. lower -50000, upper 0 rebalances early on the downside but only at the boundary on the upside).",
-                "type": "integer"
-              }
-            },
-            "required": [
-              "kind"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "base_range": {
-                "default": 50000,
-                "type": "integer"
-              },
-              "deadzone": {
-                "default": 20000,
-                "type": "integer"
-              },
-              "fraction_excess_to_limit_order": {
-                "default": 500000,
-                "type": "integer"
-              },
-              "initial_range": {
-                "default": 200000,
-                "type": "integer"
-              },
-              "k1": {
-                "default": 0,
-                "type": "integer"
-              },
-              "k2": {
-                "default": 0,
-                "type": "integer"
-              },
-              "kind": {
-                "const": "protocol_owned_liquidity",
-                "type": "string"
-              },
-              "limit_order_withdrawal_threshold": {
-                "default": 50000,
-                "type": "integer"
-              },
-              "rebalance_threshold": {
-                "default": 25000,
-                "type": "integer"
-              },
-              "target_token0_ratio": {
-                "default": 500000,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "kind"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "has_reversal": {
-                "default": false,
-                "type": "boolean"
-              },
-              "kind": {
-                "const": "take_profit",
-                "type": "string"
-              },
-              "profit_token": {
-                "default": "token0",
-                "enum": [
-                  "token0",
-                  "token1"
-                ],
-                "type": "string"
-              },
-              "reversal_reposition_mode": {
-                "default": "",
-                "enum": [
-                  "",
-                  "anchor_tick",
-                  "shift_range"
-                ],
-                "type": "string"
-              },
-              "reversal_trigger_threshold": {
-                "default": 0,
-                "type": "integer"
-              },
-              "reversal_trigger_type": {
-                "default": "",
-                "enum": [
-                  "",
-                  "fixed",
-                  "relative"
-                ],
-                "type": "string"
-              },
-              "take_profit_reposition_mode": {
-                "default": "anchor_tick",
-                "enum": [
-                  "",
-                  "anchor_tick",
-                  "shift_range"
-                ],
-                "type": "string"
-              },
-              "take_profit_trigger_threshold": {
-                "default": 0,
-                "type": "integer"
-              },
-              "take_profit_trigger_type": {
-                "default": "fixed",
-                "enum": [
-                  "",
-                  "fixed",
-                  "relative"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind"
-            ],
-            "type": "object"
-          }
-        ],
-        "default": {
-          "kind": "out_of_range"
-        },
-        "description": "out_of_range repositions when price leaves the range; take_profit runs on the dedicated profit-taker contract; protocol_owned_liquidity is the POL strategy."
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / enable / items / oneOf

Added value: +[
+  {
+    "properties": {
+      "enabled": {
+        "default": true,
+        "description": "False disables this intent's managers instead of enabling them.",
+        "type": "boolean"
+      },
+      "kind": {
+        "const": "compound_fees",
+        "type": "string"
+      },
+      "position_id": {
+        "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "tokens": {
+        "description": "Which tokens' yield to reinvest. Omit for all yielding tokens. 'reward' only exists on a staked position whose reward token is not a pool token. Every yielding token must be assigned to either compound_fees or claim_rewards, so if you scope this to a subset you must add a claim_rewards intent covering the rest.",
+        "items": {
+          "enum": [
+            "token0",
+            "token1",
+            "reward"
+          ],
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "config": {
+        "default": {},
+        "properties": {
+          "buy_token": {
+            "description": "ERC20 to swap into. Required whenever any token is being converted. It cannot be a token you also compound, one of the tokens being converted, or a token folded by add_to_lp.",
+            "type": "string"
+          },
+          "convert_tokens": {
+            "description": "Subset of this intent's claimed tokens to swap to buy_token; the rest are claimed as-earned. Must be a subset of `tokens`. Omit to defer to mode (convert_to converts all claimed tokens, as_earned converts none). Use this for a partial convert, e.g. tokens: ['token0','reward'] with convert_tokens: ['reward'] swaps only the reward and claims token0 as-is.",
+            "items": {
+              "enum": [
+                "token0",
+                "token1",
+                "reward"
+              ],
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "destination": {
+            "default": "account",
+            "description": "Payout target ('wallet' is the owner EOA). A wallet payout is only allowed for a pure as-earned claim: nothing converted, and every yielding token claimed. Any convert, or a claim scoped to a subset of tokens, must use 'account' because CowSwap settles there.",
+            "enum": [
+              "account",
+              "wallet"
+            ],
+            "type": "string"
+          },
+          "mode": {
+            "default": "as_earned",
+            "description": "as_earned pays out the claimed tokens as-is; convert_to swaps them to buy_token via CowSwap. Use convert_tokens to convert only some of them.",
+            "enum": [
+              "as_earned",
+              "convert_to"
+            ],
+            "type": "string"
+          },
+          "recipient": {
+            "description": "Explicit payout address. Overrides destination when set, and is subject to the same pure-as-earned rule as a wallet payout unless it equals the account address.",
+            "type": "string"
+          },
+          "tokens": {
+            "description": "Which tokens' yield to claim out. Omit for all yielding tokens. A token cannot be both claimed and compounded, and every yielding token must be assigned to one of the two.",
+            "items": {
+              "enum": [
+                "token0",
+                "token1",
+                "reward"
+              ],
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "enabled": {
+        "default": true,
+        "description": "False disables this intent's managers instead of enabling them.",
+        "type": "boolean"
+      },
+      "kind": {
+        "const": "claim_rewards",
+        "type": "string"
+      },
+      "position_id": {
+        "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "enabled": {
+        "default": true,
+        "description": "False disables this intent's managers instead of enabling them.",
+        "type": "boolean"
+      },
+      "kind": {
+        "const": "add_to_lp",
+        "type": "string"
+      },
+      "position_id": {
+        "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "tokens": {
+        "description": "Which pool tokens' idle account balance to fold into the LP. Omit for both. Folding is opt-in per token, and a folded token cannot be the buy_token of a claim_rewards convert.",
+        "items": {
+          "enum": [
+            "token0",
+            "token1"
+          ],
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "config": {
+        "default": {},
+        "properties": {
+          "destination": {
+            "default": "account",
+            "enum": [
+              "account",
+              "wallet"
+            ],
+            "type": "string"
+          },
+          "reward_recipient": {
+            "description": "Explicit recipient address. Overrides destination when set.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "enabled": {
+        "default": true,
+        "description": "False disables this intent's managers instead of enabling them.",
+        "type": "boolean"
+      },
+      "kind": {
+        "const": "claim_merkl",
+        "type": "string"
+      },
+      "position_id": {
+        "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "enabled": {
+        "default": true,
+        "description": "False disables this intent's managers instead of enabling them.",
+        "type": "boolean"
+      },
+      "kind": {
+        "const": "rebalance",
+        "type": "string"
+      },
+      "max_tolerance": {
+        "description": "Max price deviation (MEV/slippage cap), 1e18-scaled: 1e18 = 100%, so 5000000000000000 = 0.5% (the default) and 50000000000000000 = 5%. Omit for the pool's default. AAA pools are floored at 5%.",
+        "maximum": 1000000000000000000,
+        "minimum": 0,
+        "multipleOf": 1,
+        "type": "number"
+      },
+      "min_liquidity_ratio": {
+        "description": "Min fraction of liquidity that must survive a rebalance, 1e18-scaled: 990000000000000000 = 99% (the default), i.e. at most 1% value loss. Omit for the default.",
+        "maximum": 1000000000000000000,
+        "minimum": 0,
+        "multipleOf": 1,
+        "type": "number"
+      },
+      "position_id": {
+        "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "strategy": {
+        "default": {
+          "kind": "out_of_range"
+        },
+        "description": "out_of_range repositions when price leaves the range; take_profit runs on the dedicated profit-taker contract; protocol_owned_liquidity is the POL strategy.",
+        "oneOf": [
+          {
+            "properties": {
+              "kind": {
+                "const": "out_of_range",
+                "type": "string"
+              },
+              "max_rebalance_time": {
+                "default": 1000000000000,
+                "description": "Seconds before a rebalance is forced. Default is effectively disabled.",
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "min_rebalance_time": {
+                "default": 3600,
+                "description": "Cooldown in seconds between rebalances.",
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "optimal_token0_ratio": {
+                "default": 500000,
+                "description": "Target token0 composition after a rebalance, 1e6-scaled: 500000 = 50% (balanced, the default), 750000 = 75% token0, 0 = all token1.",
+                "maximum": 1000000,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "trigger_lower_tick_ratio": {
+                "default": 0,
+                "description": "Offset from tick_lower as a fraction of the position's tick range, 1e6-scaled. This is TICK distance, not price: 50000 shifts the trigger by 5% of (tick_upper - tick_lower) ticks, which is not 5% of price. 0 = trigger exactly at the boundary. Positive (e.g. 50000) puts the trigger outside the position so price must travel further beyond the range before rebalancing. Negative (e.g. -50000) puts it inside, firing preemptively while price is still in range.",
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "trigger_upper_tick_ratio": {
+                "default": 0,
+                "description": "Same as trigger_lower_tick_ratio, for tick_upper. The two are independent, so asymmetric configs are valid (e.g. lower -50000, upper 0 rebalances early on the downside but only at the boundary on the upside).",
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "kind"
+            ],
+            "type": "object"
+          },
+          {
+            "properties": {
+              "base_range": {
+                "default": 50000,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "deadzone": {
+                "default": 20000,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "fraction_excess_to_limit_order": {
+                "default": 500000,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "initial_range": {
+                "default": 200000,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "k1": {
+                "default": 0,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "k2": {
+                "default": 0,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "kind": {
+                "const": "protocol_owned_liquidity",
+                "type": "string"
+              },
+              "limit_order_withdrawal_threshold": {
+                "default": 50000,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "rebalance_threshold": {
+                "default": 25000,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "target_token0_ratio": {
+                "default": 500000,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "kind"
+            ],
+            "type": "object"
+          },
+          {
+            "properties": {
+              "has_reversal": {
+                "default": false,
+                "type": "boolean"
+              },
+              "kind": {
+                "const": "take_profit",
+                "type": "string"
+              },
+              "profit_token": {
+                "default": "token0",
+                "enum": [
+                  "token0",
+                  "token1"
+                ],
+                "type": "string"
+              },
+              "reversal_reposition_mode": {
+                "default": "",
+                "enum": [
+                  "",
+                  "anchor_tick",
+                  "shift_range"
+                ],
+                "type": "string"
+              },
+              "reversal_trigger_threshold": {
+                "default": 0,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "reversal_trigger_type": {
+                "default": "",
+                "enum": [
+                  "",
+                  "fixed",
+                  "relative"
+                ],
+                "type": "string"
+              },
+              "take_profit_reposition_mode": {
+                "default": "anchor_tick",
+                "enum": [
+                  "",
+                  "anchor_tick",
+                  "shift_range"
+                ],
+                "type": "string"
+              },
+              "take_profit_trigger_threshold": {
+                "default": 0,
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "take_profit_trigger_type": {
+                "default": "fixed",
+                "enum": [
+                  "",
+                  "fixed",
+                  "relative"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "kind"
+            ],
+            "type": "object"
+          }
+        ]
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / position_id / description

Previous value: -"LP position (NFT) id, as listed in assets[] by read.account.info. Supply this and the backend fetches protocol, staked flag, tokens and reward tokens for you. Strongly preferred over passing the position fields by hand."New value: +"LP position (NFT) id, as listed in assets[] by read_account_info. Supply this and the backend fetches protocol, staked flag, tokens and reward tokens for you. Strongly preferred over passing the position fields by hand."

addedInput schema / properties / position_id / maximum
```
Added value: +9007199254740991
```
addedInput schema / properties / position_id / minimum
```
Added value: +-9007199254740991
```

changedInput schema / properties / protocol / description

Previous value: -"Position's DEX protocol. Only needed when position_id is omitted. Accepts the dex_protocol values the read tools return (slipstream, staked_slipstream_v3, uniV3, ...), which imply is_staked, as well as the canonical slipstream_v1 / uniswap_v3 spellings."New value: +"Position's DEX protocol. Only needed when position_id is omitted. Accepts the dex_protocol values the read tools return (slipstream, staked_slipstream_v3, uniV3, metadexcl_v1, staked_metadexcl_v1, ...), which imply is_staked, as well as the canonical slipstream_v1 / uniswap_v3 spellings. metadexcl_v1 is Aero CL; staked_metadexcl_v1 covers both the staked module and the wrapper."

changedInput schema / properties / protocol / enum

Previous value: -[
-  "slipstream_v1",
-  "slipstream_v2",
-  "slipstream_v3",
-  "uniswap_v3",
-  "uniswap_v4",
-  "slipstream",
-  "staked_slipstream",
-  "staked_slipstream_v2",
-  "staked_slipstream_v3",
-  "uniV3",
-  "uniV4"
-]New value: +[
+  "slipstream_v1",
+  "slipstream_v2",
+  "slipstream_v3",
+  "uniswap_v3",
+  "uniswap_v4",
+  "metadexcl_v1",
+  "slipstream",
+  "staked_slipstream",
+  "staked_slipstream_v2",
+  "staked_slipstream_v3",
+  "uniV3",
+  "uniV4",
+  "staked_metadexcl_v1"
+]

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

removedOutput schema / properties / diff / properties / removed / items / $ref
```
Removed value: -"#/properties/diff/properties/added/items"
```
addedOutput schema / properties / diff / properties / removed / items / additionalProperties
```
Added value: +false
```

addedOutput schema / properties / diff / properties / removed / items / properties

Added value: +{
+  "address": {
+    "type": "string"
+  },
+  "enabled": {
+    "type": "boolean"
+  },
+  "manager": {
+    "type": "string"
+  }
+}

addedOutput schema / properties / diff / properties / removed / items / required
```
Added value: +[
+  "manager",
+  "address",
+  "enabled"
+]
```
addedOutput schema / properties / diff / properties / removed / items / type
```
Added value: +"object"
```
removedOutput schema / properties / diff / properties / updated / items / $ref
```
Removed value: -"#/properties/diff/properties/added/items"
```
addedOutput schema / properties / diff / properties / updated / items / additionalProperties
```
Added value: +false
```

addedOutput schema / properties / diff / properties / updated / items / properties

Added value: +{
+  "address": {
+    "type": "string"
+  },
+  "enabled": {
+    "type": "boolean"
+  },
+  "manager": {
+    "type": "string"
+  }
+}

addedOutput schema / properties / diff / properties / updated / items / required
```
Added value: +[
+  "manager",
+  "address",
+  "enabled"
+]
```
addedOutput schema / properties / diff / properties / updated / items / type
```
Added value: +"object"
```

Changed1 schema field changedSep 1, 2026

changedInput schema / properties / chain_id / description

Previous value: -"Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"New value: +"Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)"

AddedAug 10, 2026

TDQS

A4.6/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare this is a non-read-only, non-destructive, idempotent, open-world write. The description adds real behavior beyond that: the return is an unsigned setAssetManagers transaction, backend rule violations are returned as errors and never written on-chain, and superseded/unreadable managers are force-disabled in the same transaction. It doesn't cover what happens to automation state on partial failure, but the transaction-semantics note is substantive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is long, but for a five-way intent union with backend invariants the length is largely justified, and it is front-loaded: the delta-vs-full-state contrast and the enable/disable split come before the intent catalogue. Some sentences restate schema text and could be trimmed without loss.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and everything else an agent needs — prerequisite reads, disable procedure, cross-field validation rules, and the position context auto-fill — is present. Nothing material is missing for correct invocation of a complex write tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3; the description still contributes by explaining the intent semantics (compound_fees, claim_rewards, add_to_lp, claim_merkl, rebalance) as a coherent narrative and by clarifying that position_id lets the backend fill protocol/tokens/reward_tokens while explicit values win. Much of this overlaps the schema, so it earns only a modest lift over baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Apply an explicit change to an account's automations') and immediately contrasts with the sibling write_account_automations: delta vs full desired state. An agent can tell which of the two write tools to pick from the first sentence alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use ('switch one automation on or off without restating the others') and a concrete when-not plus alternative (full-state writes go to write_account_automations). It also spells out the disable workflow — read_asset_manager_current, take the address, pass it in `disable` — and states that enabled:false inside `enable` is rejected.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Arcadia Finance tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.