# atv

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.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add aarna-ai/atv

# Browse available tools
npx -y @smithery/cli@latest tool list aarna-ai/atv

# Get full schema for a tool
npx -y @smithery/cli@latest tool get aarna-ai/atv list_vaults

# Call a tool
npx -y @smithery/cli@latest tool call aarna-ai/atv list_vaults '{}'
```

## Direct MCP Connection

Endpoint: `https://atv--aarna-ai.run.tools`

**Required config:**
- `ATV_API_KEY` (header) — API key for authenticating with the ATV API

## Tools (19)

- `list_vaults` — List all available ATV vaults. Returns vault metadata including address, chain, withdraw type, contract type, and suppo…
- `get_vault` — Get metadata for a specific ATV vault by its contract address.
- `get_vault_nav` — Get the current Net Asset Value (NAV) of an ATV vault in USD.
- `get_vault_tvl` — Get the current Total Value Locked (TVL) of an ATV vault in USD.
- `get_vault_apy` — Get the current APY breakdown (base + reward + total) for an ATV vault.
- `build_deposit_tx` — Build the transaction steps required to deposit tokens into an ATV vault. Returns an ordered array of transactions (app…
- `build_withdraw_tx` — Build the transaction steps required to withdraw vault shares from an ATV vault and receive an output token.
- `get_deposit_status` — Check whether deposits are currently paused on an ATV vault. Use this before building a deposit transaction to avoid se…
- `get_withdraw_status` — Check whether withdrawals are currently paused on an ATV vault. Use this before building a withdraw transaction.
- `get_queue_withdraw_status` — Check whether queued (delayed) withdrawals are currently paused on an ATV vault.
- `build_stake_tx` — Build the transaction steps to stake vault tokens into a timelock contract for boosted rewards. Returns an approve step…
- `build_unstake_tx` — Build the transaction step to unstake vault tokens from a timelock contract.
- `build_queue_withdraw_tx` — Build the transaction step to initiate a queued (delayed) withdrawal from an ATV vault. The withdrawal is not instant —…
- `build_unqueue_withdraw_tx` — Build the transaction step to cancel a pending queued withdrawal request from an ATV vault.
- `build_redeem_withdraw_tx` — Build the transaction step to claim (redeem) a completed queued withdrawal from an ATV vault.
- `get_vault_balance` — Get the underlying token breakdown and balance data for an ATV vault from the Aarna engine database.
- `get_historical_nav` — Get historical NAV (Net Asset Value) data points for an ATV vault over a specified number of days. Useful for charting …
- `get_total_tvl` — Get the total TVL (Total Value Locked) across all ATV vaults, or for a specific vault, from the Aarna engine database.
- `get_user_investments` — Get a user's investment portfolio and position data across ATV vaults. Optionally filter to a specific vault.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get aarna-ai/atv <tool-name>
```

## Prompts (1)

- `vault_overview` — Get a comprehensive overview of all available ATV vaults with key metrics