# Arcadia Finance MCP Server

> MCP server for Arcadia Finance, a DeFi protocol for concentrated liquidity (Uniswap v3/v4, Aero CL, Aerodrome/Slipstream, Velodrome) with automated rebalancing, compounding, yield optimization, and leverage, or single-sided liquidity into lending pools. Supported chains: Base (8453), Unichain (130), Optimism (10), Robinhood (4663).

## Overview

Arcadia lets users deploy concentrated liquidity positions with automated rebalancing, compounding, yield optimization, and leverage, or provide single-sided liquidity to lending pools to earn borrower interest. This MCP server exposes the full protocol as 38 tools:

- **Account management**: health factor, collateral, debt, positions, PnL, history
- **Wallet**: ERC20 balances, allowances, owned accounts, points
- **Lending pools**: TVL, APY, utilization, available liquidity, rate history
- **Single-sided liquidity**: deposit a single asset into a lending pool (ERC-4626 tranche) to earn borrower interest
- **LP strategies**: concentrated liquidity strategies with APY per range width, recommendations
- **Transaction building**: unsigned calldata for deposits, borrows, swaps, LP minting/closing, staking
- **Automation**: configure automations from intents (compound fees, claim rewards, add to LP, rebalance, claim Merkl); the backend resolves the asset managers and returns the calldata

All write tools return unsigned transactions (`{ to, data, value, chainId }`). Signing is the client's responsibility.

## Install

```
npx -y @arcadia-finance/mcp-server
```

Or connect to the remote server: `https://mcp.arcadia.finance/mcp`

## Tools (38 total)

### Read (19)

- read_account_info: account overview with health factor, collateral, debt, positions, liquidation price, automation status
- read_account_history: historical account value over time
- read_account_pnl: PnL and yield data for an account
- read_wallet_accounts: list all Arcadia accounts owned by a wallet
- read_wallet_balances: ERC20 and native ETH balances for a wallet
- read_wallet_allowances: check ERC20 token allowances for a spender
- read_wallet_points: Arcadia points balance for a wallet
- read_asset_list: supported collateral assets with addresses, types, decimals
- read_asset_prices: USD prices for asset addresses
- read_pool_list: all lending pools with TVL, APY, utilization, liquidity
- read_pool_info: single pool detail with APY history
- read_point_leaderboard: paginated points leaderboard
- read_strategy_list: LP strategies with APY, underlyings, pool info
- read_strategy_info: full detail for a specific LP strategy
- read_strategy_recommendation: rebalancing recommendation for an account
- read_guides: reference guides for automation, strategies, addresses
- read_asset_manager_intents: automation intents and their params; pass account_address for live per-account availability
- read_asset_manager_current: automations enabled on an account, with decoded per-manager config, mapped intents, Merkl state, and superseded managers
- read_account_aero_upgrade: what a wallet's accounts (or one account) have to upgrade to Aero, per account status and counts, no calldata

### Write (18)

- write_wallet_approve: approve ERC20/ERC721 for spending
- write_wallet_upgrade_velo: upgrade wallet VELO on Optimism to the new AERO on Base
- write_pool_deposit: deposit the pool's underlying asset into an ERC-4626 tranche to earn lender yield
- write_pool_redeem: burn tranche shares and redeem the underlying asset (lender exit)
- write_account_create: create a new Arcadia account
- write_account_deposit: deposit assets into an account
- write_account_withdraw: withdraw assets from an account
- write_account_borrow: borrow from a lending pool
- write_account_repay: repay debt from wallet tokens
- write_account_add_liquidity: flash-action that deposits, swaps, mints LP, and optionally leverages atomically
- write_account_remove_liquidity: partially decrease LP position liquidity
- write_account_swap: swap assets within an account
- write_account_deleverage: repay debt by selling collateral
- write_account_close: atomic close that burns LP, swaps, and repays in one tx
- write_account_stake: stake, unstake, or claim LP rewards
- write_account_aero_upgrade: upgrade an account to Aero in one flashAction: Slipstream positions move to Aero CL, old AERO becomes the new AERO; returns the plan and the transaction for the items that are ready
- write_account_automations: configure automations from an intents array (complete desired state), returns the unsigned setAssetManagers tx
- write_account_automations_delta: switch individual automations on or off, leaving the rest untouched

### Dev (1)

- dev_send: sign and broadcast using local private key (dev only)

## Links

- Website: https://arcadia.finance
- Docs: https://docs.arcadia.finance
- npm: https://www.npmjs.com/package/@arcadia-finance/mcp-server