Arcadia Finance

管理Uniswap和Aerodrome的流動性部位,具備自動再平衡與槓桿功能。

文件

Arcadia Finance MCP Server

npm npm downloads License: AGPL-3.0 TypeScript MCP MCP Badge arcadia-finance-mcp-server MCP server mcptry Arcadia Finance MCP on mcprush

MCP server for Arcadia Finance, a platform for concentrated liquidity on Uniswap and Aero 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 and deposits. Live on Base, Optimism, Unichain and Robinhood.

Quick start

The hosted server needs no install and no API key:

https://mcp.arcadia.finance/mcp

Add to Claude Install in VS Code Install in Cursor

The Claude button opens Customize > Connectors > Add custom connector with the name and URL filled in. Claude Free allows one custom connector. On Team and Enterprise, an owner adds it under Organization settings > Connectors.

Most clients accept this config. Cursor reads it from .cursor/mcp.json or ~/.cursor/mcp.json. VS Code uses .vscode/mcp.json with "servers" in place of "mcpServers" and "type": "http" on the server.

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

Install the plugin, which adds the server and the clamm-liquidity skill:

/plugin install arcadia --marketplace arcadia-finance/mcp-server

On Claude Code older than 2.1.275, run /plugin marketplace add arcadia-finance/mcp-server, then /plugin install arcadia@arcadia-finance. To add only the server:

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

Add https://mcp.arcadia.finance/mcp as a custom MCP app. Availability depends on your plan and workspace settings, see OpenAI's guide.

Codex CLI
codex mcp add arcadia-finance --url https://mcp.arcadia.finance/mcp
Gemini CLI
gemini mcp add --transport http arcadia-finance https://mcp.arcadia.finance/mcp

Run it locally

To run the server as a local process instead (Node.js 22 or newer):

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "npx",
      "args": ["-y", "@arcadia-finance/mcp-server"]
    }
  }
}

In Claude Code: claude mcp add arcadia-finance -- npx -y @arcadia-finance/mcp-server. Optional environment variables are listed under Configuration.

Try it

  • "Which Arcadia strategies on Base have the highest APY right now?"
  • "Show the health factor and positions of Arcadia account 0x..."
  • "Open the top WETH/USDC strategy with 1,000 USDC and turn on compounding."
  • "What do the Arcadia lending pools pay lenders?"

Write tools return unsigned transactions. Your wallet signs them, see Transaction Signing.

Tools

Read Tools

ToolDescription
read_account_infoAccount overview: health factor, collateral, debt, positions, liquidation price, automation status.
read_account_historyHistorical account value over time.
read_account_pnlPnL and yield data for an account.
read_wallet_accountsList all Arcadia accounts owned by a wallet address.
read_account_aero_upgradeWhat a wallet's accounts (or one account) have to upgrade to Aero: status and counts, no calldata.
read_wallet_balancesOn-chain ERC20 balances and native ETH for a wallet address.
read_wallet_allowancesCheck ERC20 token allowances for a spender. Use before write_wallet_approve to avoid redundant approvals.
read_wallet_pointsPoints balance for a specific wallet address.
read_asset_listSupported collateral assets with addresses, types, decimals.
read_asset_pricesUSD prices for one or more asset addresses.
read_pool_listAll lending pools: TVL, APY, utilization, liquidity.
read_pool_infoSingle pool detail with APY history over time.
read_point_leaderboardPaginated Arcadia points leaderboard.
read_strategy_listLP strategies with APY, underlyings, pool info. Supports featured filter and pagination.
read_strategy_infoFull detail for a specific LP strategy: APY per range width, pool config.
read_strategy_recommendationRebalancing recommendation for an account.
read_guidesReference guides: automation setup, strategy selection, strategy templates.
read_asset_manager_intentsAutomation intents and their params; add account_address for live per-account availability.
read_asset_manager_currentAutomations enabled on an account: decoded config, mapped intents, Merkl state, superseded managers.

Write Tools

