
MCP server for Arcadia Finance. Manage concentrated liquidity positions with built-in leverage
MCP server for Arcadia Finance. Manage concentrated liquidity positions with built-in leverage, automated rebalancing, and yield optimization on Base, Optimism, and Unichain.
·
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.
The hosted server needs no install and no API key:
https://mcp.arcadia.finance/mcpThe 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"
}
}
}Install the plugin, which adds the server and the clamm-liquidity skill:
/plugin install arcadia --marketplace arcadia-finance/mcp-serverOn 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/mcpAdd https://mcp.arcadia.finance/mcp as a custom MCP app. Availability depends on your plan and workspace settings, see OpenAI's guide.
codex mcp add arcadia-finance --url https://mcp.arcadia.finance/mcpgemini mcp add --transport http arcadia-finance https://mcp.arcadia.finance/mcpTo 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.
Write tools return unsigned transactions. Your wallet signs them, see Transaction Signing.
| 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_account_aero_upgrade | What a wallet's accounts (or one account) have to upgrade to Aero: status and counts, no calldata. |
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. |
| 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_wallet_upgrade_velo | Upgrade wallet VELO on Optimism to the new AERO on Base (approve, then the payable deposit). |
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_aero_upgrade | Upgrade an account to Aero: its Slipstream positions move to Aero CL and its old AERO becomes the new AERO, in one flashAction. |
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. |
All write tools return unsigned transactions as { to, data, value, chainId }. This server does not sign or broadcast them; your agent or application does.
Wallet MCP servers (recommended for production):
| 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);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.
| 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). |
RPC_URL_ROBINHOOD | No | Public RPC | Both | RPC URL for Robinhood (4663). |
TRANSPORT | No | stdio | n/a | 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 | 600 | HTTP | Max requests per minute per client IP. |
POSTHOG_KEY | No | none | HTTP | PostHog project key. Unset = no analytics are sent. |
POSTHOG_HOST | No | https://eu.i.posthog.com | HTTP | PostHog ingestion host. |
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| Skill | Description |
|---|---|
clamm-liquidity | Concentrated 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.
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:
Pull requests for documentation fixes are welcome. Every PR needs a human review before merging.
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 PrettierTo point a client at your build, use "command": "node" with "args": ["/absolute/path/to/mcp-server/dist/index.js"].
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: [email protected].
Copyright (C) 2026 Pragma Labs. Licensed under the GNU Affero General Public License v3.0.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add arcadia-finance --transport http https://mcp.arcadia.finance/mcp{
"mcpServers": {
"arcadia-finance": {
"url": "https://mcp.arcadia.finance/mcp"
}
}
}code --add-mcp '{"name":"arcadia-finance","url":"https://mcp.arcadia.finance/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/arcadia-finance-mcp-server to learn what the "Arcadia Finance MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http arcadia-finance https://mcp.arcadia.finance/mcp| Name | What it does |
|---|---|
read_account_info | Get full overview of an Arcadia account: health factor, collateral value, debt, deposited assets, liquidation price, and automation status. Health factor = 1 - (used_margin / liquidation_value): 1 = n |
read_account_history | Get an Arcadia account's historical net value over time. Returns a time series of snapshots, oldest first, each `{ timestamp, net_value }` — `timestamp` is unix seconds and `net_value` is USD (human-r |
read_account_pnl | Get PnL (cost basis) and yield earned for an Arcadia account. Returns lifetime totals: cost basis vs current value (negative cost_basis = net profit withdrawn), net transfers per token, total yield ea |
read_pool_list | List all Arcadia lending pools: TVL, utilization, available liquidity. Key fields: interest_rate = current borrow cost, lending_apy = lender yield. All rates are decimal fractions (1.0 = 100%, 0.06 = |
read_pool_info | Get detailed info for a single lending pool including APY history over time. Useful for analyzing rate trends and comparing pools. Use read_pool_list to discover pool addresses. |
read_asset_list | List supported collateral assets on Arcadia. Returns compact list (address, symbol, decimals, type). Use search to filter by symbol substring. For USD prices, use read_asset_prices. |
read_asset_prices | Get USD prices for one or more asset addresses on one chain. Pass a single address or comma-separated addresses. Returns a price map keyed by address. Unknown or unpriced addresses return 0, not an er |
read_strategy_list | Get Arcadia LP strategies. Use featured_only=true for curated top strategies (recommended first call); their apy is measured over the last 24 hours at the featured range width, and is 0.0 when that me |
read_strategy_info | Get full detail for a specific concentrated-liquidity LP strategy by ID: includes APY per range width over the last 24 hours, each range anchored on the current price (narrower range = higher APY but |
read_strategy_recommendation | Get a rebalancing recommendation for an Arcadia account: suggests asset changes to optimize yield. current_apy and proposed_apy are measured over the last 24 hours where possible (the account's positi |
read_point_leaderboard | Get the Arcadia points leaderboard (paginated). For a specific wallet's points balance, use read_wallet_points. |
read_guides | Get Arcadia workflow guides and reference documentation. Call this before multi-step workflows (opening LP positions, enabling automation, closing positions) or when you need contract addresses, asset |
read_wallet_balances | Get native ETH and ERC20 token balances for a wallet address. Reads directly from chain via RPC multicall. Use before write_account_add_liquidity or write_account_deposit to verify the wallet has suff |
read_wallet_allowances | Check ERC20 token allowances for a spender address. Use before write_wallet_approve to avoid redundant approvals: skip approving if the current allowance is already sufficient. |
read_wallet_accounts | List all Arcadia accounts owned by a wallet address. Returns a summary of each account (address, name). Call read_account_info with a specific account_address for full details like health factor, coll |
read_wallet_points | Get the Arcadia points balance for one wallet address. Returns points and wallet_address. A wallet with no points returns points 0 and wallet_address 'unknown', not an error. Read-only, no authenticat |
read_asset_manager_intents | List the automation intents Arcadia supports, with the parameters each one accepts. Pass account_address to also get per-account availability: which intents can be enabled right now and, for any that |
read_asset_manager_current | Read which asset managers are currently enabled on an account, with their decoded on-chain configuration. Returns the active managers (address, protocol, initiator, decoded strategy metadata, slippage |
read_account_aero_upgrade | Which Arcadia accounts have something to upgrade to Aero (MetadexCL V1): Slipstream V1 to V3 positions (Aerodrome on Base, Velodrome on Optimism, staked or not) and old AERO. Pass wallet_address for e |
write_account_create | Build an unsigned transaction to create a new Arcadia account via the Factory contract. account_version: 3 with creditor → V3 margin account (can borrow/leverage). account_version: 0 or 4 → V4 spot ac |
write_account_deposit | Build an unsigned transaction to deposit assets into an Arcadia account as collateral. Supports ERC20 tokens and ERC721 NFTs (LP positions). NOT needed before write_account_add_liquidity: that tool de |
write_account_withdraw | Build an unsigned transaction to withdraw assets from an Arcadia account to the owner's wallet. Only the account owner can withdraw. Will revert if the account has debt and withdrawal would make it un |
write_account_borrow | Build an unsigned transaction to borrow from an Arcadia lending pool against account collateral. NOT needed for leveraged LP: write_account_add_liquidity handles borrowing internally when leverage > 0 |
write_account_repay | Repay debt to an Arcadia lending pool using tokens from the wallet (requires ERC20 allowance). To repay using account collateral instead (no wallet tokens needed), use write_account_deleverage. Check |
write_account_add_liquidity | Multi-step flash-action: atomically combines [deposit from wallet] + [use account collateral] + [swap to optimal ratio] + [mint LP] + [borrow if leveraged] in ONE transaction. Do NOT call write_accoun |
write_account_remove_liquidity | Flash-action: PARTIALLY decreases liquidity from an LP position. The position remains open with reduced liquidity; underlying tokens stay in the account. For FULL position exit (burn LP + swap + repa |
write_account_swap | Flash-action: swaps assets within an Arcadia account in one atomic transaction. The backend finds the optimal swap route. NOTE: If you are closing a position (swap + repay + withdraw), prefer write_ac |
write_account_deleverage | Multi-step flash-action: sells account collateral to the debt token and repays in one atomic transaction: no wallet tokens needed. To repay from wallet tokens instead, use write_account_repay. NOTE: I |
write_account_stake | Flash-action: stake, unstake, or claim rewards for an LP position in one atomic transaction. Use the `action` parameter to select the operation. `asset_address` is the position manager contract: pass |
write_account_close | Atomic flash-action that closes an Arcadia account position in ONE transaction. Combines up to 3 steps atomically: [burn LP position] + [swap all tokens to a single target asset] + [repay debt]. Token |
write_account_aero_upgrade | Upgrade one Arcadia account to Aero (MetadexCL V1) in one flashAction: every Slipstream V1/V2/V3 position (dex_protocol slipstream*, staked or not, see read_account_info) moves to the Aero CL pool wit |
write_wallet_approve | Build an unsigned approval transaction. For ERC20 tokens: generates approve(spender, amount). For ERC721/ERC1155 NFTs (e.g. LP positions): generates setApprovalForAll(operator, true). Required before |
write_wallet_upgrade_velo | Upgrade VELO held in a wallet on Optimism to the new AERO on Base: ordered unsigned wallet transactions from owner_address, an approve when the allowance is short, then depositLiquid on the Velodrome |
write_pool_deposit | Build an unsigned deposit transaction into an Arcadia lending tranche (ERC-4626). Lenders deposit the pool's underlying asset (USDC/WETH/cbBTC) and receive tranche shares that accrue interest from bor |
write_pool_redeem | Build an unsigned redeem transaction to withdraw from an Arcadia lending tranche (ERC-4626). Burns tranche shares and returns the corresponding amount of underlying asset, including accrued interest. |
write_account_automations | Configure an account's automations from a list of intents and return the unsigned setAssetManagers transaction. The backend resolves which asset managers each intent needs, validates that the combinat |
write_account_automations_delta | Apply an explicit change to an account's automations and return the unsigned setAssetManagers transaction. Unlike write_account_automations this is a delta, not a full desired state: automations you d |
| Name | What it does |
|---|---|
analyze-account | Analyze an Arcadia account: health factor, positions, PnL, automation status, and recommendations. |
find-yield-strategy | Evaluate LP strategies on Arcadia: compare fee APY vs borrow cost, select pool, range width, and leverage. |
setup-automation | Configure automations (compounding, claiming, rebalancing, Merkl) for an Arcadia account. |
migrate-to-aero | Upgrade an Arcadia account to Aero CL (MetadexCL V1): move its Slipstream positions (Aerodrome / Velodrome CL, V1 to V3) and old AERO in one transaction, then reconnect automations. |
| Name | What it does |
|---|---|
guide-overview | Tool catalog, token/contract/lending pool addresses, asset manager addresses, account versions |
guide-automation | Intent-based automation setup: compound fees, claim rewards, add to LP, rebalance, claim Merkl |
guide-strategies | Step-by-step strategy templates: delta neutral leveraged LP, protocol owned liquidity, closing sequences, moving Slipstream positions to Aero |
guide-selection | Strategy evaluation framework: pool selection, range width, leverage sizing, automation combos, exit signals |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/arcadia-finance-mcp-server)Nothing comparable is listed yet.
v0.7.3Release notesv0.7.2Release notesv0.7.1Release notesv0.7.0Release notesv0.6.1Release notesv0.6.0Release notesv0.5.1Release notesv0.5.0Release notesv0.4.6Release notesv0.4.5Release notesv0.4.4Release notesv0.4.3Release notesv0.4.2Release notesv0.4.1Release notesv0.4.0Release notesv0.3.5Release notesv0.3.4Release notesv0.3.3Release notesv0.3.2Release notesv0.3.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "arcadia-finance-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.