Arcadia Finance — Claude Code MCP server: what it does, how to install
Connects AI coding tools to Arcadia Finance to inspect concentrated liquidity positions and construct unsigned transactions on Uniswap and Aero.
claude mcp add --transport http mcp-server https://mcp.arcadia.finance/mcpWhat Arcadia Finance does
The server exposes a toolset for reading data and managing liquidity within Arcadia Finance. Assistants can inspect account health factors, check ERC20 balances, analyze pool yields, and query rebalancing strategies on Uniswap or Aero.
When modifying onchain state, the server returns unsigned transactions formatted with to, data, value, and chainId. It handles operations such as account deployment via Factory, pool deposits into ERC-4626 vaults, withdrawals, and borrowing. The assistant never signs transactions independently.
Running the server locally through stdio demands a private key along with RPC endpoints for Base, Optimism, Unichain, and Robinhood. Without these environment variables the local process halts immediately, making the public HTTP endpoint at https://mcp.arcadia.finance/mcp a simpler option for read-only queries.
What it helps with
- Inspect account health factor and collateral value in Arcadia Finance
- Query lending pool metrics including TVL and historical yields
- Build unsigned transactions for ERC-4626 pool deposits and token approvals
- Fetch rebalancing recommendations for active liquidity positions
Example prompts for the agent
- Check the health factor and outstanding debt for my Arcadia account at 0x123...
- List lending pools with their current utilization rates and APY.
- Generate an unsigned transaction to deposit tokens into an ERC-4626 vault.
How to install Arcadia Finance
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.arcadia.finance/mcp2Platform CLI
claude mcp add --env RPC_URL_BASE=<RPC_URL_BASE> --env RPC_URL_UNICHAIN=<RPC_URL_UNICHAIN> --env RPC_URL_OPTIMISM=<RPC_URL_OPTIMISM> --env RPC_URL_ROBINHOOD=<RPC_URL_ROBINHOOD> --env PK=<PK> --transport stdio arcadia-finance -- npx -y @arcadia-finance/mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
1Platform CLI: remote server
codex mcp add arcadia-finance --url https://mcp.arcadia.finance/mcp2Platform CLI
codex mcp add arcadia-finance --env RPC_URL_BASE=<RPC_URL_BASE> --env RPC_URL_UNICHAIN=<RPC_URL_UNICHAIN> --env RPC_URL_OPTIMISM=<RPC_URL_OPTIMISM> --env RPC_URL_ROBINHOOD=<RPC_URL_ROBINHOOD> --env PK=<PK> -- npx -y @arcadia-finance/mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"mcpServers": {
"arcadia-finance": {
"url": "https://mcp.arcadia.finance/mcp"
}
}
}{
"mcpServers": {
"arcadia-finance": {
"command": "npx",
"args": [
"-y",
"@arcadia-finance/mcp-server"
],
"env": {
"RPC_URL_BASE": "<RPC_URL_BASE>",
"RPC_URL_UNICHAIN": "<RPC_URL_UNICHAIN>",
"RPC_URL_OPTIMISM": "<RPC_URL_OPTIMISM>",
"RPC_URL_ROBINHOOD": "<RPC_URL_ROBINHOOD>",
"PK": "<PK>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"servers": {
"arcadia-finance": {
"type": "http",
"url": "https://mcp.arcadia.finance/mcp"
}
}
}{
"servers": {
"arcadia-finance": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@arcadia-finance/mcp-server"
],
"env": {
"RPC_URL_BASE": "<RPC_URL_BASE>",
"RPC_URL_UNICHAIN": "<RPC_URL_UNICHAIN>",
"RPC_URL_OPTIMISM": "<RPC_URL_OPTIMISM>",
"RPC_URL_ROBINHOOD": "<RPC_URL_ROBINHOOD>",
"PK": "<PK>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
1Platform CLI: remote server
gemini mcp add -t http arcadia-finance https://mcp.arcadia.finance/mcp2Platform CLI
gemini mcp add -e RPC_URL_BASE=<RPC_URL_BASE> -e RPC_URL_UNICHAIN=<RPC_URL_UNICHAIN> -e RPC_URL_OPTIMISM=<RPC_URL_OPTIMISM> -e RPC_URL_ROBINHOOD=<RPC_URL_ROBINHOOD> -e PK=<PK> arcadia-finance npx -y @arcadia-finance/mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Arcadia Finance
How to install Arcadia Finance in Claude Code?
Add the remote HTTP endpoint to Claude Code with a single command: claude mcp add --transport http arcadia-finance https://mcp.arcadia.finance/mcp.
What does Arcadia Finance MCP server do?
It connects AI agents to the Arcadia Finance protocol, enabling read access to pool metrics and generating raw unsigned transactions for liquidity management.
Does the server automatically execute and sign transactions?
No, write tools output only raw unsigned transaction objects with to, data, value, and chainId. Transaction signing and broadcasting remain the user's responsibility.
