Arcadia Finance#

Agent note: {baseDir} refers to the directory containing this SKILL.md file. Resolve all {baseDir} paths relative to it.

Arcadia helps users deploy concentrated liquidity positions on Uniswap, Aerodrome, and Velodrome with automated rebalancing, compounding, yield optimization, and optional leverage, or provide single-sided liquidity to lending pools to earn borrower interest. Supported chains: Base (8453), Unichain (130), Optimism (10).

CLI Usage#

bash

# Discover all available tools (run this first)
{baseDir}/arcadia.sh --list

# Call a specific tool
{baseDir}/arcadia.sh <tool_name> '<json_args>'

Requires: curl, jq. No other dependencies.

Read Operations#

bash

# List all accounts for a wallet
{baseDir}/arcadia.sh read_wallet_accounts '{"wallet_address":"0x..."}'

# Account details (health factor, collateral, debt, positions)
{baseDir}/arcadia.sh read_account_info '{"account_address":"0x..."}'

# Featured LP strategies with APY
{baseDir}/arcadia.sh read_strategy_list '{"featured_only":true}'

# Lending pools (TVL, APY, utilization)
{baseDir}/arcadia.sh read_pool_list '{}'

# Workflow guides (automation setup, strategy selection)
{baseDir}/arcadia.sh read_guides '{"topic":"overview"}'

# Available automations (rebalancer, compounder, yield claimer)
{baseDir}/arcadia.sh read_asset_manager_intents '{}'

Single-Sided Liquidity (Lending)#

Provide single-sided liquidity by depositing the pool's underlying asset into an Arcadia lending tranche (ERC-4626), earning interest from borrowers. Use read_pool_list to find tranches[0].address for each pool. Approve the tranche first ( write_wallet_approve).

bash

# Lender deposit: lend 10 USDC into the USDC tranche, receive shares to your wallet
{baseDir}/arcadia.sh write_pool_deposit '{"tranche_address":"0x...","assets":"10000000","receiver":"0x...","chain_id":8453}'

# Lender exit: redeem shares back to the underlying asset
{baseDir}/arcadia.sh write_pool_redeem '{"tranche_address":"0x...","shares":"10000000","receiver":"0x...","owner":"0x...","chain_id":8453}'

write_pool_deposit is for lenders earning yield. For depositing collateral into an Arcadia account, use write_account_deposit instead.

Write Operations#

All write tools return unsigned transactions { to, data, value, chainId }. Sign with your wallet before broadcasting. See {baseDir}/wallet-signing.md for wallet options.

bash

# Open LP position (deposits + swaps + mints LP atomically)
{baseDir}/arcadia.sh write_account_add_liquidity '{"account_address":"0x...","wallet_address":"0x...","positions":[{"strategy_id":123}],"deposits":[{"asset":"0x...","amount":"1000000","decimals":6}]}'

# Close position (burn LP + swap + repay in one tx)
{baseDir}/arcadia.sh write_account_close '{"account_address":"0x...","assets":[...],"receive_assets":[...]}'

# Create a new account (salt must be unique per wallet)
{baseDir}/arcadia.sh write_account_create '{"wallet_address":"0x...","salt":1,"chain_id":8453}'

# Enable automation
{baseDir}/arcadia.sh read_asset_manager_intents '{"account_address":"0x...","chain_id":8453}'
{baseDir}/arcadia.sh write_account_automations '{"account_address":"0x...","position_id":12345,"intents":[{"kind":"compound_fees"},{"kind":"rebalance"}],"chain_id":8453}'

Configuration#

The CLI connects to https://mcp.arcadia.finance/mcp by default. Set ARCADIA_MCP_URL to override (e.g. for local development).

Data and Safety#

This skill connects to Arcadia's public API at https://mcp.arcadia.finance/mcp (override via ARCADIA_MCP_URL). Tool calls send public wallet addresses, account addresses, and transaction parameters to this server. This is the same data that is publicly visible on-chain. No private keys or signing capabilities are transmitted.

• Write tools return unsigned transactions only. Never auto-sign.
• Always confirm transaction details with the user before signing.
• Check account health factor with read_account_info before risky operations.
• Do not pass private keys or secrets as tool arguments. Only public addresses and amounts are needed.

References#

• Full tool documentation: https://mcp.arcadia.finance/llms-full.txt
• Contract addresses: see {baseDir}/contracts.md
• Signing guide: see {baseDir}/wallet-signing.md
• Website: https://arcadia.finance
• Docs: https://docs.arcadia.finance