atv

AI-native access to aarna's tokenized yield vaults on Ethereum and Base.

CommunityOnlineAPI key requiredGlobalFreeRead-only

What it can do

  • List Vaults: List all available ATV vaults. Returns vault metadata including address, chain, withdraw type, contract type, and supported deposit tokens with balances.
  • 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.

What data it sees

Do you need an account

An API key from the service settings is required

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.

How to connect

How to connect atv to Claude

The server address to paste into Claude settings:

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

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect atv to ChatGPT

The server address to paste into ChatGPT settings:

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

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect atv to Cursor

The server address to paste into Cursor settings:

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

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (19)

Raw names from tools/list. Only developers need these.

list_vaultsList all available ATV vaults. Returns vault metadata including address, chain, withdraw type, contract type, and supported deposit tokens with balances.
get_vaultGet metadata for a specific ATV vault by its contract address.
get_vault_navGet the current Net Asset Value (NAV) of an ATV vault in USD.
get_vault_tvlGet the current Total Value Locked (TVL) of an ATV vault in USD.
get_vault_apyGet the current APY breakdown (base + reward + total) for an ATV vault.
build_deposit_txBuild the transaction steps required to deposit tokens into an ATV vault. Returns an ordered array of transactions (approve then deposit) that must be sent in order.
build_withdraw_txBuild the transaction steps required to withdraw vault shares from an ATV vault and receive an output token.
get_deposit_statusCheck whether deposits are currently paused on an ATV vault. Use this before building a deposit transaction to avoid sending a doomed tx.
get_withdraw_statusCheck whether withdrawals are currently paused on an ATV vault. Use this before building a withdraw transaction.
get_queue_withdraw_statusCheck whether queued (delayed) withdrawals are currently paused on an ATV vault.
build_stake_txBuild the transaction steps to stake vault tokens into a timelock contract for boosted rewards. Returns an approve step (if needed) and a stake step.
build_unstake_txBuild the transaction step to unstake vault tokens from a timelock contract.
build_queue_withdraw_txBuild the transaction step to initiate a queued (delayed) withdrawal from an ATV vault. The withdrawal is not instant — it must be redeemed later once processed.
build_unqueue_withdraw_txBuild the transaction step to cancel a pending queued withdrawal request from an ATV vault.
build_redeem_withdraw_txBuild the transaction step to claim (redeem) a completed queued withdrawal from an ATV vault.
get_vault_balanceGet the underlying token breakdown and balance data for an ATV vault from the Aarna engine database.
get_historical_navGet historical NAV (Net Asset Value) data points for an ATV vault over a specified number of days. Useful for charting price trends.
get_total_tvlGet the total TVL (Total Value Locked) across all ATV vaults, or for a specific vault, from the Aarna engine database.
get_user_investmentsGet a user's investment portfolio and position data across ATV vaults. Optionally filter to a specific vault.