MCP.so
Sign In

Atv By Aarna

@aarna-ai

About Atv By Aarna

SDK to use ATV

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

20

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

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

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

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

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

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.

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

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

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

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

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.

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

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.

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

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

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

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

Get historical TVL (Total Value Locked) data points for an ATV vault over a specified period. Useful for charting TVL trends.

Get the total TVL (Total Value Locked) across all ATV vaults from the Aarna engine database.

Get a user's investment portfolio and position data for a specific ATV vault.

Overview

What is Atv By Aarna?

Atv By Aarna is an MCP server that provides AI-native access to Aarna’s tokenized yield vaults on Ethereum and Base. It offers 20 tools for vault discovery, performance metrics, transaction building, and portfolio tracking. The server is aimed at developers and AI agents who want to query and interact with DeFi vaults programmatically.

How to use Atv By Aarna?

Obtain an API key by reaching out to [email protected], then configure the MCP client with the Streamable HTTP endpoint https://atv-api.aarna.ai/mcp and the x-api-key header. Setup examples are provided for Claude Desktop, Claude Code, Cursor, VS Code (Copilot), and mcp-remote. Once configured, you can call any of the 20 tools to discover vaults, check APY, build deposit/withdraw transactions, and view user investments.

Key features of Atv By Aarna

  • 20 tools for vault management and analytics
  • Discovery and metadata for vaults across Ethereum and Base
  • Real-time NAV, TVL, and APY breakdowns
  • Instant and queued transaction builders (deposit, withdraw, stake, unstake)
  • Historical NAV and TVL data for trend analysis
  • User portfolio and investment tracking

Use cases of Atv By Aarna

  • Query available DeFi yield vaults on a specific chain
  • Monitor vault performance metrics (APY, TVL, NAV) in real time
  • Build and submit deposit/withdraw transactions via AI assistants
  • Track a user’s portfolio across all Aarna vaults
  • Check operational status (pause state) before executing transactions

FAQ from Atv By Aarna

How do I get an API key?

Send a request to [email protected] to receive an API key. All requests to the hosted API require the x-api-key header.

What chains does Atv By Aarna support?

It supports tokenized yield vaults on Ethereum and Base.

Which transport protocol does this server use?

It uses Streamable HTTP transport. The MCP endpoint is https://atv-api.aarna.ai/mcp. For stdio-only clients, you can use the mcp-remote wrapper.

Can I self-host the server?

Yes. A Dockerfile is provided to build and run the API locally. Required environment variables (database, Redis, RPC endpoints, etc.) must be set via AWS Secrets Manager or environment variables.

What license is the project under?

The project is licensed under the MIT License.

Frequently asked questions

How do I get an API key?

Send a request to [email protected] to receive an API key. All requests to the hosted API require the `x-api-key` header.

What chains does Atv By Aarna support?

It supports tokenized yield vaults on Ethereum and Base.

Which transport protocol does this server use?

It uses Streamable HTTP transport. The MCP endpoint is `https://atv-api.aarna.ai/mcp`. For stdio-only clients, you can use the `mcp-remote` wrapper.

Can I self-host the server?

Yes. A Dockerfile is provided to build and run the API locally. Required environment variables (database, Redis, RPC endpoints, etc.) must be set via AWS Secrets Manager or environment variables.

What license is the project under?

The project is licensed under the MIT License.

Comments

More Developer Tools MCP servers