Enables cross-chain DeFi operations including token swaps, portfolio tracking, and automated trading strategies across Ethereum and 200+ other blockchain networks
Provides source code repository integration with automated deployment workflows and issue tracking for the MCP server development
Provides access to Optimism network for DeFi portfolio management, swap execution, and automated trading strategy deployment
Supports DeFi operations on Polygon network including token swaps, portfolio analysis, and yield farming opportunities through AURA API integration
Supports deployment and hosting of the AURA MCP server with CLI-based deployment and environment variable configuration
Provides ready-to-run deployment environment for the AURA MCP server with auto-configured port settings and integrated development environment
Enables one-click deployment of the AURA MCP server with automatic configuration and environment variable management for production hosting
π AURA MCP Server
Bridge LLMs with AURA API for DeFi Intelligence & On-Chain Automation
A production-ready Model Context Protocol (MCP) server that enables Claude & ChatGPT to interact with AURA API for real-time DeFi portfolio analysis, swap execution, yield opportunities, and automated trading strategies across 200+ blockchain networks.
π Features
π Swap Execution (NEW)
Natural language swap intent parsing ("swap 1 ETH to USDC on Base")
AURA-powered DEX aggregation (auto-selects best route across 200+ chains)
9M+ token support with real-time pricing
Web-based transaction signing (secure browser signing)
Token allowance management (auto-approval flow)
Guard validation (slippage, gas, risk management)
πΌ Portfolio Management
Cross-chain wallet balance tracking
DeFi position monitoring with health factors
Real-time USD value calculations
Support for native tokens and ERC-20s
π― Operations Intelligence (100% Real-Time AURA API)
Airdrop Detection: Eligible & upcoming airdrops with value estimates
Liquidation Scanning: Health factor monitoring across protocols
Narrative Opportunities: Real-time market trend analysis
Governance Tracking: Proposal detection with voting rewards
π€ AI Strategy Automation
DCA Event-Aware: Dollar-cost averaging with market event detection
Liquidation Guard: Automated position protection
Basket Rotation: Dynamic portfolio rebalancing
Historical backtesting with CAGR, Sharpe ratio, max drawdown
π‘οΈ Guard Engine (Risk Management)
Max slippage & gas price limits
Allowed DEXes & blocked tokens/protocols
Emergency stop capability
Per-user customizable guardrails
π° x402 Payment Protocol
On-chain payment verification
Per-request monetization
USDC/USDT support
Invoice generation & tracking
π Quick Start
Prerequisites
Node.js 18+
AURA API Key (Get one here)
Git
Installation
Development
Production
Server runs on:
Replit: Port 5000 (auto-configured)
Vercel: Dynamic port (auto-configured)
Local: Port 5000 (default)
βοΈ Configuration
Required Environment Variables
Optional: x402 Payment Configuration
π Integration with LLMs
π― MCP Protocol (Native Integration)
NEW: AURA MCP Server now supports native MCP over HTTP with SSE for real-time two-way communication!
MCP Endpoint: https://mcp-aura.replit.app/mcp
Documentation: MCP_INTEGRATION.md
ChatGPT MCP Connector (Recommended)
Open ChatGPT β Settings β Connectors
Enable Developer mode
Create new connector:
Name:
AURA DeFi
URL:
https://mcp-aura.replit.app/mcp
Use in chat with 15 DeFi tools!
Claude Desktop MCP Connector
Open Settings β Connectors
Add custom connector:
Name:
AURA DeFi
URL:
https://mcp-aura.replit.app/mcp
See MCP_INTEGRATION.md for complete guide.
Claude Desktop (MCP Native)
Edit Claude config:
# macOS/Linux nano ~/Library/Application\ Support/Claude/claude_desktop_config.json # Windows notepad %APPDATA%\Claude\claude_desktop_config.jsonAdd MCP server:
{ "mcpServers": { "aura-mcp": { "command": "node", "args": ["path/to/aura-mcp-server/dist/index.js"], "env": { "AURA_API_KEY": "your_api_key_here" } } } }Restart Claude Desktop
ChatGPT (Custom GPT via HTTP API)
Deploy server to Vercel/Replit (see Deployment section)
Create Custom GPT in ChatGPT
Add Actions with your server URL
Import OpenAPI spec from
/api/openapi.json
π Usage Examples
Swap Execution
Portfolio Analysis
Opportunity Scanning
AI Strategy Automation
π Deployment
Deploy to Vercel (Recommended)
Option 1: One-Click Deploy
Option 2: Vercel CLI
Option 3: GitHub Integration
Push to GitHub
Import repository at vercel.com/new
Add
AURA_API_KEY
in Environment VariablesDeploy
π Detailed Guide: See VERCEL_DEPLOY.md
Deploy to Replit
Import GitHub repository to Replit
Add
AURA_API_KEY
to Replit SecretsClick Run (auto-configured on port 5000)
Deploy to Railway
ποΈ Architecture
Tech Stack
Runtime: Node.js 18+ with TypeScript
Framework: Fastify (HTTP), MCP SDK (stdio)
Validation: Zod schemas
Testing: Jest with 80%+ coverage
Blockchain: Ethers.js v6
API: AURA API (https://aura.adex.network)
π§ͺ Testing
π Performance
Swap Quote: < 500ms (AURA API aggregation)
Portfolio Analysis: < 2s across chains
Strategy Backtest: < 5s for 90-day window
Throughput: 100+ requests/minute
Uptime: 99.9% SLA (Vercel/Railway)
π Security
β Input validation with Zod schemas
β Guard engine risk management
β Web-based signing (no server-side private keys)
β x402 on-chain payment verification
β Rate limiting & DDoS protection
β Environment variable encryption
π API Reference
MCP Tools
Tool | Description | Input | Output |
| Parse natural language swap intent |
| Parsed swap params |
| Get swap quote with best DEX |
| Quote with route |
| Prepare swap transaction |
| Transaction data |
| Execute signed swap |
| Execution result |
| Get wallet balance |
| Token balances |
| Get DeFi positions |
| Positions with health |
| Scan opportunities |
| Opportunity list |
| Propose strategy |
| Strategy proposal |
| Backtest strategy |
| Performance metrics |
| Simulate transaction |
| Simulation result |
| Execute transaction |
| Execution result |
| Set risk rules |
| Confirmation |
| Get trading report |
| PnL & fills |
| Check system health |
| Health status |
HTTP Endpoints
All HTTP endpoints available at /api/*
:
POST /api/swap/parse
- Parse swap intentPOST /api/swap/quote
- Get swap quotePOST /api/swap/prepare
- Prepare swap transactionPOST /api/swap/execute
- Execute swapPOST /api/portfolio/balance
- Get balancePOST /api/portfolio/positions
- Get positionsPOST /api/strategy/propose
- Propose strategyGET /api/health
- Health checkGET /api/system/health
- System status
π€ Contributing
Contributions welcome! Please follow these steps:
Fork the repository
Create feature branch (
git checkout -b feature/amazing-feature
)Commit changes (
git commit -m 'Add amazing feature'
)Push to branch (
git push origin feature/amazing-feature
)Open Pull Request
π AURA API Hackathon
Status: β Production Ready
Key Features Implemented
β 100% Real-time AURA API integration (zero mock data)
β Swap execution with auto-DEX selection (200+ chains, 9M+ tokens)
β AI-powered strategy automation (DCA, liquidation guards)
β Opportunity scanning (airdrops, liquidations, governance)
β x402 payment protocol integration
β Guard engine risk management
β MCP protocol for Claude & ChatGPT
Demo
Live Server: [Your deployed URL]
Documentation: See
replit.md
for technical details
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Support
Documentation: VERCEL_DEPLOY.md
Issues: GitHub Issues
AURA API: https://aura.adex.network
MCP Protocol: https://modelcontextprotocol.io
Built with β€οΈ for the AURA community
Powered by AURA API β’ Model Context Protocol β’ Web3
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables Claude and ChatGPT to interact with AURA API for real-time DeFi portfolio analysis, swap execution, yield opportunities, and automated trading strategies across 200+ blockchain networks. Includes natural language swap parsing, cross-chain portfolio tracking, AI strategy automation, and risk management through guard engines.