ToolDescription
write_wallet_approveApprove an ERC20 token for spending. Required before depositing into an account. Call read_wallet_allowances first to check if already approved.
write_wallet_upgrade_veloUpgrade wallet VELO on Optimism to the new AERO on Base (approve, then the payable deposit).
write_pool_depositLend the pool's underlying asset into an ERC-4626 tranche to earn interest. Mints tranche shares to the receiver.
write_pool_redeemRedeem tranche shares back into the underlying asset (lender exit).
write_account_createCreate a new Arcadia account via Factory.
write_account_depositDeposit ERC20 tokens into an account.
write_account_withdrawWithdraw assets from an account.
write_account_borrowBorrow from a lending pool.
write_account_repayRepay debt to a lending pool from wallet.
write_account_add_liquidityFlash-action: deposit + swap + mint LP + optional leverage, atomically.
write_account_remove_liquidityRemove/decrease LP position liquidity.
write_account_swapSwap assets within an account (backend-routed).
write_account_deleverageRepay debt by selling collateral (swap + repay in one tx).
write_account_closeAtomic close: burn LP + swap + repay debt in one tx.
write_account_stakeStake, unstake, or claim rewards for LP positions.
write_account_aero_upgradeUpgrade an account to Aero: its Slipstream positions move to Aero CL and its old AERO becomes the new AERO, in one flashAction.
write_account_automationsConfigure automations from an intents array (full desired state). Returns the unsigned setAssetManagers tx.
write_account_automations_deltaEnable/disable individual automations, leaving the rest untouched.

Transaction Signing

All write tools return unsigned transactions as { to, data, value, chainId }. This server does not sign or broadcast them; your agent or application does.

Options

Wallet MCP servers (recommended for production):

Wallet MCPProviderModel
MCP Wallet SignerCommunityNon-custodial, routes to browser wallet (MetaMask, Rabby)
Coinbase AgentKitCoinbaseWallet-agnostic, supports multiple providers
Phantom MCPPhantomEmbedded wallet
Privy MCPPrivyWallet infrastructure
Safe MCPCommunityMulti-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);

Configuration

All environment variables are optional. Set them in a .env file in the server directory (gitignored, never commit it) or in your MCP client env block, which takes precedence.

VariableRequiredDefaultTransportDescription
RPC_URL_BASENoPublic RPCBothRPC URL for Base (8453).
RPC_URL_UNICHAINNoPublic RPCBothRPC URL for Unichain (130).
RPC_URL_OPTIMISMNoPublic RPCBothRPC URL for Optimism (10).
RPC_URL_ROBINHOODNoPublic RPCBothRPC URL for Robinhood (4663).
TRANSPORTNostdion/aTransport mode: stdio or http.
PORTNo3000HTTPListen port for HTTP transport.
ALLOWED_ORIGINSNohttps://mcp.arcadia.financeHTTPComma-separated allowed Origin headers (CORS / DNS rebinding).
RATE_LIMIT_RPMNo600HTTPMax requests per minute per client IP.
POSTHOG_KEYNononeHTTPPostHog project key. Unset = no analytics are sent.
POSTHOG_HOSTNohttps://eu.i.posthog.comHTTPPostHog ingestion host.

Skills

The skills/ directory contains skills that teach AI agents how to use this MCP server. The Claude Code plugin (see Quick start) installs them together with the server. To install a skill on its own, symlink it into your skills directory:

ln -s /path/to/mcp-server/skills/clamm-liquidity ~/.claude/skills/clamm-liquidity
SkillDescription
clamm-liquidityConcentrated liquidity management: concepts, intent-based automation, and step-by-step workflows.

The OpenClaw skill in openclaw/ calls the hosted server through a curl script, for agents without MCP support.

Reporting Issues

Open an issue for bugs, missing features or unclear documentation: 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. Every PR needs a human review before merging.

Where to Find Us

Development

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

To point a client at your build, use "command": "node" with "args": ["/absolute/path/to/mcp-server/dist/index.js"].

Privacy

When POSTHOG_KEY is set on an HTTP deployment, the server records one analytics event per tool call in PostHog (EU ingestion host by default): the tool name, its arguments (which can include public wallet and account addresses), whether the call failed, the duration, and the client name and version. Events carry no person profile. Running the server locally over stdio sends no analytics, and neither does an HTTP deployment without POSTHOG_KEY. The server never handles private keys. Questions: legal@arcadia.finance.

License

Copyright (C) 2026 Pragma Labs. Licensed under the GNU Affero General Public License v3.0.