Arcadia Finance

Arcadia Finance MCP サーバー

Arcadia Finance の MCP サーバーです。Uniswap と Aero での集中流動性を提供するプラットフォームで、自動リバランス、複利運用、利回り最適化、レバレッジに対応するほか、レンディングプールへの片側流動性の提供も可能です。プロトコルのデータを読み取り、LP 管理、借入、預け入れなどの未署名トランザクションを構築できます。

AI エージェント（Claude、Cursor など）がオンチェーンで Arcadia を操作できるように設計されています。

インストール

ツール

読み取りツール

ツール	説明
read_account_info	アカウントの概要：ヘルスファクター、担保、負債、ポジション、清算価格、自動化のステータス。
read_account_history	アカウント価値の時系列履歴。
read_account_pnl	アカウントの損益と利回りのデータ。
read_wallet_accounts	ウォレットアドレスが所有するすべての Arcadia アカウントの一覧。
read_account_aero_upgrade	ウォレットのアカウント（または指定した1つのアカウント）が Aero にアップグレードするために必要な内容：ステータスと件数。calldata は含まれません。
read_wallet_balances	ウォレットアドレスのオンチェーン ERC20 残高とネイティブ ETH。
read_wallet_allowances	spender に対する ERC20 トークンの許容量を確認します。重複した承認を避けるため、write_wallet_approve の前に使用してください。
read_wallet_points	指定したウォレットアドレスのポイント残高。
read_asset_list	対応する担保資産と、そのアドレス、種類、小数桁数。
read_asset_prices	1つ以上の資産アドレスの USD 価格。
read_pool_list	すべてのレンディングプール：TVL、APY、利用率、流動性。
read_pool_info	APY の時系列履歴を含む、単一プールの詳細。
read_point_leaderboard	ページ分割された Arcadia ポイントのリーダーボード。
read_strategy_list	APY、原資産、プール情報を含む LP 戦略。注目の戦略によるフィルタリングとページ分割に対応しています。
read_strategy_info	特定の LP 戦略の詳細：レンジ幅ごとの APY、プール設定。
read_strategy_recommendation	アカウントのリバランスに関する推奨。
read_guides	参照ガイド：自動化の設定、戦略の選択、戦略テンプレート。
read_asset_manager_intents	自動化のインテントとそのパラメーター。アカウントごとの現在の利用可否を確認するには、account_address を追加してください。
read_asset_manager_current	アカウントで有効な自動化：デコード済みの設定、対応付けられたインテント、Merkl の状態、置き換えられたマネージャー。

書き込みツール

すべての書き込みツールは、{ to, data, value, chainId } として未署名のトランザクションを返します。

ツール	説明
write_wallet_approve	ERC20 トークンの使用を承認します。アカウントに入金する前に必要です。すでに承認済みか確認するには、まず read_wallet_allowances を呼び出してください。
write_wallet_upgrade_velo	Optimism 上のウォレット VELO を Base 上の新しい AERO にアップグレードします（承認後、支払いを伴う入金を行います）。
write_pool_deposit	プールの原資産を ERC-4626 トランシェに貸し出し、利息を得ます。受取人にトランシェのシェアを発行します。
write_pool_redeem	トランシェのシェアを原資産に償還します（貸し手による引き出し）。
write_account_create	Factory を通じて新しい Arcadia アカウントを作成します。
write_account_deposit	ERC20 トークンをアカウントに入金します。
write_account_withdraw	アカウントから資産を引き出します。
write_account_borrow	レンディングプールから借り入れます。
write_account_repay	ウォレットからレンディングプールへの債務を返済します。
write_account_add_liquidity	フラッシュアクション：入金、スワップ、LP の発行、および任意のレバレッジをアトミックに実行します。
write_account_remove_liquidity	LP ポジションの流動性を除去または減少させます。
write_account_swap	アカウント内で資産をスワップします（バックエンド経由でルーティング）。
write_account_deleverage	担保を売却して債務を返済します（スワップと返済を1つのトランザクションで実行）。
write_account_close	アトミックにクローズします：LP のバーン、スワップ、債務の返済を1つのトランザクションで実行します。
write_account_stake	LP ポジションのステーキング、ステーキング解除、または報酬の請求を行います。
write_account_aero_upgrade	アカウントを Aero にアップグレードします。Slipstream ポジションを Aero CL に移し、古い AERO を新しい AERO に変換します。すべてを1つの flashAction で実行します。
write_account_automations	intents 配列（希望する状態全体）からオートメーションを設定します。未署名の setAssetManagers トランザクションを返します。
write_account_automations_delta	他のオートメーションには触れず、個々のオートメーションを有効または無効にします。

開発ツール

常に登録されていますが、機能させるには PK 環境変数が必要です。

ツール	説明
dev_send	ローカルの秘密鍵（PK 環境変数）を使用して、署名されていないトランザクションに署名し、ブロードキャストします。本番環境では使用せず、代わりに専用のウォレット MCP サーバーを使用してください。

トランザクションへの署名

すべての書き込みツールは、{ to, data, value, chainId } 形式の署名されていないトランザクションを返します。このサーバーは署名もブロードキャストも行いません。署名はエージェントまたはアプリケーションが担当します。

