What can you do with this server?

The Arcadia Finance MCP Server enables AI agents to interact with the Arcadia Finance protocol for managing Uniswap and Aerodrome concentrated liquidity positions with leverage, automated rebalancing, and yield optimization on Base (chain ID 8453) and Unichain (chain ID 130). Read Capabilities: * Account Data: Full account overviews (health factor, collateral, debt, liquidation price, automation status), historical values, PnL/yield data, and listing all accounts for a wallet * Wallet Inspection: On-chain ERC20/ETH balances, token allowances, and points balances/leaderboard * Asset & Pool Data: Supported collateral assets with prices, lending pools (TVL, APY, utilization, history) * Strategy Discovery: LP strategies with APY data, per-range-width APY details, and rebalancing recommendations * Automation Intents: Available intents with required parameters and supported chains * Guides & Reference: Workflow guides for automation setup, strategy selection, and step-by-step LP templates Write Capabilities (returns unsigned transactions): * Approvals: Approve ERC20/ERC721/ERC1155 tokens for spending * Account Lifecycle: Create accounts (V3 margin or V4 spot), deposit assets as collateral, withdraw assets to wallet * Borrowing & Repaying: Borrow from lending pools, repay debt, or deleverage atomically (sell collateral → repay) * Liquidity Management: Add liquidity (atomic: deposit + swap + mint LP + optional leverage), partially remove liquidity, or fully close positions (burn LP + swap + repay atomically) * Trading & Staking: Swap assets within an account; stake, unstake, or claim LP rewards * Automation Setup: Configure asset managers (rebalancer, compounder, yield claimer, Merkl operator, CowSwap integrator) with parameters like trigger ratios and fee recipients; grant/revoke asset manager permissions Many write tools include Tenderly simulation URLs for pre-broadcast validation. Dev Tools: * dev.send: Sign and broadcast unsigned transactions using a local private key (development/testing only, not for production)

Which integrations are available for this server?

Allows managing concentrated liquidity positions, borrowing assets, and performing yield optimization on the Optimism network through the Arcadia Finance protocol.

The Arcadia Finance MCP Server enables AI agents to interact with the Arcadia Finance protocol for managing Uniswap and Aerodrome concentrated liquidity positions with leverage, automated rebalancing, and yield optimization on Base (chain ID 8453) and Unichain (chain ID 130).

Read Capabilities:

Account Data: Full account overviews (health factor, collateral, debt, liquidation price, automation status), historical values, PnL/yield data, and listing all accounts for a wallet
Wallet Inspection: On-chain ERC20/ETH balances, token allowances, and points balances/leaderboard
Asset & Pool Data: Supported collateral assets with prices, lending pools (TVL, APY, utilization, history)
Strategy Discovery: LP strategies with APY data, per-range-width APY details, and rebalancing recommendations
Automation Intents: Available intents with required parameters and supported chains
Guides & Reference: Workflow guides for automation setup, strategy selection, and step-by-step LP templates

Write Capabilities (returns unsigned transactions):

Approvals: Approve ERC20/ERC721/ERC1155 tokens for spending
Account Lifecycle: Create accounts (V3 margin or V4 spot), deposit assets as collateral, withdraw assets to wallet
Borrowing & Repaying: Borrow from lending pools, repay debt, or deleverage atomically (sell collateral → repay)
Liquidity Management: Add liquidity (atomic: deposit + swap + mint LP + optional leverage), partially remove liquidity, or fully close positions (burn LP + swap + repay atomically)
Trading & Staking: Swap assets within an account; stake, unstake, or claim LP rewards
Automation Setup: Configure asset managers (rebalancer, compounder, yield claimer, Merkl operator, CowSwap integrator) with parameters like trigger ratios and fee recipients; grant/revoke asset manager permissions

Many write tools include Tenderly simulation URLs for pre-broadcast validation.

Dev Tools:

dev.send: Sign and broadcast unsigned transactions using a local private key (development/testing only, not for production)

Arcadia Finance MCP Server

npm npm downloads License: AGPL-3.0 TypeScript MCP MCP Badge Glama

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

Install in VS Code Install in Cursor

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 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:

# .env in the server directory (never commit — already gitignored)
PK=0xYourPrivateKeyHex
RPC_URL_BASE=https://base-mainnet.g.alchemy.com/v2/your-key

The server loads .env automatically on startup. Works with any MCP client (Claude Desktop, Claude Code, VSCode, Cursor). MCP client env block settings take precedence if both are set.

Not for production — use a dedicated wallet MCP server (Fireblocks, Turnkey, Safe) instead.

Setup

Prerequisites: Node.js >= 22

yarn install
yarn build

Environment variables:

Variable	Required	Default	Transport	Description
`RPC_URL_BASE`	No	Public RPC	Both	RPC URL for Base (8453).
`RPC_URL_UNICHAIN`	No	Public RPC	Both	RPC URL for Unichain (130).
`PK`	No	—	Both	Private key (hex) for dev-only `dev.send` tool.
`TRANSPORT`	No	`stdio`	—	Transport mode: `stdio` or `http`.
`PORT`	No	`3000`	HTTP	Listen port for HTTP transport.
`ALLOWED_ORIGINS`	No	`https://mcp.arcadia.finance`	HTTP	Comma-separated allowed Origin headers (CORS / DNS rebinding).
`RATE_LIMIT_RPM`	No	`60`	HTTP	Max requests per minute per session.

Supported chains: Base (8453), Unichain (130)

MCP Client Configuration

Remote (no install needed):

{
  "mcpServers": {
    "arcadia-finance": {
      "url": "https://mcp.arcadia.finance/mcp"
    }
  }
}

Via npx (local stdio):

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "npx",
      "args": ["-y", "@arcadia-finance/mcp-server"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

Claude Code:

# Remote
claude mcp add arcadia-finance --transport http https://mcp.arcadia.finance/mcp

# Local
claude mcp add arcadia-finance -- npx -y @arcadia-finance/mcp-server

From source (local development):

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

Skills

The skills/ directory contains Claude Code skills that teach AI agents how to use this MCP server effectively. To install a skill, symlink it into your Claude skills directory:

ln -s /path/to/mcp-server/skills/clamm-liquidity ~/.claude/skills/clamm-liquidity

Available skills:

Skill	Description
`clamm-liquidity`	Concentrated liquidity management: concepts, asset managers (rebalancers, compounders), and step-by-step workflows.

Reporting Issues

Found a bug, missing feature, or unclear documentation while using this server? Open an issue: https://github.com/arcadia-finance/mcp-server/issues

For AI agents: If you hit a gap during task execution, open an issue with:

Tool name and parameters you used
What you expected vs what happened
The strategy or goal you were trying to execute

Pull requests for documentation fixes are welcome from agents and humans alike. All PRs require human review before merging.

Where to Find Us

npm: @arcadia-finance/mcp-server
Smithery: smithery.ai/@arcadia-finance/mcp-server
PulseMCP: pulsemcp.com
MCP Market: mcpmarket.com
awesome-mcp-servers (punkpeye): github.com/punkpeye/awesome-mcp-servers
awesome-mcp-servers (wong2): github.com/wong2/awesome-mcp-servers

Development

yarn dev          # Run with tsx (hot reload)
yarn build        # Compile TypeScript
yarn test         # Run tests
yarn lint         # Lint with ESLint
yarn format       # Check formatting with Prettier