Atv By Aarna

ATV — DeFi イールドボールト MCP サーバー

Ethereum と Base 上の Aarna のトークン化イールドボールトに、AI ネイティブな方法でアクセスできます。ボールトの検索、パフォーマンス指標、トランザクションの構築、ポートフォリオの追跡に対応する 20 個のツールを提供します。

API ベース URL: https://atv-api.aarna.ai MCP エンドポイント: https://atv-api.aarna.ai/mcp（Streamable HTTP） API ドキュメント: https://atv-api.aarna.ai/docs

API アクセス

https://atv-api.aarna.ai のホスト型 API は、有効な API キーをお持ちの方ならどなたでもご利用いただけます。すべてのリクエストに x-api-key ヘッダーが必要です。

API キーの取得については、[email protected] までお問い合わせください。

クイックスタート（30 秒）

API キーを取得したら、クライアントに設定を追加します。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "atv": {
      "url": "https://atv-api.aarna.ai/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Claude Code

claude mcp add atv --transport http https://atv-api.aarna.ai/mcp --header "x-api-key: YOUR_API_KEY"

Cursor

プロジェクトのルートに .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "atv": {
      "url": "https://atv-api.aarna.ai/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

VS Code（Copilot）

.vscode/settings.json に追加します。

{
  "mcp": {
    "servers": {
      "atv": {
        "url": "https://atv-api.aarna.ai/mcp",
        "headers": { "x-api-key": "YOUR_API_KEY" }
      }
    }
  }
}

mcp-remote（stdio のみ対応するクライアント向けの代替手段）

{
  "mcpServers": {
    "atv": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://atv-api.aarna.ai/mcp", "--header", "x-api-key:YOUR_API_KEY"]
    }
  }
}

利用可能なツール（19）

検索とメタデータ

ツール	説明
list_vaults	すべてのボールトを一覧表示します。チェーンでの絞り込みも可能です
get_vault	アドレスを指定して、特定のボールトのメタデータを取得します

パフォーマンス指標

ツール	説明
get_vault_nav	現在の NAV（純資産価値）を USD で取得します
get_vault_tvl	現在の TVL（ロックされた総資産額）を USD で取得します
get_vault_apy	APY の内訳（基本報酬＋追加報酬＋合計）を取得します

運用状況

ツール	説明
get_deposit_status	入金が一時停止されているかどうかを確認します
get_withdraw_status	出金が一時停止されているかどうかを確認します
get_queue_withdraw_status	キューに入れた出金が一時停止されているかどうかを確認します

トランザクションビルダー（即時）

ツール	説明
build_deposit_tx	approve と入金のトランザクション手順を構築します
build_withdraw_tx	出金のトランザクション手順を構築します
build_stake_tx	approve とステーキングの手順を構築します（タイムロック型ボールト）
build_unstake_tx	ステーキング解除の手順を構築します（タイムロック型ボールト）

トランザクションビルダー（キュー）

ツール	説明
build_queue_withdraw_tx	キューに入れた出金を開始します
build_unqueue_withdraw_tx	保留中のキュー出金をキャンセルします
build_redeem_withdraw_tx	完了したキュー出金を受け取ります

分析

ツール	説明
get_vault_portfolio	原資産トークンのポートフォリオを取得します
get_historical_nav	期間（7、30、60、360、最大）ごとの NAV データポイントを取得します
get_historical_tvl	期間（7、30、60、360、最大）ごとの TVL データポイントを取得します
get_total_tvl	プラットフォーム全体またはボールトごとの TVL を取得します
get_user_investments	ユーザーのポートフォリオとポジションを取得します

プロンプトの例

• 「Base で利用できる DeFi ボールトは何ですか？」
• 「ボールト 0x... の現在の APY はいくらですか？」
• 「1000 USDC をボールト 0x... に入金するトランザクションを構築して」
• 「すべての Aarna ボールトを対象に、自分のポートフォリオを表示して」
• 「ボールト 0x... でキュー出金は一時停止されていますか？」

REST API

すべてのエンドポイントで x-api-key ヘッダーが必要です。エンドポイントのプレフィックスは /v1 です。

Vault エンドポイント

メソッド	パス	説明
GET	/v1/vaults	利用可能なすべての Vault を一覧表示します
GET	/v1/vaults/tvl	プラットフォーム全体の TVL
GET	/v1/vaults/:address	Vault のメタデータ
GET	/v1/vaults/:address/nav	NAV 価格
GET	/v1/vaults/:address/tvl	Vault の TVL
GET	/v1/vaults/:address/apy	APY の内訳
GET	/v1/vaults/:address/deposit-status	入金の一時停止状況
GET	/v1/vaults/:address/withdraw-status	出金の一時停止状況
GET	/v1/vaults/:address/queue-withdraw-status	出金キューの一時停止状況
GET	/v1/vaults/:address/portfolio	トークンポートフォリオ
GET	/v1/vaults/:address/historical-nav	過去の NAV（期間：7、30、60、360、max 日）
GET	/v1/vaults/:address/historical-tvl	過去の TVL（期間：7、30、60、360、max 日）

トランザクションエンドポイント

メソッド	パス	説明
GET	/v1/deposit-tx	入金用 calldata を生成します
GET	/v1/withdraw-tx	出金用 calldata を生成します
GET	/v1/stake-tx	ステーキング用 calldata を生成します
GET	/v1/unstake-tx	ステーキング解除用 calldata を生成します
GET	/v1/queue-withdraw-tx	出金キュー登録用 calldata を生成します
GET	/v1/unqueue-withdraw-tx	出金キュー解除用 calldata を生成します
GET	/v1/redeem-withdraw-tx	出金償還用 calldata を生成します

その他のエンドポイント

メソッド	パス	説明
GET	/v1/user-investments	ユーザーポートフォリオデータ
ALL	/mcp	MCP サーバー（Streamable HTTP）

認証不要

メソッド	パス	説明
GET	/health	ヘルスチェック
GET	/openapi.json	OpenAPI 3.1 仕様
GET	/docs	インタラクティブな API リファレンス
GET	/llms.txt	LLM に適したドキュメント（llms.txt 仕様）
GET	/.well-known/agent.json	A2A エージェントカード

TypeScript SDK

import { AtvClient } from '@atv/sdk';

const client = new AtvClient({
  apiKey: 'atv_...',
  baseUrl: 'https://atv-api.aarna.ai',
});

const vaults = await client.vaults.list({ chain: 'base' });
const nav = await client.vaults.nav('0xVaultAddress');

セルフホスト

docker build -t atv-api \
  --build-arg AWS_ACCESS_KEY_ID=... \
  --build-arg AWS_SECRET_ACCESS_KEY=... \
  --build-arg AWS_DEFAULT_REGION=us-east-1 .

docker run -p 3000:3000 atv-api

必須の環境変数（AWS Secrets Manager の atv-sdk に設定）：

• DATABASE_URL — PostgreSQL 接続文字列
• REDIS_URL — Redis のホスト:ポート
• RPC_URL_ETHEREUM — Ethereum JSON-RPC エンドポイント
• RPC_URL_BASE — Base JSON-RPC エンドポイント
• STRAPI_URL — CMS URL
• STRAPI_API_TOKEN — CMS API トークン
• ENGINE_BASE_URL — Aarna エンジン API

開発

前提条件

• Node.js 20+
• pnpm
• PostgreSQL
• Redis

セットアップ

pnpm install
cp .env.example apps/api/.env
# Fill in environment variables
pnpm migrate
pnpm dev

API：http://localhost:3000 | ドキュメント：http://localhost:3000/docs

リポジトリ構成

atv-sdk/
├── apps/api/              # Express API server + MCP server
├── packages/sdk/          # TypeScript SDK (@atv/sdk)
├── packages/mcp-server/   # npm connector package (@aarna-ai/mcp-server-atv)
├── server.json            # MCP registry manifest
└── docs/                  # Guides

ビルド

pnpm build
# API: apps/api/dist/
# SDK: packages/sdk/dist/ (CJS + ESM)

顧客オンボーディング

API キーの生成、ティアの管理、アクセスの取り消し、管理者クエリの実行方法については、docs/customer-onboarding.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。