aave-sentinel

Kimchiigu/aave-sentinel

3.2

If you are the rightful owner of aave-sentinel and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Model Context Protocol (MCP) server is a backend system designed to facilitate AI-driven interactions and operations within decentralized finance (DeFi) platforms, specifically tailored for Aave V3 on Base Sepolia.

🛡️ Aave Sentinel

Aave Sentinel is an AI-powered DeFi dashboard that acts as an autonomous guardian for your Aave V3 positions. Built with Next.js and powered by a custom Model Context Protocol (MCP) server, it bridges the gap between traditional UI interactions and agentic AI management.

Currently live on Base Sepolia.

License Network Status

🌟 Key Features

🧠 AI-Powered Interaction (MCP)

  • Natural Language Actions: Chat with the AI to perform complex DeFi operations (e.g., "Supply 100 USDC and borrow ETH").
  • Transaction Simulation: The AI automatically "dry-runs" transactions to estimate gas costs and Health Factor impact before you sign.
  • Intelligent Monitoring: The MCP server autonomously monitors your Health Factor (HF) and alerts you immediately if it drops below a safety threshold.

⚡ Dashboard Capabilities

  • Hybrid Control: Choose between chatting with the AI agent or using standard UI buttons to Supply, Borrow, and Repay.
  • Real-time Analytics: View wallet balances, current APY, and liquidation thresholds updated via Server-Sent Events (SSE).
  • Asset Support: Full support for standard Aave V3 assets on Base Sepolia.

🔮 Roadmap: The Future of Sentinel

We are actively developing Autonomous Protection:

  • ⚠️ Auto-Repay: The agent will automatically execute repay transactions to prevent liquidation if your Health Factor enters the danger zone.
  • 🔑 Session Keys (1-Day Permission): Implementation of limited-scope permissions. Users will sign once to grant the AI a 24-hour allowance to manage specific assets, removing the need to sign every emergency transaction manually.

🏗️ Architecture

Aave Sentinel consists of two parts working in tandem:

  1. Frontend (Next.js): A modern React dashboard that handles wallet connection, UI state, and chat streaming.
  2. Backend (Python MCP Server): A FastAPI server that implements the Model Context Protocol. It handles the "brain" work—calculating health factors, building raw transaction data, and interfacing with the blockchain via Web3.py.

🚀 Getting Started

Prerequisites

  • Node.js 18+
  • A Web3 Wallet (e.g., MetaMask, Rabby) connected to Base Sepolia.
  • Reown Project ID
  • Copy .env.example to .env

1. Clone the Repository

git clone [https://github.com/yourusername/aave-sentinel.git](https://github.com/Kimchiigu/aave-sentinel.git)
cd aave-sentinel

2. Install dependencies

npm install

3. Run the development server

npm run dev

Visit http://localhost:3000 to launch the Sentinel.