Atv

aarna-ai/atv-sdk

Connects Claude to Aarna's tokenized DeFi yield vaults on Ethereum and Base. Exposes 19 tools covering vault discovery, real-time NAV/TVL/APY queries, deposit/withdraw/stake transaction builders, and portfolio tracking across user positions. Handles both instant and queued withdrawal flows, pausing status checks, and historical performance data. Runs as a hosted streamable HTTP endpoint requiring an API key (request at dev@aarnalab.dev). Useful when you need to query vault metrics, construct on-chain transactions for vault operations, or track DeFi positions without writing contract integration code yourself. Includes a TypeScript SDK and self-hosting option via Docker if you want to run it locally.

tools: 19
auth: Secret needed
transport: HTTP
env var: 1
last updated: Mar 18, 2026

View on GitHub

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

list_vaultsList all available ATV vaults. Returns vault metadata including address, chain, withdraw type, contract type, and supported deposit tokens with balances.2 params

List all available ATV vaults. Returns vault metadata including address, chain, withdraw type, contract type, and supported deposit tokens with balances.

Parameters* required

chainstring

Filter by chain name or ID (e.g. 'ethereum', 'base', '8453')

userAddressstring

EVM address to include token balances for each deposit token

get_vaultGet metadata for a specific ATV vault by its contract address.2 params

Get metadata for a specific ATV vault by its contract address.

Parameters* required

addressstring

Vault contract address

userAddressstring

EVM address to include token balances for

get_vault_navGet the current Net Asset Value (NAV) of an ATV vault in USD.1 params

Get the current Net Asset Value (NAV) of an ATV vault in USD.

Parameters* required

addressstring

Vault contract address

get_vault_tvlGet the current Total Value Locked (TVL) of an ATV vault in USD.1 params

Get the current Total Value Locked (TVL) of an ATV vault in USD.

Parameters* required

addressstring

Vault contract address

get_vault_apyGet the current APY breakdown (base + reward + total) for an ATV vault.1 params

Get the current APY breakdown (base + reward + total) for an ATV vault.

Parameters* required

addressstring

Vault contract address

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.4 params

Build 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.

Parameters* required

depositAmountstring

Human-readable deposit amount, e.g. '100' for 100 USDC

depositTokenAddressstring

ERC20 token address to deposit

userAddressstring

EVM address of the depositor

vaultAddressstring

Vault contract address

build_withdraw_txBuild the transaction steps required to withdraw vault shares from an ATV vault and receive an output token.6 params

Build the transaction steps required to withdraw vault shares from an ATV vault and receive an output token.

Parameters* required

oTokenAddressstring

Output token address to receive

sharesToWithdrawstring

Human-readable share amount to withdraw, e.g. '100'

simulatestring

Pass 'true' to include a gas estimate in the response

slippagestring

Slippage tolerance as a percentage, e.g. '0.5'

userAddressstring

EVM address of the withdrawer

vaultAddressstring

Vault contract address

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.1 params

Check whether deposits are currently paused on an ATV vault. Use this before building a deposit transaction to avoid sending a doomed tx.

Parameters* required

addressstring

Vault contract address

get_withdraw_statusCheck whether withdrawals are currently paused on an ATV vault. Use this before building a withdraw transaction.1 params

Check whether withdrawals are currently paused on an ATV vault. Use this before building a withdraw transaction.

Parameters* required

addressstring

Vault contract address

get_queue_withdraw_statusCheck whether queued (delayed) withdrawals are currently paused on an ATV vault.1 params

Check whether queued (delayed) withdrawals are currently paused on an ATV vault.

Parameters* required

addressstring

Vault contract address

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.4 params

Build the transaction steps to stake vault tokens into a timelock contract for boosted rewards. Returns an approve step (if needed) and a stake step.

Parameters* required

lockPeriodIndexstring

0-indexed lock period to select from the timelock contract (e.g. '0', '1', '2')

stakeAmountstring

Human-readable vault token amount to stake, e.g. '100'

userAddressstring

EVM address of the staker

vaultAddressstring

Vault contract address

build_unstake_txBuild the transaction step to unstake vault tokens from a timelock contract.4 params

