@aarna-ai/mcp-server-atv 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aarna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# @aarna-ai/mcp-server-atv
+
+MCP server connector for **ATV** — AI-native access to Aarna's tokenized DeFi yield vaults on Ethereum and Base.
+
+19 tools for vault discovery, performance metrics (NAV, TVL, APY), deposit/withdraw/stake transaction building, and portfolio tracking.
+
+## Setup
+
+Get an API key from [Aarna](https://aarna.ai), then add the config to your MCP client:
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "atv": {
+      "url": "https://atv-api.aarna.ai/mcp",
+      "headers": { "x-api-key": "YOUR_API_KEY" }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add atv --transport http https://atv-api.aarna.ai/mcp --header "x-api-key: YOUR_API_KEY"
+```
+
+### Cursor
+
+Create `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "atv": {
+      "url": "https://atv-api.aarna.ai/mcp",
+      "headers": { "x-api-key": "YOUR_API_KEY" }
+    }
+  }
+}
+```
+
+### VS Code (Copilot)
+
+Add to `.vscode/settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "atv": {
+        "url": "https://atv-api.aarna.ai/mcp",
+        "headers": { "x-api-key": "YOUR_API_KEY" }
+      }
+    }
+  }
+}
+```
+
+### mcp-remote (stdio-only clients)
+
+```json
+{
+  "mcpServers": {
+    "atv": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://atv-api.aarna.ai/mcp", "--header", "x-api-key:YOUR_API_KEY"]
+    }
+  }
+}
+```
+
+## Tools (19)
+
+| Tool | Description |
+|------|-------------|
+| `list_vaults` | List all vaults, optionally filter by chain |
+| `get_vault` | Vault metadata by address |
+| `get_vault_nav` | Current NAV in USD |
+| `get_vault_tvl` | Current TVL in USD |
+| `get_vault_apy` | APY breakdown (base + reward + total) |
+| `get_deposit_status` | Whether deposits are paused |
+| `get_withdraw_status` | Whether withdrawals are paused |
+| `get_queue_withdraw_status` | Whether queued withdrawals are paused |
+| `build_deposit_tx` | Build approve + deposit steps |
+| `build_withdraw_tx` | Build withdrawal steps |
+| `build_stake_tx` | Build approve + stake steps |
+| `build_unstake_tx` | Build unstake step |
+| `build_queue_withdraw_tx` | Initiate queued withdrawal |
+| `build_unqueue_withdraw_tx` | Cancel pending queued withdrawal |
+| `build_redeem_withdraw_tx` | Claim completed queued withdrawal |
+| `get_vault_balance` | Underlying token breakdown |
+| `get_historical_nav` | NAV over N days |
+| `get_total_tvl` | Platform-wide or per-vault TVL |
+| `get_user_investments` | User portfolio and positions |
+
+## Example Prompts
+
+- "What DeFi vaults are available on Base?"
+- "What's the current APY for vault 0x...?"
+- "Build a deposit of 1000 USDC into vault 0x..."
+- "Show my portfolio across all Aarna vaults"
+- "Is the queue-withdraw paused on vault 0x...?"
+
+## Programmatic Usage
+
+```ts
+import { mcpConfig, TOOLS, MCP_SERVER_URL } from '@aarna-ai/mcp-server-atv';
+
+// Generate config for any MCP client
+const config = mcpConfig('your-api-key');
+
+console.log(MCP_SERVER_URL); // https://atv-api.aarna.ai/mcp
+console.log(TOOLS.length);   // 19
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+/** Default MCP server URL for the hosted ATV server. */
+declare const MCP_SERVER_URL = "https://atv-api.aarna.ai/mcp";
+/** MCP server name as registered in the protocol. */
+declare const MCP_SERVER_NAME = "atv";
+/** MCP server version. */
+declare const MCP_SERVER_VERSION = "1.0.0";
+/** All 19 tools exposed by the ATV MCP server. */
+declare const TOOLS: readonly ["list_vaults", "get_vault", "get_vault_nav", "get_vault_tvl", "get_vault_apy", "get_deposit_status", "get_withdraw_status", "get_queue_withdraw_status", "build_deposit_tx", "build_withdraw_tx", "build_stake_tx", "build_unstake_tx", "build_queue_withdraw_tx", "build_unqueue_withdraw_tx", "build_redeem_withdraw_tx", "get_vault_balance", "get_historical_nav", "get_total_tvl", "get_user_investments"];
+type AtvTool = (typeof TOOLS)[number];
+/**
+ * Generate an MCP client config object for connecting to the ATV server.
+ *
+ * Drop the result into `claude_desktop_config.json`, `.cursor/mcp.json`,
+ * or `.vscode/settings.json` under `mcp.servers`.
+ */
+declare function mcpConfig(apiKey: string, url?: string): {
+    mcpServers: {
+        atv: {
+            url: string;
+            headers: {
+                "x-api-key": string;
+            };
+        };
+    };
+};
+
+export { type AtvTool, MCP_SERVER_NAME, MCP_SERVER_URL, MCP_SERVER_VERSION, TOOLS, mcpConfig };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/** Default MCP server URL for the hosted ATV server. */
+declare const MCP_SERVER_URL = "https://atv-api.aarna.ai/mcp";
+/** MCP server name as registered in the protocol. */
+declare const MCP_SERVER_NAME = "atv";
+/** MCP server version. */
+declare const MCP_SERVER_VERSION = "1.0.0";
+/** All 19 tools exposed by the ATV MCP server. */
+declare const TOOLS: readonly ["list_vaults", "get_vault", "get_vault_nav", "get_vault_tvl", "get_vault_apy", "get_deposit_status", "get_withdraw_status", "get_queue_withdraw_status", "build_deposit_tx", "build_withdraw_tx", "build_stake_tx", "build_unstake_tx", "build_queue_withdraw_tx", "build_unqueue_withdraw_tx", "build_redeem_withdraw_tx", "get_vault_balance", "get_historical_nav", "get_total_tvl", "get_user_investments"];
+type AtvTool = (typeof TOOLS)[number];
+/**
+ * Generate an MCP client config object for connecting to the ATV server.
+ *
+ * Drop the result into `claude_desktop_config.json`, `.cursor/mcp.json`,
+ * or `.vscode/settings.json` under `mcp.servers`.
+ */
+declare function mcpConfig(apiKey: string, url?: string): {
+    mcpServers: {
+        atv: {
+            url: string;
+            headers: {
+                "x-api-key": string;
+            };
+        };
+    };
+};
+
+export { type AtvTool, MCP_SERVER_NAME, MCP_SERVER_URL, MCP_SERVER_VERSION, TOOLS, mcpConfig };

