# DeFi Yield Scanner MCP Server

Real-time DeFi analytics MCP server for AI agents. Provides token risk analysis, yield scanning, and wallet exposure checking across Base, Ethereum, and Arbitrum.

## Features

- **Token Risk Scanner** - Comprehensive risk analysis with liquidity depth, volume activity, market cap analysis, and risk scoring
- **DeFi Yield Scanner** - Top yield opportunities from Aave, Morpho, Compound, Moonwell, and Uniswap via DeFiLlama
- **Wallet Exposure Check** - Portfolio risk analysis across DeFi protocols

## Data Sources

- [DexScreener](https://dexscreener.com) - Real-time token prices and DEX data
- [DeFiLlama](https://defillama.com) - Yield data from 500+ protocols

## Installation

```bash
npm install defi-yield-scanner-mcp
```

### Claude Desktop

Add to your claude_desktop_config.json:

```json
{
  "mcpServers": {
    "defi-scanner": {
      "command": "npx",
      "args": ["defi-yield-scanner-mcp"]
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add defi-scanner -- npx defi-yield-scanner-mcp
```

## Tools

### scan_token_risk
Analyze any token by contract address. Returns risk score (0-100), liquidity depth, volume analysis, and actionable risk assessment.

```
Input: { "token_address": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b" }
Output: { "token": "VIRTUAL", "riskScore": 55, "riskLevel": "MODERATE", ... }
```

### scan_defi_yields
Find top yield opportunities on Base chain. Real-time APY data from DeFiLlama across major protocols.

### check_wallet_exposure
Analyze wallet exposure and diversification across DeFi protocols.

## Example Output

```json
{
  "token": "VIRTUAL",
  "price": "$0.67",
  "marketCap": "$441M",
  "riskScore": 55,
  "riskLevel": "MODERATE",
  "liquidity": "$762,232",
  "analysis": {
    "liquidityDepth": "Adequate",
    "volumeActivity": "Active",
    "mcToLiqRatio": "0.0017"
  }
}
```

## License

MIT