MCP Server

Use the Arcadia MCP Server to let AI agents manage liquidity positions, borrow, deposit, and interact with the Arcadia Protocol via Claude, Cursor, or any MCP-compatible client.

The Arcadia MCP Server enables AI agents to interact with the Arcadia Protocol through the Model Context Protocol. It supports reading protocol data and building unsigned transactions for LP management, borrowing, deposits, and more.

Supported networks: Base (8453), Unichain (130), and Optimism (10).

Setup

Remote (recommended)

No installation required. Point your MCP client to the hosted server:

https://mcp.arcadia.finance/mcp

Claude Code:

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

Claude Desktop / Cursor / Windsurf:

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

Local (via npx)

Running locally allows you to provide your own RPC endpoints and use the dev signing tool.

Claude Code:

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

Claude Desktop / Cursor / Windsurf:

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

Environment Variables

Variable	Required	Description
RPC_URL_BASE	No	Base RPC endpoint (falls back to public RPC)
RPC_URL_UNICHAIN	No	Unichain RPC endpoint (falls back to public RPC)
RPC_URL_OPTIMISM	No	Optimism RPC endpoint (falls back to public RPC)
PK	No	Private key for the dev.send tool (development only)

Available Tools

Read Tools

Tool	Description
read_account_info	Health factor, collateral, debt, positions, liquidation price
read_account_history	Historical account value tracking
read_account_pnl	Yield and P&L data
read_assets	Supported collateral with addresses, types, decimals, USD pricing
read_wallet_balances	ERC20 and ETH balances for any address
read_wallet_allowance	Check token approvals before deposits
read_points	Wallet points balance or leaderboard
read_pools	TVL, APY, utilization, liquidity, historical APY trends
read_strategy_list	LP strategies with APY, underlying assets, pool info
read_strategy_recommendation	Rebalancing suggestions for an account
read_guides	Documentation on automation, strategy selection, templates

Write Tools

All write tools return unsigned transactions ({ to, data, value, chainId }). They do not sign or broadcast.

Tool	Description
write_wallet_approve	Grant token spending permissions
write_account_create	Deploy 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
write_account_add_liquidity	Flash-action: deposit + swap + mint LP position
write_account_remove_liquidity	Remove liquidity from a position
write_account_close	Atomically burn position + swap + repay
write_account_swap	Token swap within an account
write_account_deleverage	Sell collateral to repay debt atomically
write_account_stake	Stake LP positions for rewards
write_asset_manager_set	Enable an asset manager on an account
write_asset_manager_configure	Configure rebalancing/compounding parameters

Development Tools

Tool	Description
dev.send	Sign and broadcast a transaction using a local private key (requires PK env var, development only)

Transaction Signing

The MCP server returns unsigned transactions only. To execute them in production, pass the transaction object to your signing infrastructure:

• MPC wallets: Fireblocks, Dfns, Turnkey

• Smart accounts: Safe, Biconomy

• Embedded wallets: Privy, Dynamic

• Client-side: viem or ethers

const hash = await walletClient.sendTransaction(tx);

For local development and testing, use the dev.send tool with the PK environment variable.

Skills

The MCP server repository includes skills for Claude Code that provide domain knowledge about Arcadia workflows, concentrated liquidity management, asset manager patterns, and more. Install them by symlinking into your skills directory:

ln -s /path/to/mcp-server/skills/<skill-name> ~/.claude/skills/<skill-name>

Once installed, Claude Code can reference these skills when helping you interact with the protocol.