{"_id":"@aarna-ai/mcp-server-atv","_rev":"2-112867aad26d7370a390e562145dba7b","name":"@aarna-ai/mcp-server-atv","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aarna-ai/mcp-server-atv","version":"1.0.0","keywords":["mcp","mcp-server","defi","yield","usdc","pendle","erc-4626","vault","agentic","fixed-income","stablecoin","aarna","atv","atv"],"license":"MIT","_id":"@aarna-ai/mcp-server-atv@1.0.0","maintainers":[{"name":"dev-aarna","email":"dev@aarnalab.dev"}],"homepage":"https://github.com/aarna-ai/atv-sdk","bugs":{"url":"https://github.com/aarna-ai/atv-sdk/issues"},"dist":{"shasum":"facafccf3421fa4ea6d68b8b7145a95d65b0d827","tarball":"https://registry.npmjs.org/@aarna-ai/mcp-server-atv/-/mcp-server-atv-1.0.0.tgz","fileCount":7,"integrity":"sha512-gF6HTS+LmER8VUVkICSoo82uqe8i+T6c80UiMyCkcLXhYfvXV2LU/h+ZZIJOB2SdO4Mz1aTMajdKxyu0eJf/Aw==","signatures":[{"sig":"MEUCIAGLqARHo8D9lnsMZY8LOTm0o4wdm91EIKBxH1MYjlOiAiEAjI0oDzPvYaRyTUN6OGoGoL4VrGbTghNlmQ9FrJSC060=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11039},"main":"./dist/index.js","_from":"file:aarna-ai-mcp-server-atv-1.0.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"build":"tsup src/index.ts --format cjs,esm --dts --clean"},"_npmUser":{"name":"dev-aarna","email":"dev@aarnalab.dev"},"_resolved":"/tmp/599a14b144ec7dcb61131d04d1a6709b/aarna-ai-mcp-server-atv-1.0.0.tgz","_integrity":"sha512-gF6HTS+LmER8VUVkICSoo82uqe8i+T6c80UiMyCkcLXhYfvXV2LU/h+ZZIJOB2SdO4Mz1aTMajdKxyu0eJf/Aw==","repository":{"url":"git+https://github.com/aarna-ai/atv-sdk.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.8.2","description":"MCP server connector for ATV — AI-native access to Aarna's DeFi yield vaults on Ethereum and Base","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.3.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-atv_1.0.0_1773745527426_0.0036014496206020485","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aarna-ai/mcp-server-atv","version":"1.0.1","mcpName":"io.github.aarna-ai/atv","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":"git+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"}},"devDependencies":{"tsup":"^8.0.0","typescript":"^5.3.0"},"scripts":{"build":"tsup src/index.ts --format cjs,esm --dts --clean"},"_id":"@aarna-ai/mcp-server-atv@1.0.1","bugs":{"url":"https://github.com/aarna-ai/atv-sdk/issues"},"_integrity":"sha512-O9s7/cKGzKqg6WonkCoDefksS2O1B4wfeGMhdtBHt94FWz5+5AHRUa7kSKdGW6h18qThUgQ8E1EVPpbFQ2oqjw==","_resolved":"/tmp/101d88a6d081f90ca87b2e50b2ca39d0/aarna-ai-mcp-server-atv-1.0.1.tgz","_from":"file:aarna-ai-mcp-server-atv-1.0.1.tgz","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-O9s7/cKGzKqg6WonkCoDefksS2O1B4wfeGMhdtBHt94FWz5+5AHRUa7kSKdGW6h18qThUgQ8E1EVPpbFQ2oqjw==","shasum":"5594fd317a317767f57a6d3ff16e64ae1e18cf57","tarball":"https://registry.npmjs.org/@aarna-ai/mcp-server-atv/-/mcp-server-atv-1.0.1.tgz","fileCount":7,"unpackedSize":11078,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDtPqyQz8mueSc6EIqa4fPZnoraPRNiAXoSDVr5nduZVwIgBP8XtaO1Pk9w8W47QIe3NWv+1+l2q60uRK+cpSW1aio="}]},"_npmUser":{"name":"dev-aarna","email":"dev@aarnalab.dev"},"directories":{},"maintainers":[{"name":"dev-aarna","email":"dev@aarnalab.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-atv_1.0.1_1773750991849_0.0899699955192168"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T11:05:27.326Z","modified":"2026-03-17T12:36:32.156Z","1.0.0":"2026-03-17T11:05:27.570Z","1.0.1":"2026-03-17T12:36:32.002Z"},"bugs":{"url":"https://github.com/aarna-ai/atv-sdk/issues"},"license":"MIT","homepage":"https://github.com/aarna-ai/atv-sdk","keywords":["mcp","mcp-server","defi","yield","usdc","pendle","erc-4626","vault","agentic","fixed-income","stablecoin","aarna","atv","atv"],"repository":{"type":"git","url":"git+https://github.com/aarna-ai/atv-sdk.git","directory":"packages/mcp-server"},"description":"MCP server connector for ATV — AI-native access to Aarna's DeFi yield vaults on Ethereum and Base","maintainers":[{"name":"dev-aarna","email":"dev@aarnalab.dev"}],"readme":"# @aarna-ai/mcp-server-atv\n\nMCP server connector for **ATV** — AI-native access to Aarna's tokenized DeFi yield vaults on Ethereum and Base.\n\n19 tools for vault discovery, performance metrics (NAV, TVL, APY), deposit/withdraw/stake transaction building, and portfolio tracking.\n\n## Setup\n\nGet an API key from [Aarna](https://aarna.ai), then add the config to your MCP client:\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"atv\": {\n      \"url\": \"https://atv-api.aarna.ai/mcp\",\n      \"headers\": { \"x-api-key\": \"YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add atv --transport http https://atv-api.aarna.ai/mcp --header \"x-api-key: YOUR_API_KEY\"\n```\n\n### Cursor\n\nCreate `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"atv\": {\n      \"url\": \"https://atv-api.aarna.ai/mcp\",\n      \"headers\": { \"x-api-key\": \"YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n### VS Code (Copilot)\n\nAdd to `.vscode/settings.json`:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"atv\": {\n        \"url\": \"https://atv-api.aarna.ai/mcp\",\n        \"headers\": { \"x-api-key\": \"YOUR_API_KEY\" }\n      }\n    }\n  }\n}\n```\n\n### mcp-remote (stdio-only clients)\n\n```json\n{\n  \"mcpServers\": {\n    \"atv\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://atv-api.aarna.ai/mcp\", \"--header\", \"x-api-key:YOUR_API_KEY\"]\n    }\n  }\n}\n```\n\n## Tools (19)\n\n| Tool | Description |\n|------|-------------|\n| `list_vaults` | List all vaults, optionally filter by chain |\n| `get_vault` | Vault metadata by address |\n| `get_vault_nav` | Current NAV in USD |\n| `get_vault_tvl` | Current TVL in USD |\n| `get_vault_apy` | APY breakdown (base + reward + total) |\n| `get_deposit_status` | Whether deposits are paused |\n| `get_withdraw_status` | Whether withdrawals are paused |\n| `get_queue_withdraw_status` | Whether queued withdrawals are paused |\n| `build_deposit_tx` | Build approve + deposit steps |\n| `build_withdraw_tx` | Build withdrawal steps |\n| `build_stake_tx` | Build approve + stake steps |\n| `build_unstake_tx` | Build unstake step |\n| `build_queue_withdraw_tx` | Initiate queued withdrawal |\n| `build_unqueue_withdraw_tx` | Cancel pending queued withdrawal |\n| `build_redeem_withdraw_tx` | Claim completed queued withdrawal |\n| `get_vault_balance` | Underlying token breakdown |\n| `get_historical_nav` | NAV over N days |\n| `get_total_tvl` | Platform-wide or per-vault TVL |\n| `get_user_investments` | User portfolio and positions |\n\n## Example Prompts\n\n- \"What DeFi vaults are available on Base?\"\n- \"What's the current APY for vault 0x...?\"\n- \"Build a deposit of 1000 USDC into vault 0x...\"\n- \"Show my portfolio across all Aarna vaults\"\n- \"Is the queue-withdraw paused on vault 0x...?\"\n\n## Programmatic Usage\n\n```ts\nimport { mcpConfig, TOOLS, MCP_SERVER_URL } from '@aarna-ai/mcp-server-atv';\n\n// Generate config for any MCP client\nconst config = mcpConfig('your-api-key');\n\nconsole.log(MCP_SERVER_URL); // https://atv-api.aarna.ai/mcp\nconsole.log(TOOLS.length);   // 19\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}