Alertio MCP Server

Alertio MCP Server

Real-time DeFi risk intelligence for AI agents. Scan lending positions across EVM, Solana, and TON chains, simulate liquidations, calculate health factors for hypothetical positions, monitor stablecoin pegs, inspect market utilization, and track perpetual funding rates — no API key required.

Connection

Listed in the official MCP Registry as io.alertio/alertio.

Streamable HTTP (recommended)

{
  "alertio": {
    "url": "https://www.alertio.io/api/mcp"
  }
}

SSE / stdio-only clients (older Claude Desktop)

{
  "alertio": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://www.alertio.io/api/mcp"]
  }
}

Tools

scan_wallet

Scans an EVM wallet address across all supported lending protocols and returns every active borrowing position with health factors and liquidation risk.

Supported protocols

Parameters

Risk levels

Example output

Lending positions for 0xabc...1234

AAVE V3
  ethereum: HF 2.45 · $18K collateral · $7K debt [SAFE]
  base: HF 1.28 · $5K collateral · $3.8K debt [DANGER]

AAVE V4
  No active positions.

SPARK
  No active positions.

MORPHO
  ethereum wstETH/USDC: HF 1.84 · $42K collateral · $22K debt [AT RISK]

EULER V2
  No active positions.

MOONWELL
  Base: HF 1.61 · $3.2K debt [SAFE]

Total active positions: 3

---

scan_solana_wallet

Scans a Solana wallet address for Kamino lending positions.

Supported protocols

Parameters

Example output

Solana lending positions for 7xKX...AbCD

KAMINO
  Solana: HF 1.72 · $12K collateral · $6K debt [AT RISK]

Total active positions: 1

---

scan_ton_wallet

Scans a TON wallet address on the EVAA lending protocol.

Supported protocols

Parameters

Example output

TON lending positions for EQD...wxYZ

EVAA
  TON: HF 2.10 · $8K collateral · $3K debt [SAFE]

Total active positions: 1

---

simulate_liquidation

Simulates the impact of a collateral price drop on all active EVM positions (Aave V3/V4, Spark, Morpho, Euler V2, Moonwell). Identifies which positions would be liquidated and which move into a higher risk tier.

Formula: newHF = currentHF × (1 − drop%)

Assumes all collateral moves uniformly with the price drop. Conservative estimate when collateral is a mix of volatile and stable assets.

Parameters

Example output

Liquidation simulation for 0xabc...1234
Scenario: collateral drops 30%

  Aave V3 (ethereum): 2.45 → 1.72 [AT RISK] ← was SAFE
  Aave V3 (base): 1.28 → 0.90 [LIQUIDATED] ← was DANGER
  Morpho wstETH/USDC: 1.84 → 1.29 [DANGER] ← was AT RISK
  Moonwell (Base): 1.61 → 1.13 [DANGER] ← was SAFE

△ 2 position(s) at risk at -30%
⚠ 1 position(s) LIQUIDATED at -30%

---

calculate_health_factor

Calculates a health factor from position inputs — no wallet, no chain, no on-chain lookup. Takes one or more collateral legs, each with its own liquidation threshold, plus the debt, and returns the health factor, the blended threshold, the collateral drop that would trigger liquidation, and the collateral value at which liquidation begins. Optionally simulates a collateral price drop and a move in the borrowed asset's price.

Unlike simulate_liquidation, this needs no existing position — use it for hypotheticals ("if I supplied 5 ETH and borrowed $6,500…"), for sizing a borrow before opening it, or for working through a position someone describes in conversation.

It is also the only tool here that calls no upstream service, so it has no rate-limit exposure and cannot be affected by an outage.

Formula: HF = (Σ collateral value × liquidation threshold) ÷ debt

Per-asset thresholds are applied to each leg, then summed — matching how protocols compute a blended threshold across mixed collateral.

Parameters

Example output

