Atv

ATV — DeFi Yield Vault MCP Server

[npm version] [npm downloads] [smithery badge] [MCP Registry] [License: MIT] [TypeScript] [GitHub]

AI-native access to Aarna's tokenized yield vaults on Ethereum and Base. 20 tools for vault discovery, performance metrics, transaction building, and portfolio tracking.

API Base URL: https://atv-api.aarna.ai MCP Endpoint: https://atv-api.aarna.ai/mcp (Streamable HTTP) API Docs: https://atv-api.aarna.ai/docs

API Access

The hosted API at https://atv-api.aarna.ai is available to anyone with a valid API key. All requests require an x-api-key header.

To get an API key, reach out to us at [email protected].

Quick Start (30 seconds)

Once you have your API key, add the config to your client:

Claude Desktop

Edit ~/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

Create .cursor/mcp.json in your project root:

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

VS Code (Copilot)

Add to .vscode/settings.json:

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

mcp-remote (fallback for stdio-only clients)

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

Available Tools (19)

Discovery & Metadata

Performance Metrics

Operational Status

Transaction Builders (Instant)

Transaction Builders (Queued)

Analytics

Example Prompts

• "What DeFi vaults are available on Base?"
• "What's the current APY for vault 0x...?"
• "Build a deposit of 1000 USDC into vault 0x..."
• "Show my portfolio across all Aarna vaults"
• "Is the queue-withdraw paused on vault 0x...?"

REST API

All endpoints require x-api-key header and are prefixed with /v1.

Vault Endpoints

Transaction Endpoints

Other Endpoints

Unauthenticated

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

Self-Hosting

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

Required environment variables (set in AWS Secrets Manager under atv-sdk):

• DATABASE_URL — PostgreSQL connection string
• REDIS_URL — Redis host:port
• RPC_URL_ETHEREUM — Ethereum JSON-RPC endpoint
• RPC_URL_BASE — Base JSON-RPC endpoint
• STRAPI_URL — CMS URL
• STRAPI_API_TOKEN — CMS API token
• ENGINE_BASE_URL — Aarna engine API

Development

Prerequisites

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

Setup

pnpm installcp .env.example apps/api/.env# Fill in environment variablespnpm migratepnpm dev

API: http://localhost:3000 | Docs: http://localhost:3000/docs

Repository Structure

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

Build

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

Customer Onboarding

See docs/customer-onboarding.md for how to generate API keys, manage tiers, revoke access, and run admin queries.

License

MIT — see LICENSE.