{
  "markdown": "# Arcadia Finance MCP Server\n\n[![npm](https://img.shields.io/npm/v/@arcadia-finance/mcp-server)](https://www.npmjs.com/package/@arcadia-finance/mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/@arcadia-finance/mcp-server)](https://www.npmjs.com/package/@arcadia-finance/mcp-server)\n[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue)](LICENSE.md)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue)](https://www.typescriptlang.org/)\n[![MCP](https://img.shields.io/badge/MCP-2025--11--25-green)](https://modelcontextprotocol.io/)\n[![Smithery](https://img.shields.io/badge/Smithery-listed-6b46c1)](https://smithery.ai/servers/arcadia-finance/mcp-server)\n[![MCP Badge](https://lobehub.com/badge/mcp/arcadia-finance-mcp-server)](https://lobehub.com/mcp/arcadia-finance-mcp-server)\n[![arcadia-finance-mcp-server MCP server](https://glama.ai/mcp/servers/arcadia-finance/mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/arcadia-finance/mcp-server)\n\nMCP server for [Arcadia Finance](https://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.\n\nDesigned for AI agents (Claude, Cursor, etc.) to interact with Arcadia onchain.\n\n## Install\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0078d4?logo=visualstudiocode)](https://vscode.dev/redirect/mcp/install?name=arcadia-finance&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40arcadia-finance%2Fmcp-server%22%5D%7D)\n[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-black?logo=cursor)](https://cursor.com/en/install-mcp?name=arcadia-finance&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhcmNhZGlhLWZpbmFuY2UvbWNwLXNlcnZlciJdfQ==)\n\n## Tools\n\n### Read Tools\n\n| Tool                           | Description                                                                                                 |\n| ------------------------------ | ----------------------------------------------------------------------------------------------------------- |\n| `read.account.info`            | Account overview: health factor, collateral, debt, positions, liquidation price, automation status.         |\n| `read.account.history`         | Historical account value over time.                                                                         |\n| `read.account.pnl`             | PnL and yield data for an account.                                                                          |\n| `read.wallet.accounts`         | List all Arcadia accounts owned by a wallet address.                                                        |\n| `read.wallet.balances`         | On-chain ERC20 balances and native ETH for a wallet address.                                                |\n| `read.wallet.allowances`       | Check ERC20 token allowances for a spender. Use before `write.wallet.approve` to avoid redundant approvals. |\n| `read.wallet.points`           | Points balance for a specific wallet address.                                                               |\n| `read.asset.list`              | Supported collateral assets with addresses, types, decimals.                                                |\n| `read.asset.prices`            | USD prices for one or more asset addresses.                                                                 |\n| `read.pool.list`               | All lending pools: TVL, APY, utilization, liquidity.                                                        |\n| `read.pool.info`               | Single pool detail with APY history over time.                                                              |\n| `read.point_leaderboard`       | Paginated Arcadia points leaderboard.                                                                       |\n| `read.strategy.list`           | LP strategies with APY, underlyings, pool info. Supports featured filter and pagination.                    |\n| `read.strategy.info`           | Full detail for a specific LP strategy: APY per range width, pool config.                                   |\n| `read.strategy.recommendation` | Rebalancing recommendation for an account.                                                                  |\n| `read.guides`                  | Reference guides: automation setup, strategy selection, strategy templates.                                 |\n| `read.asset_manager.intents`   | Automation intents and their params; add `account_address` for live per-account availability.               |\n| `read.asset_manager.current`   | Automations enabled on an account: decoded config, mapped intents, Merkl state, superseded managers.        |\n\n### Write Tools\n\nAll write tools return unsigned transactions as `{ to, data, value, chainId }`.\n\n| Tool                              | Description                                                                                                                                        |\n| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `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. |\n| `write.pool.deposit`              | Lend the pool's underlying asset into an ERC-4626 tranche to earn interest. Mints tranche shares to the receiver.                                  |\n| `write.pool.redeem`               | Redeem tranche shares back into the underlying asset (lender exit).                                                                                |\n| `write.account.create`            | Create a new Arcadia account via Factory.                                                                                                          |\n| `write.account.deposit`           | Deposit ERC20 tokens into an account.                                                                                                              |\n| `write.account.withdraw`          | Withdraw assets from an account.                                                                                                                   |\n| `write.account.borrow`            | Borrow from a lending pool.                                                                                                                        |\n| `write.account.repay`             | Repay debt to a lending pool from wallet.                                                                                                          |\n| `write.account.add_liquidity`     | Flash-action: deposit + swap + mint LP + optional leverage, atomically.                                                                            |\n| `write.account.remove_liquidity`  | Remove/decrease LP position liquidity.                                                                                                             |\n| `write.account.swap`              | Swap assets within an account (backend-routed).                                                                                                    |\n| `write.account.deleverage`        | Repay debt by selling collateral (swap + repay in one tx).                                                                                         |\n| `write.account.close`             | Atomic close: burn LP + swap + repay debt in one tx.                                                                                               |\n| `write.account.stake`             | Stake, unstake, or claim rewards for LP positions.                                                                                                 |\n| `write.account.automations`       | Configure automations from an intents array (full desired state). Returns the unsigned setAssetManagers tx.                                        |\n| `write.account.automations_delta` | Enable/disable individual automations, leaving the rest untouched.                                                                                 |\n\n### Dev Tools\n\nAlways registered but requires `PK` env var to function.\n\n| Tool       | Description                                                                                                                                          |\n| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `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. |\n\n## Transaction Signing\n\nAll 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.\n\n### Options\n\n**Wallet MCP servers (recommended for production):**\nPair this server with a wallet MCP server that handles signing:\n\n| Wallet MCP                                                        | Provider  | Model                                                     |\n| ----------------------------------------------------------------- | --------- | --------------------------------------------------------- |\n| [MCP Wallet Signer](https://github.com/nikicat/mcp-wallet-signer) | Community | Non-custodial, routes to browser wallet (MetaMask, Rabby) |\n| [Coinbase AgentKit](https://github.com/coinbase/agentkit)         | Coinbase  | Wallet-agnostic, supports multiple providers              |\n| [Phantom MCP](https://www.npmjs.com/package/@phantom/mcp-server)  | Phantom   | Embedded wallet                                           |\n| [Privy MCP](https://github.com/incentivai-io/privy-mcp-server)    | Privy     | Wallet infrastructure                                     |\n| [Safe MCP](https://github.com/safer-sh/safer)                     | Community | Multi-sig via Safe                                        |\n\nOr use your existing wallet setup (Fireblocks, Dfns, Turnkey, Biconomy, Dynamic) and pass the unsigned tx object to your provider's signing method.\n\n**viem/ethers in your agent:**\n\n```typescript\nimport { createWalletClient, http } from \"viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport { base } from \"viem/chains\";\n\nconst account = privateKeyToAccount(\"0x...\");\nconst client = createWalletClient({ account, chain: base, transport: http() });\n\n// tx = result from any write.* tool\nconst hash = await client.sendTransaction(tx);\n```\n\n**Built-in `dev.send` tool (development only):**\nThe 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:\n\n```bash\n# .env in the server directory (never commit — already gitignored)\nPK=0xYourPrivateKeyHex\nRPC_URL_BASE=https://base-mainnet.g.alchemy.com/v2/your-key\n```\n\nThe 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.\n\nNot for production — use a dedicated wallet MCP server (Fireblocks, Turnkey, Safe) instead.\n\n## Setup\n\n**Prerequisites:** Node.js >= 22\n\n```bash\nyarn install\nyarn build\n```\n\n**Environment variables:**\n\n| Variable            | Required | Default                       | Transport | Description                                                    |\n| ------------------- | -------- | ----------------------------- | --------- | -------------------------------------------------------------- |\n| `RPC_URL_BASE`      | No       | Public RPC                    | Both      | RPC URL for Base (8453).                                       |\n| `RPC_URL_UNICHAIN`  | No       | Public RPC                    | Both      | RPC URL for Unichain (130).                                    |\n| `RPC_URL_OPTIMISM`  | No       | Public RPC                    | Both      | RPC URL for Optimism (10).                                     |\n| `RPC_URL_ROBINHOOD` | No       | Public RPC                    | Both      | RPC URL for Robinhood (4663).                                  |\n| `PK`                | No       | —                             | Both      | Private key (hex) for dev-only `dev.send` tool.                |\n| `TRANSPORT`         | No       | `stdio`                       | —         | Transport mode: `stdio` or `http`.                             |\n| `PORT`              | No       | `3000`                        | HTTP      | Listen port for HTTP transport.                                |\n| `ALLOWED_ORIGINS`   | No       | `https://mcp.arcadia.finance` | HTTP      | Comma-separated allowed Origin headers (CORS / DNS rebinding). |\n| `RATE_LIMIT_RPM`    | No       | `60`                          | HTTP      | Max requests per minute per session.                           |\n\n**Supported chains:** Base (8453), Unichain (130), Optimism (10), Robinhood (4663)\n\n## MCP Client Configuration\n\n**Remote (no install needed):**\n\n```json\n{\n  \"mcpServers\": {\n    \"arcadia-finance\": {\n      \"url\": \"https://mcp.arcadia.finance/mcp\"\n    }\n  }\n}\n```\n\n**Via npx** (local stdio):\n\n```json\n{\n  \"mcpServers\": {\n    \"arcadia-finance\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@arcadia-finance/mcp-server\"],\n      \"env\": {\n        \"RPC_URL_BASE\": \"https://base-mainnet.g.alchemy.com/v2/your-key\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```bash\n# Remote\nclaude mcp add arcadia-finance --transport http https://mcp.arcadia.finance/mcp\n\n# Local\nclaude mcp add arcadia-finance -- npx -y @arcadia-finance/mcp-server\n```\n\n**From source** (local development):\n\n```json\n{\n  \"mcpServers\": {\n    \"arcadia-finance\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-server/dist/index.js\"],\n      \"env\": {\n        \"RPC_URL_BASE\": \"https://base-mainnet.g.alchemy.com/v2/your-key\"\n      }\n    }\n  }\n}\n```\n\n## Skills\n\nThe `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:\n\n```bash\nln -s /path/to/mcp-server/skills/clamm-liquidity ~/.claude/skills/clamm-liquidity\n```\n\nAvailable skills:\n\n| Skill             | Description                                                                                       |\n| ----------------- | ------------------------------------------------------------------------------------------------- |\n| `clamm-liquidity` | Concentrated liquidity management: concepts, intent-based automation, and step-by-step workflows. |\n\n## Reporting Issues\n\nFound a bug, missing feature, or unclear documentation while using this server?\nOpen an issue: https://github.com/arcadia-finance/mcp-server/issues\n\n**For AI agents:** If you hit a gap during task execution, open an issue with:\n\n- Tool name and parameters you used\n- What you expected vs what happened\n- The strategy or goal you were trying to execute\n\nPull requests for documentation fixes are welcome from agents and humans alike. All PRs require human review before merging.\n\n## Where to Find Us\n\n- **npm:** [@arcadia-finance/mcp-server](https://www.npmjs.com/package/@arcadia-finance/mcp-server)\n- **MCP Registry:** [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/?q=arcadia)\n- **Smithery:** [smithery.ai](https://smithery.ai/servers/arcadia-finance/mcp-server)\n- **MCP Servers:** [mcpservers.org](https://mcpservers.org/en/servers/arcadia-finance/mcp-server)\n- **LobeHub:** [lobehub.com](https://lobehub.com/mcp/arcadia-finance-mcp-server)\n- **PulseMCP:** [pulsemcp.com](https://www.pulsemcp.com/servers/arcadia-finance)\n- **MCP Market:** [mcpmarket.com](https://mcpmarket.com/server/arcadia-finance)\n- **Glama:** [glama.ai](https://glama.ai/mcp/servers/arcadia-finance/mcp-server)\n- **awesome-mcp-servers:** [github.com/TensorBlock/awesome-mcp-servers](https://github.com/TensorBlock/awesome-mcp-servers)\n\n## Development\n\n```bash\nyarn dev          # Run with tsx (hot reload)\nyarn build        # Compile TypeScript\nyarn test         # Run tests\nyarn lint         # Lint with ESLint\nyarn format       # Check formatting with Prettier\n```\n",
  "bytes": 16432,
  "sha": "725f7be7338d76577468a777b3a3c4289d748f4ee557b9c884ed36a966d69376",
  "repo_slug": "arcadia-finance/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_arcadia_finance_mcp_server_2c52a1e3/readme"
}