arcadia-finance/mcp-server

npm npm downloads License: AGPL-3.0 TypeScript MCP Smithery MCP Badge arcadia-finance-mcp-server MCP server

MCP server for Arcadia Finance, a platform for concentrated liquidity on Uniswap and Aerodrome with automated rebalancing, compounding, yield optimization, and leverage, or single-sided liquidity into lending pools. 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	Automation intents and their params; add account_address for live per-account availability.
read.asset_manager.current	Automations enabled on an account: decoded config, mapped intents, Merkl state, superseded managers.

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.pool.deposit	Lend the pool's underlying asset into an ERC-4626 tranche to earn interest. Mints tranche shares to the receiver.
write.pool.redeem	Redeem tranche shares back into the underlying asset (lender exit).
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.account.automations	Configure automations from an intents array (full desired state). Returns the unsigned setAssetManagers tx.
write.account.automations_delta	Enable/disable individual automations, leaving the rest untouched.

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 MCP servers (recommended for production): Pair this server with a wallet MCP server that handles signing:

Wallet MCP	Provider	Model
MCP Wallet Signer	Community	Non-custodial, routes to browser wallet (MetaMask, Rabby)
Coinbase AgentKit	Coinbase	Wallet-agnostic, supports multiple providers
Phantom MCP	Phantom	Embedded wallet
Privy MCP	Privy	Wallet infrastructure
Safe MCP	Community	Multi-sig via Safe

Or use your existing wallet setup (Fireblocks, Dfns, Turnkey, Biconomy, Dynamic) and 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:

# .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).
RPC_URL_OPTIMISM	No	Public RPC	Both	RPC URL for Optimism (10).
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), Optimism (10)

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, intent-based automation, 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
• MCP Registry: registry.modelcontextprotocol.io
• Smithery: smithery.ai
• MCP Servers: mcpservers.org
• LobeHub: lobehub.com
• PulseMCP: pulsemcp.com
• MCP Market: mcpmarket.com
• Glama: glama.ai
• awesome-mcp-servers: github.com/TensorBlock/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