Skip to content

feat: add ATV (Aarna Tokenized Vault) action provider#1022

Open
sai-aarna wants to merge 2 commits intocoinbase:mainfrom
sai-aarna:feat/atv-action-provider
Open

feat: add ATV (Aarna Tokenized Vault) action provider#1022
sai-aarna wants to merge 2 commits intocoinbase:mainfrom
sai-aarna:feat/atv-action-provider

Conversation

@sai-aarna
Copy link

Description

Add ATV (Aarna Tokenized Vault) action provider for interacting with Aarna's DeFi yield vaults on Ethereum and Base.

This provider enables agents to:

  • List all available yield vaults with metadata and operational status
  • Query real-time vault performance metrics (NAV, TVL, APY)
  • Build ready-to-sign deposit and withdraw transaction calldata
  • Track user portfolio positions and share balances

The provider connects to Aarna's hosted API (https://atv-api.aarna.ai) via API key authentication and requires no on-chain wallet interaction for read operations.

npm: https://www.npmjs.com/package/@aarna-ai/mcp-server-atv
GitHub: https://github.com/aarna-ai/atv-sdk

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Ethereum Mainnet (read-only)
Setup: ATV_API_KEY set in environment

Prompt: list all available ATV vaults

The following ATV vaults are available:

  • ATV PTmax USDC (Ethereum) — APY: 9.2%, TVL: $12.4M
  • ATV PTmax USDC (Base) — APY: 8.7%, TVL: $3.1M

Prompt: what is the current NAV for the USDC vault on Ethereum?

The current NAV price for ATV PTmax USDC on Ethereum is $1.0234

Prompt: build a deposit transaction for 1000 USDC into the Ethereum vault for wallet 0xABC...123

Built deposit transaction:

  1. Approve TX: {to: 0xA0b8...eB48, data: 0x095ea7b3...}
  2. Deposit TX: {to: 0x1234...5678, data: 0x6e553f65...}
    Send these transactions in order to complete the deposit.

Checklist

  • Added documentation to all relevant README.md files
  • Added a changelog entry

🤖 Generated with Claude Code

@sai-aarna sai-aarna requested a review from murrlincoln as a code owner March 18, 2026 11:46
@cb-heimdall
Copy link

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

@github-actions github-actions bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Mar 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants