accueil / serveurs / Finance & Paiement / io.github.arcadia-finance/mcp-server
io.github.arcadia-finance/mcp-server
serveur MCP (Model Context Protocol) · arcadia-finance 0.5.1
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que io.github.arcadia-finance/mcp-server est sûr ?
Au dernier audit MCP Hub, le serveur MCP « io.github.arcadia-finance/mcp-server » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 35 outils
- dev_send≈ 352 tokens
DEV ONLY — Sign and broadcast an unsigned transaction using a local private key (PK env var). For production, use a dedicated wallet MCP server (Fireblocks, Safe, Turnkey, etc.) instead of this tool. Takes the transaction object returned by any write.* tool and submits it onchain.
Paramètres, retour & exemple (4)
Paramètresto· string · requis
Target contract addressdata· string · requis
Encoded calldata (hex)value· string · optionnel
Value in wei (default '0')chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)
Exemple d'appel{"name": "dev_send", "arguments": {"to": "texte", "data": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"signer": "texte", "status": "texte", "txHash": "texte", "gasUsed": 1, "gasLimit": 1, "blockNumber": 1}} - read_account_history≈ 327 tokens
Get an Arcadia account's historical net value over time. Returns a time series of snapshots, oldest first, each `{ timestamp, net_value }` — `timestamp` is unix seconds and `net_value` is USD (human-readable, not raw units). Useful for charting account performance over a period. An empty `history` means the account has no snapshots in the window, not that the read failed.
Paramètres, retour & exemple (3)
Paramètresdays· number · optionnel
Number of days of history (default 14)chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)account_address· string · requis
Arcadia account address
Exemple d'appel{"name": "read_account_history", "arguments": {"account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"history": []}} - read_account_info≈ 721 tokens
Get full overview of an Arcadia account: health factor, collateral value, debt, deposited assets, liquidation price, and automation status. Health factor = 1 - (used_margin / liquidation_value): 1 = no debt (safest), >0 = healthy, 0 = liquidation threshold, <0 = past liquidation. Higher is safer. The `automation` object reports which asset managers are enabled (rebalancer, compounder, yield_claimer, cow_swapper, merkl_operator, gas_relayer), each as the position's dex_protocol when protocol-specific or true when account-level, plus `inferred_intents` (the automations those managers add up to), `merkl` claim state, and `deprecated_managers` for any superseded deployment still set on the account. Superseded managers should be cleared: write_account_automations disables them as part of a save. For the full decoded per-manager config use read_asset_manager_current. LP positions in assets[] include a dex_protocol field (slipstream, slipstream_v2, slipstream_v3, staked_slipstream, staked_slipstream_v2, staked_slipstream_v3, uniV3, uniV4). To configure automations, prefer passing the position's id as position_id to write_account_automations, which resolves the protocol and tokens for you; the dex_protocol value is also accepted directly as its `protocol` param. Slipstream V2 is Base-only. V3 is available on Base and Optimism. Unichain supports only Slipstream V1, uniV3, and uniV4. Numeric fields without a _usd suffix are in the account's numeraire token raw units (divide by 10^decimals: 6 for USDC, 18 for WETH, 8 for cbBTC). Fields ending in _usd are in USD with 18 decimals (divide by 1e18). health_factor is unitless. Asset amounts are raw token units. To list all accounts for a wallet, use read_wallet_accounts.
Paramètres, retour & exemple (2)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)account_address· string · requis
Arcadia account address
Exemple d'appel{"name": "read_account_info", "arguments": {"account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"overview": "texte", "automation": {}, "context_notes": [], "account_version": 1, "liquidation_price": "texte"}} - read_account_pnl≈ 316 tokens
Get PnL (cost basis) and yield earned for an Arcadia account. Returns lifetime totals: cost basis vs current value (negative cost_basis = net profit withdrawn), net transfers per token, total yield earned in USD and per token. cost_basis, current_value, cost_diff are in USD (human-readable). Per-token fields (net_transfers, summed_yields_earned) are in raw token units.
Paramètres, retour & exemple (2)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)account_address· string · requis
Arcadia account address
Exemple d'appel{"name": "read_account_pnl", "arguments": {"account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"yield_earned": {}, "pnl_cost_basis": {}}} - read_asset_list≈ 280 tokens
List supported collateral assets on Arcadia. Returns compact list (address, symbol, decimals, type). Use search to filter by symbol substring. For USD prices, use read_asset_prices.
Paramètres, retour & exemple (2)
Paramètressearch· string · optionnel
Filter assets by symbol (case-insensitive substring match)chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)
Exemple d'appel{"name": "read_asset_list", "arguments": {"search": "texte", "chain_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"total": 1, "assets": []}} - read_asset_manager_current≈ 496 tokens
Read which asset managers are currently enabled on an account, with their decoded on-chain configuration. Returns the active managers (address, protocol, initiator, decoded strategy metadata, slippage and value-loss caps, fee recipient), the intents they map to, and Merkl claim state including whether reward tokens still need registering. Managers from superseded deployments are listed separately under `deprecated`: pass their addresses to write_account_automations_delta to clear them, or run write_account_automations which disables them as part of the save. read_ok is false when chain state could not be read, in which case the result is unreliable rather than empty.
Paramètres, retour & exemple (2)
Paramètreschain_id· number · optionnel
Chain id: 8453 Base, 130 Unichain, 10 Optimismaccount_address· string · requis
Arcadia account address
Exemple d'appel{"name": "read_asset_manager_current", "arguments": {"account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"merkl": "texte", "account": "texte", "enabled": [], "read_ok": true, "chain_id": 1, "warnings": [], "deprecated": [], "inferred_intents": []}} - read_asset_manager_intents≈ 375 tokens
List the automation intents Arcadia supports, with the parameters each one accepts. Pass account_address to also get per-account availability: which intents can be enabled right now and, for any that cannot, the compatibility rule blocking it. Pass position_id as well to scope availability to one LP position. Without account_address this returns the catalog only.
Paramètres, retour & exemple (3)
Paramètreschain_id· number · optionnel
Chain id: 8453 Base, 130 Unichain, 10 Optimismposition_id· integer · optionnel
LP position (NFT) id to scope availability to. Requires account_address.account_address· string · optionnel
Arcadia account address. Include it to get live per-account availability.
Exemple d'appel{"name": "read_asset_manager_intents", "arguments": {"chain_id": 1, "position_id": 1, "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"usage": "texte", "automations": [], "shared_params": [], "availability_error": "texte"}} - read_asset_prices≈ 247 tokens
Get USD prices for one or more asset addresses. Pass a single address or comma-separated addresses. Returns a price map keyed by address.
Paramètres, retour & exemple (2)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)asset_addresses· string · requis
Single address or comma-separated addresses for price lookup
Exemple d'appel{"name": "read_asset_prices", "arguments": {"asset_addresses": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"prices": {}}} - read_guides≈ 312 tokens
Get Arcadia workflow guides and reference documentation. Call this before multi-step workflows (opening LP positions, enabling automation, closing positions) or when you need contract addresses, asset manager addresses, or strategy parameters. Topics: overview (addresses + tool catalog), automation (intent-based automation setup), strategies (step-by-step templates), selection (how to evaluate and parameterize strategies).
Paramètres, retour & exemple (1)
Paramètrestopic· string · optionnel · overview | automation | strategies | selection
overview = addresses + tool catalog, automation = intent-based automation setup, strategies = step-by-step LP templates, selection = pool evaluation + leverage sizing
Exemple d'appel{"name": "read_guides", "arguments": {"topic": "overview"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"topic": "texte", "content": "texte"}} - read_point_leaderboard≈ 260 tokens
Get the Arcadia points leaderboard (paginated). For a specific wallet's points balance, use read_wallet_points.
Paramètres, retour & exemple (2)
Paramètreslimit· number · optionnel
Max leaderboard entries to return (default 25)offset· number · optionnel
Skip first N leaderboard entries for pagination
Exemple d'appel{"name": "read_point_leaderboard", "arguments": {"limit": 1, "offset": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"limit": 1, "total": 1, "offset": 1, "leaderboard": []}} - read_pool_info≈ 286 tokens
Get detailed info for a single lending pool including APY history over time. Useful for analyzing rate trends and comparing pools. Use read_pool_list to discover pool addresses.
Paramètres, retour & exemple (3)
Paramètresdays· number · optionnel
Number of days of APY historychain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)pool_address· string · requis
Pool address
Exemple d'appel{"name": "read_pool_info", "arguments": {"pool_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"pool": {}, "apy_history": []}} - read_pool_list≈ 259 tokens
List all Arcadia lending pools: TVL, utilization, available liquidity. Key fields: interest_rate = current borrow cost, lending_apy = lender yield. All rates are decimal fractions (1.0 = 100%, 0.06 = 6%). For APY history on a specific pool, use read_pool_info.
Paramètres, retour & exemple (1)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)
Exemple d'appel{"name": "read_pool_list", "arguments": {"chain_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"pools": [], "context_notes": []}} - read_strategy_info≈ 246 tokens
Get full detail for a specific LP strategy by ID — includes APY per range width (narrower range = higher APY but more rebalancing cost/risk), pool info, and configuration. Use read_strategy_list to discover strategy IDs. All APY values are decimal fractions (1.0 = 100%, 0.05 = 5%).
Paramètres, retour & exemple (2)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)strategy_id· number · requis
Strategy ID
Exemple d'appel{"name": "read_strategy_info", "arguments": {"strategy_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - read_strategy_list≈ 400 tokens
Get Arcadia LP strategies. Use featured_only=true for curated top strategies (recommended first call). Returns a paginated list with 7d avg APY for each strategy's default range. Increase limit or use offset for pagination. All APY values are decimal fractions (1.0 = 100%, 0.05 = 5%). For full detail on a specific strategy (APY per range width), use read_strategy_info.
Paramètres, retour & exemple (4)
Paramètreslimit· number · optionnel
Max strategies to return (default 25)offset· number · optionnel
Skip first N strategies for paginationchain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)featured_only· boolean · optionnel
Return only featured/curated strategies (recommended)
Exemple d'appel{"name": "read_strategy_list", "arguments": {"limit": 1, "offset": 1, "chain_id": 1, "featured_only": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"limit": 1, "total": 1, "offset": 1, "strategies": [], "context_notes": []}} - read_strategy_recommendation≈ 255 tokens
Get a rebalancing recommendation for an Arcadia account — suggests asset changes to optimize yield. Uses 1d APY (not 7d like read_strategy_list), so recommended strategies may differ from the list ranking. APY values are decimal fractions (0.05 = 5%). weekly_earning_difference is in USD.
Paramètres, retour & exemple (2)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)account_address· string · requis
Arcadia account address
Exemple d'appel{"name": "read_strategy_recommendation", "arguments": {"account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - read_wallet_accounts≈ 266 tokens
List all Arcadia accounts owned by a wallet address. Returns a summary of each account (address, name). Call read_account_info with a specific account_address for full details like health factor, collateral, and debt.
Paramètres, retour & exemple (2)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)wallet_address· string · requis
Wallet address to list accounts for
Exemple d'appel{"name": "read_wallet_accounts", "arguments": {"wallet_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"accounts": []}} - read_wallet_allowances≈ 409 tokens
Check ERC20 token allowances for a spender address. Use before write_wallet_approve to avoid redundant approvals — skip approving if the current allowance is already sufficient.
Paramètres, retour & exemple (4)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)owner_address· string · requis
Token owner address (the wallet granting approval)spender_address· string · requis
Spender address to check allowance for (e.g. Arcadia account address)token_addresses· array · requis
ERC20 token contract addresses to check
Exemple d'appel{"name": "read_wallet_allowances", "arguments": {"owner_address": "texte", "spender_address": "texte", "token_addresses": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"tokens": []}} - read_wallet_balances≈ 441 tokens
Get native ETH and ERC20 token balances for a wallet address. Reads directly from chain via RPC multicall. Use before write_account_add_liquidity or write_account_deposit to verify the wallet has sufficient tokens. Returns both raw balance (smallest unit/wei) and formatted (human-readable) per token.
Paramètres, retour & exemple (3)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)wallet_address· string · requis
Wallet address to check balances fortoken_addresses· array · requis
ERC20 token contract addresses to check
Exemple d'appel{"name": "read_wallet_balances", "arguments": {"wallet_address": "texte", "token_addresses": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"native": {}, "tokens": []}} - read_wallet_points≈ 161 tokens
Get Arcadia points balance for a specific wallet address.
Paramètres, retour & exemple (1)
Paramètreswallet_address· string · requis
Wallet address to get points for
Exemple d'appel{"name": "read_wallet_points", "arguments": {"wallet_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - write_account_add_liquidity≈ 1098 tokens
Multi-step flash-action: atomically combines [deposit from wallet] + [use account collateral] + [swap to optimal ratio] + [mint LP] + [borrow if leveraged] in ONE transaction. Do NOT call write_account_deposit separately. Capital sources: wallet tokens (deposits array), existing account collateral (use_account_assets=true), or both. Check allowances first (read_wallet_allowances), then approve if needed (write_wallet_approve). Supports depositing multiple tokens and minting multiple LP positions in one tx. Works with both margin accounts (can leverage) and spot accounts (no leverage). For workflows, call read_guides('strategies'). The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation. expected_value_change is in raw units of the account's numeraire token (6 decimals for USDC, 18 for WETH). Negative = cost to open, positive = value gained. Compare before.total_account_value and after.total_account_value for the full picture.
Paramètres, retour & exemple (8)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)deposits· array · optionnel
Wallet tokens to deposit. Approve each token first (write.wallet.approve). Omit to use only account collateral.leverage· number · optionnel
0 = no borrow, 2 = 2x leverage. Margin accounts only.slippage· number · optionnel
Basis points, 100 = 1%positions· array · requis
LP positions to mint. For a single position, pass one entry.wallet_address· string · requis
Wallet address of the account owneraccount_address· string · requis
Arcadia account addressuse_account_assets· boolean · optionnel
If true, use ALL existing account collateral for LP minting. Fetched automatically.
Exemple d'appel{"name": "write_account_add_liquidity", "arguments": {"positions": [], "wallet_address": "texte", "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"after": {}, "before": {}, "description": "texte", "transaction": {}, "tenderly_sim_url": "texte", "tenderly_sim_status": "success", "expected_value_change": "texte"}} - write_account_automations≈ 4033 tokens
Configure an account's automations from a list of intents and return the unsigned setAssetManagers transaction. The backend resolves which asset managers each intent needs, validates that the combination is compatible, encodes the metadata and builds the calldata, so you describe the desired outcome rather than the contracts. With mode 'save' (the default) the intents array is the complete desired state: the backend diffs it against what is currently enabled, so any automation you leave out is DISABLED by the returned transaction. Pass a single intent with enabled: false to turn everything off. Mode 'preview' validates and resolves the intents WITHOUT reading chain state and returns no transaction, because its calldata carries no disable entries and would only partially apply the state. Use it to check a combination is legal or to show a plan; use 'save' to get something signable. To toggle one automation without restating the rest, use write_account_automations_delta. 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. Returns { valid, errors, warnings, human_summary, plan, diff, transaction }. When a compatibility rule fires the call returns an error and no transaction: read errors[].reason, adjust the intents and retry. There is deliberately no transaction when the account already matches the request (no_changes_needed), when the Tenderly simulation predicts a revert (an error), or in preview mode (preview_only). Call read_asset_manager_intents first to see which intents this account can enable.
Paramètres, retour & exemple (11)
Paramètresmode· string · optionnel · save | preview
save diffs against on-chain state and returns a signable transaction that also disables anything omitted. preview resolves and validates only, returning a plan and no transaction.owner· string · optionnel
Account owner EOA. Used to resolve wallet payout targets.token0· string · optionnel
Pool token0 address.token1· string · optionnel
Pool token1 address.intents· array · requis
Complete desired automation state. In save mode anything omitted is disabled, so include every automation to keep. A single intent with enabled: false disables all automations.chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)protocol· string · optionnel · slipstream_v1 | slipstream_v2 | slipstream_v3 | uniswap_v3 | uniswap_v4 | slipstream | staked_slipstream | staked_slipstream_v2
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.is_staked· boolean · optionnel
Whether the LP position is staked. Implied by a staked_* protocol value.position_id· integer · optionnel
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· array · optionnel
Staking reward token addresses.account_address· string · requis
Arcadia account address
Exemple d'appel{"name": "write_account_automations", "arguments": {"intents": [], "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"diff": {}, "plan": [], "valid": true, "errors": [], "warnings": [], "description": "texte", "transaction": {}, "preview_only": true, "human_summary": [], "simulation_url": "texte", "no_changes_needed": true, "tenderly_sim_status": "success"}} - write_account_automations_delta≈ 3817 tokens
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.
Paramètres, retour & exemple (11)
Paramètresowner· string · optionnel
Account owner EOA. Used to resolve wallet payout targets.enable· array · optionnel
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· string · optionnel
Pool token0 address.token1· string · optionnel
Pool token1 address.disable· array · optionnel
Asset-manager addresses to switch off, as returned by read.asset_manager.current.chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)protocol· string · optionnel · slipstream_v1 | slipstream_v2 | slipstream_v3 | uniswap_v3 | uniswap_v4 | slipstream | staked_slipstream | staked_slipstream_v2
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.is_staked· boolean · optionnel
Whether the LP position is staked. Implied by a staked_* protocol value.position_id· integer · optionnel
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· array · optionnel
Staking reward token addresses.account_address· string · requis
Arcadia account address
Exemple d'appel{"name": "write_account_automations_delta", "arguments": {"account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"diff": {}, "plan": [], "valid": true, "errors": [], "warnings": [], "description": "texte", "transaction": {}, "preview_only": true, "human_summary": [], "simulation_url": "texte", "no_changes_needed": true, "tenderly_sim_status": "success"}} - write_account_borrow≈ 502 tokens
Build an unsigned transaction to borrow from an Arcadia lending pool against account collateral. NOT needed for leveraged LP — write_account_add_liquidity handles borrowing internally when leverage > 0. Only works with margin accounts (created with a creditor/lending pool). Spot accounts (no creditor) cannot borrow — the tool will validate this and reject. Before borrowing, verify the account has positive free margin via read_account_info: collateral_value must exceed used_margin.
Paramètres, retour & exemple (5)
Paramètresto· string · requis
Address to receive borrowed tokensamount· string · requis
Amount in raw unitschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)pool_address· string · requis
Lending pool: LP_WETH=0x803ea69c7e87D1d6C86adeB40CB636cC0E6B98E2, LP_USDC=0x3ec4a293Fb906DD2Cd440c20dECB250DeF141dF1, LP_CBBTC=0xa37E9b4369dc20940009030BfbC2088F09645e3Baccount_address· string · requis
Arcadia account address used as collateral
Exemple d'appel{"name": "write_account_borrow", "arguments": {"to": "texte", "amount": "texte", "pool_address": "texte", "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}} - write_account_close≈ 1181 tokens
Atomic flash-action that closes an Arcadia account position in ONE transaction. Combines up to 3 steps atomically: [burn LP position] + [swap all tokens to a single target asset] + [repay debt]. Tokens remain in the account after closing — use write_account_withdraw to send them to your wallet. ALWAYS try this tool first when closing/exiting a position. Only fall back to individual tools (write_account_remove_liquidity, write_account_swap, write_account_deleverage, write_account_withdraw) if this tool fails. Supports two modes: - close_lp_only=true: Burns LP and leaves underlying tokens in the account. Use as step 1 if the full close fails, then call again with close_lp_only=false to swap+repay the remaining tokens. - close_lp_only=false (default): Full atomic close — burns LP, swaps everything to receive_assets, repays debt. Remaining tokens stay in the account. Follow up with write_account_withdraw to send to wallet. Supports multiple receive assets with custom distribution. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation.
Paramètres, retour & exemple (6)
Paramètresassets· array · requis
Assets to close/sell from the account. IMPORTANT: For LP positions (NFTs), always use amount='1' and decimals=1 — do NOT pass the liquidity amount. asset_address = position manager, asset_id = NFT token ID. For ERC20 tokens: asset_id = 0, amount = full balance in raw units, decimals = real token decimals. Get all values from read.account.info.chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)slippage· number · optionnel
Basis points, 100 = 1%close_lp_only· boolean · optionnel
true = only burn LP positions, leave underlying tokens in account. false = full close (burn + swap + repay).receive_assets· array · optionnel
Target assets to receive after closing. For a single target, pass one entry. Required when close_lp_only=false. Omit for close_lp_only=true.account_address· string · requis
Arcadia account address
Exemple d'appel{"name": "write_account_close", "arguments": {"assets": [], "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"after": {}, "before": {}, "description": "texte", "transaction": {}, "tenderly_sim_url": "texte", "tenderly_sim_status": "success", "expected_value_change": "texte"}} - write_account_create≈ 475 tokens
Build an unsigned transaction to create a new Arcadia account via the Factory contract. account_version: 3 with creditor → V3 margin account (can borrow/leverage). account_version: 0 or 4 → V4 spot account (no borrowing, creditor is ignored, any ERC20 allowed). Returns the predicted account address (deterministic via CREATE2).
Paramètres, retour & exemple (5)
Paramètressalt· number · requis
Unique salt (uint32) for deterministic account addresschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)creditor· string · optionnel
Lending pool address for V3 margin account. Ignored for V4 spot accounts (version 0 or 4).wallet_address· string · requis
Wallet address that will send the transaction (tx.origin, needed for address prediction)account_version· number · optionnel
Account version: 0 = latest (V4 spot), 3 = margin (can borrow). 1/2 = legacy.
Exemple d'appel{"name": "write_account_create", "arguments": {"salt": 1, "wallet_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}} - write_account_deleverage≈ 714 tokens
Multi-step flash-action: sells account collateral to the debt token and repays in one atomic transaction — no wallet tokens needed. To repay from wallet tokens instead, use write_account_repay. NOTE: If you are closing a position (remove LP + swap + repay + withdraw), prefer write_account_close which batches everything atomically. Only use this tool for standalone repayment while keeping the position active. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation — if tenderly_sim_status is 'false', do NOT broadcast the transaction.
Paramètres, retour & exemple (7)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)creditor· string · requis
Lending pool addressslippage· number · optionnel
Basis points, 100 = 1%amount_in· string · requis
Collateral amount to sell (raw units)numeraire· string · requis
Debt token addressasset_from· string · requis
Collateral token to sellaccount_address· string · requis
Arcadia account address
Exemple d'appel{"name": "write_account_deleverage", "arguments": {"creditor": "texte", "amount_in": "texte", "numeraire": "texte", "asset_from": "texte", "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"after": {}, "before": {}, "description": "texte", "transaction": {}, "tenderly_sim_url": "texte", "tenderly_sim_status": "success", "expected_value_change": "texte"}} - write_account_deposit≈ 567 tokens
Build an unsigned transaction to deposit assets into an Arcadia account as collateral. Supports ERC20 tokens and ERC721 NFTs (LP positions). NOT needed before write_account_add_liquidity — that tool deposits from wallet atomically. Ensure the account is approved first (call read_wallet_allowances to check, then write_wallet_approve if needed). Account version is auto-detected on-chain (override with account_version if needed).
Paramètres, retour & exemple (7)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)asset_ids· array · optionnel
Token IDs: 0 for ERC20, NFT token ID for ERC721asset_types· array · optionnel
V4 only. Asset types per asset: 1=ERC20, 2=ERC721, 3=ERC1155. If omitted, inferred from asset_ids (non-zero → ERC721).asset_amounts· array · requis
Amounts in raw units/wei, one per assetaccount_address· string · requis
Arcadia account addressaccount_version· number · optionnel
Override account version (3 or 4). Auto-detected on-chain if omitted.asset_addresses· array · requis
Token contract addresses to deposit
Exemple d'appel{"name": "write_account_deposit", "arguments": {"asset_amounts": [], "account_address": "texte", "asset_addresses": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}} - write_account_remove_liquidity≈ 654 tokens
Flash-action: PARTIALLY decreases liquidity from an LP position. The position remains open with reduced liquidity; underlying tokens stay in the account. For FULL position exit (burn LP + swap + repay + withdraw), use write_account_close instead — it batches everything into one atomic transaction. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation.
Paramètres, retour & exemple (5)
Paramètresasset_id· number · requis
NFT token IDchain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)adjustment· string · requis
Liquidity amount to remove (raw uint128 value as string). Must be less than total liquidity — for full removal use write.account.close.asset_address· string · requis
Position manager contractaccount_address· string · requis
Arcadia account address
Exemple d'appel{"name": "write_account_remove_liquidity", "arguments": {"asset_id": 1, "adjustment": "texte", "asset_address": "texte", "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"after": {}, "before": {}, "description": "texte", "transaction": {}, "tenderly_sim_url": "texte", "tenderly_sim_status": "success", "expected_value_change": "texte"}} - write_account_repay≈ 458 tokens
Repay debt to an Arcadia lending pool using tokens from the wallet (requires ERC20 allowance). To repay using account collateral instead (no wallet tokens needed), use write_account_deleverage. Check allowance first (read_wallet_allowances), then approve the pool if needed (write_wallet_approve). Check outstanding debt with read_account_info.
Paramètres, retour & exemple (4)
Paramètresamount· string · requis
Amount in raw units, or 'max_uint256' to repay all debt in fullchain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)pool_address· string · requis
Lending pool address. Base: LP_WETH=0x803ea69c7e87D1d6C86adeB40CB636cC0E6B98E2, LP_USDC=0x3ec4a293Fb906DD2Cd440c20dECB250DeF141dF1, LP_CBBTC=0xa37E9b4369dc20940009030BfbC2088F09645e3Baccount_address· string · requis
Arcadia account address with debt
Exemple d'appel{"name": "write_account_repay", "arguments": {"amount": "texte", "pool_address": "texte", "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}} - write_account_stake≈ 640 tokens
Flash-action: stake, unstake, or claim rewards for an LP position in one atomic transaction. Use the `action` parameter to select the operation. `asset_address` is the position manager contract — pass the non-staked PM address when staking, or the staked PM address when unstaking. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Tenderly simulation may not be available for this endpoint — verify the position exists with read_account_info before signing.
Paramètres, retour & exemple (5)
Paramètresaction· string · requis · stake | unstake | claim
Action to performasset_id· number · requis
NFT token ID of the LP positionchain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)asset_address· string · requis
Position manager contract addressaccount_address· string · requis
Arcadia account address
Exemple d'appel{"name": "write_account_stake", "arguments": {"action": "stake", "asset_id": 1, "asset_address": "texte", "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"after": {}, "before": {}, "description": "texte", "transaction": {}, "tenderly_sim_url": "texte", "tenderly_sim_status": "success", "expected_value_change": "texte"}} - write_account_swap≈ 660 tokens
Flash-action: swaps assets within an Arcadia account in one atomic transaction. The backend finds the optimal swap route. NOTE: If you are closing a position (swap + repay + withdraw), prefer write_account_close which batches everything atomically. Only use this tool for standalone swaps within an active position. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation — if tenderly_sim_status is 'false', do NOT broadcast the transaction.
Paramètres, retour & exemple (6)
Paramètresasset_to· string · requis
Token address to swap tochain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)slippage· number · optionnel
Basis points, 100 = 1%amount_in· string · requis
Raw unitsasset_from· string · requis
Token address to swap fromaccount_address· string · requis
Arcadia account address
Exemple d'appel{"name": "write_account_swap", "arguments": {"asset_to": "texte", "amount_in": "texte", "asset_from": "texte", "account_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"after": {}, "before": {}, "description": "texte", "transaction": {}, "tenderly_sim_url": "texte", "tenderly_sim_status": "success", "expected_value_change": "texte"}} - write_account_withdraw≈ 554 tokens
Build an unsigned transaction to withdraw assets from an Arcadia account to the owner's wallet. Only the account owner can withdraw. Will revert if the account has debt and withdrawal would make it undercollateralized. Does not support max_uint256 — pass exact amounts from read_account_info. Account version is auto-detected on-chain (override with account_version if needed).
Paramètres, retour & exemple (7)
Paramètreschain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)asset_ids· array · optionnel
Token IDs: 0 for ERC20, NFT token ID for ERC721asset_types· array · optionnel
V4 only. Asset types per asset: 1=ERC20, 2=ERC721, 3=ERC1155. If omitted, inferred from asset_ids (non-zero → ERC721).asset_amounts· array · requis
Amounts in raw units/wei, one per assetaccount_address· string · requis
Arcadia account addressaccount_version· number · optionnel
Override account version (3 or 4). Auto-detected on-chain if omitted.asset_addresses· array · requis
Token contract addresses to withdraw
Exemple d'appel{"name": "write_account_withdraw", "arguments": {"asset_amounts": [], "account_address": "texte", "asset_addresses": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}} - write_pool_deposit≈ 463 tokens
Build an unsigned deposit transaction into an Arcadia lending tranche (ERC-4626). Lenders deposit the pool's underlying asset (USDC/WETH/cbBTC) and receive tranche shares that accrue interest from borrowers. Requires prior ERC-20 approval to the tranche (see write_wallet_approve). To check current lender yield, call read_pool_list or read_pool_info.
Paramètres, retour & exemple (4)
Paramètresassets· string · requis
Amount of underlying asset to deposit, in raw units (e.g. '1000000' = 1 USDC since USDC has 6 decimals).chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)receiver· string · requis
Address that receives the minted tranche shares. Usually the depositor's own wallet.tranche_address· string · requis
Tranche contract address (ERC-4626 vault). Get this from read.pool.list — each pool's `tranches[0].address`.
Exemple d'appel{"name": "write_pool_deposit", "arguments": {"assets": "texte", "receiver": "texte", "tranche_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}} - write_pool_redeem≈ 479 tokens
Build an unsigned redeem transaction to withdraw from an Arcadia lending tranche (ERC-4626). Burns tranche shares and returns the corresponding amount of underlying asset, including accrued interest. The owner must be the shares holder; receiver is where the underlying asset is sent.
Paramètres, retour & exemple (5)
Paramètresowner· string · requis
Address that owns the tranche shares being burned. Normally the signer's own wallet.shares· string · requis
Amount of tranche shares to burn, in raw units. To redeem everything, use the owner's full share balance.chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)receiver· string · requis
Address that receives the underlying asset. Usually the owner's own wallet.tranche_address· string · requis
Tranche contract address (ERC-4626 vault). Get this from read.pool.list — each pool's `tranches[0].address`.
Exemple d'appel{"name": "write_pool_redeem", "arguments": {"owner": "texte", "shares": "texte", "receiver": "texte", "tranche_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}} - write_wallet_approve≈ 508 tokens
Build an unsigned approval transaction. For ERC20 tokens: generates approve(spender, amount). For ERC721/ERC1155 NFTs (e.g. LP positions): generates setApprovalForAll(operator, true). Required before write_account_deposit or write_account_add_liquidity (when depositing from wallet). Tip: call read_wallet_allowances first to check if approval already exists — skip this if the current allowance is sufficient.
Paramètres, retour & exemple (5)
Paramètresamount· string · optionnel
ERC20 only: amount in raw units, or 'max_uint256' for unlimited. Ignored for NFTs.chain_id· number · optionnel
Chain ID: 8453 (Base), 130 (Unichain), 10 (Optimism), or 4663 (Robinhood)asset_type· string · optionnel · erc20 | erc721 | erc1155
Token type: 'erc20' (default) for fungible tokens, 'erc721' or 'erc1155' for NFTs (LP positions)token_address· string · requis
Token contract address to approvespender_address· string · requis
Address being approved — use the Arcadia account address for deposits
Exemple d'appel{"name": "write_wallet_approve", "arguments": {"token_address": "texte", "spender_address": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"description": "texte", "transaction": {}, "predicted_account_address": "texte"}}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».