Arcadia Finance MCP Server

MCP server for Arcadia Finance, a platform to manage Uniswap and Aerodrome concentrated liquidity positions with built-in leverage, automated rebalancing, and yield optimization. Read protocol data and build unsigned transactions for LP management, borrowing, deposits, and more.

Designed for AI agents (Claude, Cursor, etc.) to interact with Arcadia onchain.

Install

Tools

Read Tools

| Tool | Description |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| read.account.info | Account overview: 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 address. |
| read.wallet.balances | On-chain ERC20 balances and native ETH for a wallet address. |
| read.wallet.allowances | Check ERC20 token allowances for a spender. Use before write.wallet.approve to avoid redundant approvals. |
| read.wallet.points | Points balance for a specific wallet address. |
| read.asset.list | Supported collateral assets with addresses, types, decimals. |
| read.asset.prices | USD prices for one or more asset addresses. |
| read.pool.list | All lending pools: TVL, APY, utilization, liquidity. |
| read.pool.info | Single pool detail with APY history over time. |
| read.point_leaderboard | Paginated Arcadia points leaderboard. |
| read.strategy.list | LP strategies with APY, underlyings, pool info. Supports featured filter and pagination. |
| read.strategy.info | Full detail for a specific LP strategy: APY per range width, pool config. |
| read.strategy.recommendation | Rebalancing recommendation for an account. |
| read.guides | Reference guides: automation setup, strategy selection, strategy templates. |
| read.asset_manager.intents | Available automation intents with tool names, required params, and supported chains. |

Write Tools

All write tools return unsigned transactions as { to, data, value, chainId }.

| Tool | Description |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| write.wallet.approve | Approve an ERC20 token for spending. Required before depositing into an account. Call read.wallet.allowances first to check if already approved. |
| write.account.create | Create a new Arcadia account via Factory. |
| write.account.deposit | Deposit ERC20 tokens into an account. |
| write.account.withdraw | Withdraw assets from an account. |
| write.account.borrow | Borrow from a lending pool. |
| write.account.repay | Repay debt to a lending pool from wallet. |
| write.account.add_liquidity | Flash-action: deposit + swap + mint LP + optional leverage, atomically. |
| write.account.remove_liquidity | Remove/decrease LP position liquidity. |
| write.account.swap | Swap assets within an account (backend-routed). |
| write.account.deleverage | Repay debt by selling collateral (swap + repay in one tx). |
| write.account.close | Atomic close: burn LP + swap + repay debt in one tx. |
| write.account.stake | Stake, unstake, or claim rewards for LP positions. |
| write.asset_manager.rebalancer | Encode rebalancer automation args (strategy config, triggers, compound mode). |
| write.asset_manager.compounder | Encode standalone compounder args. |
| write.asset_manager.compounder_staked | Encode compounder + CowSwap coupled args (sell rewards, buy target token). |
| write.asset_manager.yield_claimer | Encode yield claimer args (claim fees to recipient). |
| write.asset_manager.yield_claimer_cowswap | Encode yield claimer + CowSwap coupled args. |
| write.asset_manager.cow_swapper | Encode direct CowSwap mode args (Base only). |
| write.asset_manager.merkl_operator | Encode Merkl operator args (claim external rewards). |
| write.account.set_asset_managers | Build unsigned setAssetManagers tx from encoded intent args. Combine multiple intents by merging arrays. |

Dev Tools

Always registered but requires PK env var to function.

| Tool | Description |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| dev.send | Sign and broadcast an unsigned transaction using a local private key (PK env var). Not for production — use a dedicated wallet MCP server instead. |

Transaction Signing

All write tools return unsigned transactions as { to, data, value, chainId }. This server does NOT sign or broadcast — your agent or application is responsible for that.

Options

Wallet infrastructure (recommended for production):
Use your existing wallet setup — MPC wallets (Fireblocks, Dfns, Turnkey), smart accounts (Safe, Biconomy), or embedded wallets (Privy, Dynamic). Pass the unsigned tx object to your provider's signing method.

viem/ethers in your agent:

import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
const account = privateKeyToAccount("0x...");

const client = createWalletClient({ account, chain: base, transport: http() });
// tx = result from any write.* tool

const hash = await client.sendTransaction(tx);

Built-in dev.send tool (development only):
The server includes a dev-only signing tool that reads a private key from the PK environment variable. Set PK via a .env file or your MCP client config:

```bash