Build the transaction step to unstake vault tokens from a timelock contract.

Parameters* required

stakeIndexstring

0-indexed position in the user's stake array to unstake from

unstakeAmountstring

Human-readable vault token amount to unstake, e.g. '100'

userAddressstring

EVM address of the staker

vaultAddressstring

Vault contract address

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.4 params

Build 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.

Parameters* required

tokensToWithdrawstring

Human-readable vault share amount to queue for withdrawal

userAddressstring

EVM address of the withdrawer

vaultAddressstring

Vault contract address

withdrawTokenAddressstring

Output token address to receive when the withdrawal is redeemed

build_unqueue_withdraw_txBuild the transaction step to cancel a pending queued withdrawal request from an ATV vault.4 params

Build the transaction step to cancel a pending queued withdrawal request from an ATV vault.

Parameters* required

oTokenAddressstring

Output token address of the queued request to cancel

requestIdstring

Specific request ID to cancel (omit to cancel the latest request)

userAddressstring

EVM address of the withdrawer

vaultAddressstring

Vault contract address

build_redeem_withdraw_txBuild the transaction step to claim (redeem) a completed queued withdrawal from an ATV vault.4 params

Build the transaction step to claim (redeem) a completed queued withdrawal from an ATV vault.

Parameters* required

batchCounterstring

Batch identifier from the queue contract for this withdrawal

oTokensstring

Human-readable amount of output tokens to redeem

userAddressstring

EVM address of the withdrawer

vaultAddressstring

Vault contract address

get_vault_balanceGet the underlying token breakdown and balance data for an ATV vault from the Aarna engine database.1 params

Get the underlying token breakdown and balance data for an ATV vault from the Aarna engine database.

Parameters* required

addressstring

Vault contract address

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.2 params

Get historical NAV (Net Asset Value) data points for an ATV vault over a specified number of days. Useful for charting price trends.

Parameters* required

addressstring

Vault contract address

daysstring

Number of days of history to return (default: 30)

get_total_tvlGet the total TVL (Total Value Locked) across all ATV vaults, or for a specific vault, from the Aarna engine database.1 params

Get the total TVL (Total Value Locked) across all ATV vaults, or for a specific vault, from the Aarna engine database.

Parameters* required

addressstring

Vault contract address to filter to a single vault (omit for platform-wide TVL)

get_user_investmentsGet a user's investment portfolio and position data across ATV vaults. Optionally filter to a specific vault.2 params

Get a user's investment portfolio and position data across ATV vaults. Optionally filter to a specific vault.

Parameters* required

userAddressstring

EVM address of the user

vaultAddressstring

Vault contract address to filter to a single vault

Configuration

ATV_API_KEY*secret

API key for authenticating with the ATV API

Readme

ATV — DeFi Yield Vault MCP Server

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.

View the full README on GitHub

Details

Repository: github.com/aarna-ai/atv-sdk
Category: Finance & Commerce
Package: @aarna-ai/mcp-server-atv
Transport: HTTP
Auth: Required
Registry: MCP registry, active

Related Finance & Commerce MCP servers

View all

Agentmartai-gaoqian/agentmart-mcp-serverFirst AI Agent e-commerce marketplace with 74+ AI products, MCP protocol, and Alipay payments0stars

Artefact Revenue Intelligencealexboissav/artefact-mcp-serverRevenue intelligence MCP: RFM analysis, 14.5-point ICP scoring, pipeline health. HubSpot.0stars

DEX Swap Quotes APIbr0ski777/dex-quotes-x402Best swap quotes across DEXes (Uniswap, SushiSwap, Aerodrome). Base & Ethereum. x402.0stars

ENS Resolver APIbr0ski777/ens-resolver-x402Resolve ENS names to Ethereum addresses and reverse. x402 micropayment.0stars

Funding Rate Arbitrage Scanner APIbr0ski777/funding-arb-x402Cross-venue perp funding rate arb — Hyperliquid, Binance, Bybit, OKX spreads. x402.0stars

Perpetual Funding Rates APIbr0ski777/funding-rates-x402Perp funding rates across Binance, Bybit, OKX — open interest, sentiment. x402.0stars