Health factor calculation

  wBTC: $120,000 × 70% = $84,000
  ETH: $30,000 × 80% = $24,000
  ─ blended threshold: $108,000 ÷ $150,000 = 72.00%
  risk-adjusted collateral: $108,000
  debt: $60,000

  health factor = $108,000 ÷ $60,000 = 1.80 [AT RISK]
  collateral can fall 44.44% before liquidation
  liquidation begins at $83,333.33 of collateral

  Simulated (collateral -45%): 0.99 [LIQUIDATED]
  ⚠ This position would be liquidatable.

With no debt, healthFactor is null rather than infinity — there is no liquidation point to report.

---

get_stablecoin_pegs

Returns current USD peg data for the top 15 stablecoins (USDT, USDC, DAI, FRAX, crvUSD, USDS, GHO, and more) sourced from DeFiLlama. Flags any deviation above 0.5% as a depeg signal.

Parameters

Example output

Stablecoin peg status (USD target = $1.00)

  USDT     $1.0001  (+0.010%) · mcap $143.2B
  USDC     $1.0000  (+0.000%) · mcap $61.4B
  DAI      $0.9998  (-0.020%) · mcap $5.1B
  FRAX     $0.9971  (-0.290%) · mcap $643M  △ watch
  crvUSD   $0.9942  (-0.580%) · mcap $89M   ⚠ DEPEG

⚠ crvUSD showing depeg signal (>0.5% deviation)

---

get_market_utilization

Returns Aave V3 lending market utilization rates, borrow APY, and supply APY across 7 chains. High utilization above the optimal rate causes borrow APY to spike sharply. Also shows whether a market is frozen or paused.

Parameters

Example output

Aave V3 market utilization

  Asset     Chain       Util%   Optimal  Borrow APY  Supply APY  Status
  ─────────────────────────────────────────────────────────────────────
  USDC      ethereum    94.2%      90%      12.40%       9.80%  HIGH UTIL △
  USDT      arbitrum    87.3%      90%       5.10%       3.90%  OK
  WETH      base        42.1%      80%       2.30%       0.90%  OK

△ Above optimal utilization: USDC (ethereum) 94.2%

---

Resources

Live market snapshots — readable without wallet addresses, updated on every read.

---

Prompts

Pre-built prompt templates available as slash commands in supporting clients (Claude Desktop, etc.).

---

Example agent queries

EVM wallets

• "Is 0xabc…1234 at risk of liquidation on Aave or Morpho?"
• "Show all lending positions for 0x…1234"
• "What happens to 0x…1234's positions if ETH drops 40%?"
• "Which of these wallets is closest to liquidation: 0xaaa…, 0xbbb…?"
• "Does 0x…1234 have any Moonwell borrows on Base?"

Hypothetical positions (no wallet needed)

• "If I supply 5 ETH at $2,000 with an 80% liquidation threshold and borrow $6,500 USDC, what's my health factor?"
• "How far can ETH fall before that position gets liquidated?"
• "How much can I borrow against 10 ETH at 82.5% and still keep a health factor of 2?"
• "I have 2 wBTC at 70% and 10 ETH at 80% backing $60,000 of debt — what's my blended threshold?"
• "What happens to my health factor if I borrowed ETH instead of USDC and ETH rallies 20%?"

Solana wallets

• "Check Kamino health for 7xKX…AbCD"
• "Is this Solana wallet at risk of liquidation on Kamino?"

TON wallets

• "What's the EVAA health factor for EQD…wxYZ?"

Stablecoins

• "Is USDC currently depegged?"
• "Which stablecoins are showing depeg signals right now?"

Markets

• "What's the USDC utilization on Aave Ethereum — is there room to borrow?"
• "Are any Aave markets frozen or above optimal utilization?"
• "What are the current BTC and ETH funding rates on Binance?"
• "Show me the Morpho vault with the best APY right now"
• "What's the open interest change for ETH in the last hour?"

---

Testing with MCP Inspector

npx @modelcontextprotocol/inspector

Open the URL it prints, set transport to Streamable HTTP with connection type Proxy, paste https://www.alertio.io/api/mcp, and click Connect.

---

Authentication

No API key required. Rate limited per IP.

Built on

alertio.io — real-time DeFi monitoring and alerts across EVM, Solana, and TON.