package/dist/index.js

@@ -0,0 +1,79 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MCP_SERVER_NAME: () => MCP_SERVER_NAME,
+  MCP_SERVER_URL: () => MCP_SERVER_URL,
+  MCP_SERVER_VERSION: () => MCP_SERVER_VERSION,
+  TOOLS: () => TOOLS,
+  mcpConfig: () => mcpConfig
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/config.ts
+var MCP_SERVER_URL = "https://atv-api.aarna.ai/mcp";
+var MCP_SERVER_NAME = "atv";
+var MCP_SERVER_VERSION = "1.0.0";
+var TOOLS = [
+  // Discovery & metadata
+  "list_vaults",
+  "get_vault",
+  // Performance metrics
+  "get_vault_nav",
+  "get_vault_tvl",
+  "get_vault_apy",
+  // Operational status
+  "get_deposit_status",
+  "get_withdraw_status",
+  "get_queue_withdraw_status",
+  // Transaction builders (instant)
+  "build_deposit_tx",
+  "build_withdraw_tx",
+  "build_stake_tx",
+  "build_unstake_tx",
+  // Transaction builders (queued)
+  "build_queue_withdraw_tx",
+  "build_unqueue_withdraw_tx",
+  "build_redeem_withdraw_tx",
+  // Analytics
+  "get_vault_balance",
+  "get_historical_nav",
+  "get_total_tvl",
+  "get_user_investments"
+];
+function mcpConfig(apiKey, url = MCP_SERVER_URL) {
+  return {
+    mcpServers: {
+      atv: {
+        url,
+        headers: { "x-api-key": apiKey }
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MCP_SERVER_NAME,
+  MCP_SERVER_URL,
+  MCP_SERVER_VERSION,
+  TOOLS,
+  mcpConfig
+});

package/dist/index.mjs

@@ -0,0 +1,48 @@
+// src/config.ts
+var MCP_SERVER_URL = "https://atv-api.aarna.ai/mcp";
+var MCP_SERVER_NAME = "atv";
+var MCP_SERVER_VERSION = "1.0.0";
+var TOOLS = [
+  // Discovery & metadata
+  "list_vaults",
+  "get_vault",
+  // Performance metrics
+  "get_vault_nav",
+  "get_vault_tvl",
+  "get_vault_apy",
+  // Operational status
+  "get_deposit_status",
+  "get_withdraw_status",
+  "get_queue_withdraw_status",
+  // Transaction builders (instant)
+  "build_deposit_tx",
+  "build_withdraw_tx",
+  "build_stake_tx",
+  "build_unstake_tx",
+  // Transaction builders (queued)
+  "build_queue_withdraw_tx",
+  "build_unqueue_withdraw_tx",
+  "build_redeem_withdraw_tx",
+  // Analytics
+  "get_vault_balance",
+  "get_historical_nav",
+  "get_total_tvl",
+  "get_user_investments"
+];
+function mcpConfig(apiKey, url = MCP_SERVER_URL) {
+  return {
+    mcpServers: {
+      atv: {
+        url,
+        headers: { "x-api-key": apiKey }
+      }
+    }
+  };
+}
+export {
+  MCP_SERVER_NAME,
+  MCP_SERVER_URL,
+  MCP_SERVER_VERSION,
+  TOOLS,
+  mcpConfig
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@aarna-ai/mcp-server-atv",
+  "version": "1.0.0",
+  "description": "MCP server connector for ATV — AI-native access to Aarna's DeFi yield vaults on Ethereum and Base",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "defi",
+    "yield",
+    "usdc",
+    "pendle",
+    "erc-4626",
+    "vault",
+    "agentic",
+    "fixed-income",
+    "stablecoin",
+    "aarna",
+    "atv",
+    "atv"
+  ],
+  "homepage": "https://github.com/aarna-ai/atv-sdk",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aarna-ai/atv-sdk.git",
+    "directory": "packages/mcp-server"
+  },
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean"
+  }
+}