# Arcadia Finance

Connects AI coding tools to Arcadia Finance to inspect concentrated liquidity positions and construct unsigned transactions on Uniswap and Aero.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: arcadia-finance
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/arcadia-finance/mcp-server
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/arcadia-finance

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.arcadia.finance/mcp`
- Environment variables: `RPC_URL_BASE`, `RPC_URL_UNICHAIN`, `RPC_URL_OPTIMISM`, `RPC_URL_ROBINHOOD`, `PK`, `TRANSPORT`, `PORT`, `ALLOWED_ORIGINS`, `RATE_LIMIT_RPM` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.arcadia.finance/mcp
```

2. **Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add arcadia-finance --url https://mcp.arcadia.finance/mcp
```

2. **Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "arcadia-finance": {
            "url": "https://mcp.arcadia.finance/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "arcadia-finance": {
            "type": "http",
            "url": "https://mcp.arcadia.finance/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http arcadia-finance https://mcp.arcadia.finance/mcp
```

2. **Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 4 more environment variables are in the server README

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md