@aarna-ai/mcp-server-atv

@aarna-ai/mcp-server-atv

MCP server connector for ATV — AI-native access to Aarna's tokenized DeFi yield vaults on Ethereum and Base.

19 tools for vault discovery, performance metrics (NAV, TVL, APY), deposit/withdraw/stake transaction building, and portfolio tracking.

Setup

Get an API key from Aarna, then add the config to your MCP 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 (stdio-only clients)

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

Tools (19)

Tool	Description
list_vaults	List all vaults, optionally filter by chain
get_vault	Vault metadata by address
get_vault_nav	Current NAV in USD
get_vault_tvl	Current TVL in USD
get_vault_apy	APY breakdown (base + reward + total)
get_deposit_status	Whether deposits are paused
get_withdraw_status	Whether withdrawals are paused
get_queue_withdraw_status	Whether queued withdrawals are paused
build_deposit_tx	Build approve + deposit steps
build_withdraw_tx	Build withdrawal steps
build_stake_tx	Build approve + stake steps
build_unstake_tx	Build unstake step
build_queue_withdraw_tx	Initiate queued withdrawal
build_unqueue_withdraw_tx	Cancel pending queued withdrawal
build_redeem_withdraw_tx	Claim completed queued withdrawal
get_vault_balance	Underlying token breakdown
get_historical_nav	NAV over N days
get_total_tvl	Platform-wide or per-vault TVL
get_user_investments	User portfolio and positions

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...?"

Programmatic Usage

import { mcpConfig, TOOLS, MCP_SERVER_URL } from '@aarna-ai/mcp-server-atv';

// Generate config for any MCP client
const config = mcpConfig('your-api-key');

console.log(MCP_SERVER_URL); // https://atv-api.aarna.ai/mcp
console.log(TOOLS.length);   // 19

License

MIT