オプション

ウォレット MCP サーバー（本番環境で推奨）： 署名を処理するウォレット MCP サーバーと、このサーバーを組み合わせてください。

ウォレット MCP	プロバイダー	モデル
MCP Wallet Signer	コミュニティ	非カストディアル。ブラウザーウォレット（MetaMask、Rabby）に接続
Coinbase AgentKit	Coinbase	ウォレットに依存せず、複数のプロバイダーに対応
Phantom MCP	Phantom	組み込みウォレット
Privy MCP	Privy	ウォレットインフラストラクチャ
Safe MCP	コミュニティ	Safe 経由のマルチシグ

または、既存のウォレット設定（Fireblocks、Dfns、Turnkey、Biconomy、Dynamic）を使用し、署名されていない tx オブジェクトをプロバイダーの署名メソッドに渡してください。

エージェント内の viem/ethers：

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);

組み込みの dev_send ツール（開発専用）： このサーバーには、PK 環境変数から秘密鍵を読み込む開発専用の署名ツールが含まれています。.env ファイルまたは MCP クライアントの設定で PK を設定してください。

# .env in the server directory (never commit — already gitignored)
PK=0xYourPrivateKeyHex
RPC_URL_BASE=https://base-mainnet.g.alchemy.com/v2/your-key

サーバーは起動時に .env を自動的に読み込みます。あらゆる MCP クライアント（Claude Desktop、Claude Code、VSCode、Cursor）で動作します。両方が設定されている場合は、MCP クライアントの env ブロック設定が優先されます。

本番環境では使用せず、代わりに専用のウォレット MCP サーバー（Fireblocks、Turnkey、Safe）を使用してください。

セットアップ

前提条件： Node.js >= 22

yarn install
yarn build

環境変数：

変数	必須	デフォルト	トランスポート	説明
RPC_URL_BASE	いいえ	Public RPC	Both	Base（8453）の RPC URL。
RPC_URL_UNICHAIN	いいえ	Public RPC	Both	Unichain（130）の RPC URL。
RPC_URL_OPTIMISM	いいえ	Public RPC	Both	Optimism（10）の RPC URL。
RPC_URL_ROBINHOOD	いいえ	Public RPC	Both	Robinhood（4663）の RPC URL。
PK	いいえ	none	Both	開発専用の dev_send ツールで使用する秘密鍵（16 進数）。
TRANSPORT	いいえ	stdio	—	トランスポートモード：stdio または http。
PORT	いいえ	3000	HTTP	HTTP トランスポートの待ち受けポート。
ALLOWED_ORIGINS	いいえ	https://mcp.arcadia.finance	HTTP	許可する Origin ヘッダー（CORS／DNS リバインディング、カンマ区切り）。
RATE_LIMIT_RPM	いいえ	600	HTTP	クライアント IP ごとの 1 分あたりの最大リクエスト数。
POSTHOG_KEY	いいえ	none	HTTP	PostHog プロジェクトキー。未設定の場合、分析データは送信されません。
POSTHOG_HOST	いいえ	https://eu.i.posthog.com	HTTP	PostHog のデータ取り込みホスト。

対応チェーン： Base（8453）、Unichain（130）、Optimism（10）、Robinhood（4663）

MCP クライアントの設定

リモート（インストール不要）：

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

npx 経由（ローカル stdio）：

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "npx",
      "args": ["-y", "@arcadia-finance/mcp-server"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

Claude Code：

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

# Local
claude mcp add arcadia-finance -- npx -y @arcadia-finance/mcp-server

ソースから（ローカル開発）：

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

スキル

skills/ ディレクトリには、AI エージェントがこの MCP サーバーを効果的に使う方法を学ぶための Claude Code スキルが含まれています。スキルをインストールするには、Claude のスキルディレクトリにシンボリックリンクを作成してください。

ln -s /path/to/mcp-server/skills/clamm-liquidity ~/.claude/skills/clamm-liquidity

利用可能なスキル：

スキル	説明
clamm-liquidity	集中流動性の管理：概念、意図ベースの自動化、段階的なワークフロー。

問題の報告

このサーバーの使用中にバグ、足りない機能、または分かりにくいドキュメントを見つけましたか？ 問題を報告してください：https://github.com/arcadia-finance/mcp-server/issues

AI エージェント向け： タスクの実行中に不足があった場合は、以下の内容を添えて問題を報告してください。

• 使用したツール名とパラメーター
• 期待した動作と実際に起きたこと
• 実行しようとしていた戦略または目標

ドキュメント修正のプルリクエストは、エージェントと人間のどちらからも歓迎します。すべての PR は、マージ前に人間によるレビューが必要です。

掲載先

• npm： @arcadia-finance/mcp-server
• MCP Registry： registry.modelcontextprotocol.io
• Smithery： smithery.ai
• MCP Servers： mcpservers.org
• LobeHub： lobehub.com
• PulseMCP： pulsemcp.com
• MCP Market： mcpmarket.com
• Glama： glama.ai
• awesome-mcp-servers： github.com/TensorBlock/awesome-mcp-servers

開発

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