defillama-mcp-server

DeFi Llama MCP Server

An MCP server for DeFi Llama — connect any MCP-compatible client to free DeFi protocol data.

What is this?

An MCP (Model Context Protocol) server that gives AI assistants and agents access to DeFi Llama's free DeFi data API — protocol TVL, chain TVL, yield pools, stablecoins, cross-chain bridges, DEX volumes, and protocol fees — through natural language.

Use it with Claude Desktop, Cursor, Windsurf, Cline, Continue, or any MCP-compatible client to ask questions about DeFi protocols, track TVL movements, compare yields, and explore the on-chain economy.

Why use this?

• No API key required — DeFi Llama is a free public API
• 8 built-in tools — covers the most common DeFi data queries
• Clean markdown output — results read naturally in chat
• Rate-limited automatically — polite 500ms throttle across all endpoints

Tools

Tool	Description
search_protocols	Search DeFi protocols by name — returns top results with TVL, chains, category
get_protocol_tvl	Get detailed TVL breakdown for a specific protocol (chain distribution, history, description)
get_tvl_by_chain	Get total TVL for a specific chain (Ethereum, Arbitrum, Base, Solana, etc.)
get_yields	Get yield/APY data for lending pools and staking, filter by chain / project / min TVL
get_stablecoins	Get stablecoin market cap data and rankings
get_bridges	Get cross-chain bridge TVL and volume data
get_dex_volumes	Get DEX trading volumes across chains
get_protocol_fees	Get protocol fee and revenue data

Quick Start

1. Install

npm install -g defillama-mcp-server

Or run directly with npx:

npx -y defillama-mcp-server

2. Configure your MCP client

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "defillama": {
      "command": "npx",
      "args": ["-y", "defillama-mcp-server"]
    }
  }
}

Or with global install:

{
  "mcpServers": {
    "defillama": {
      "command": "defillama-mcp-server"
    }
  }
}

3. Use it

Ask your AI assistant things like:

• "What are the top DeFi protocols by TVL on Ethereum?"
• "Search for Aave and show me the chain breakdown"
• "What's the total TVL on Arbitrum?"
• "Show me the highest yield stablecoin pools on Base with at least $10M TVL"
• "List the top 5 stablecoins by market cap"
• "Which bridges have the most TVL?"
• "Show me DEX trading volumes for the last 24h"
• "What are the protocols with the most fees?"

Example Output

search_protocols

Top 5 protocols matching "aave" (by TVL):

- **Aave** (AAVE) — TVL: $12.45B | Category: Lending | Chains: Ethereum, Arbitrum, Polygon, Base, Optimism, +6 | Slug: `aave`
- **Aave v2** (AAVE) — TVL: $4.20B | Category: Lending | Chains: Ethereum, Polygon, Avalanche | Slug: `aave-v2`
- **Aave v3** (AAVE) — TVL: $8.10B | Category: Lending | Chains: Ethereum, Arbitrum, Polygon, Base, Optimism | Slug: `aave-v3`

get_yields

Top 5 yield pools (chain: Ethereum | min TVL: $10.00M | min APY: 0%):

- **Lido** — stETH on Ethereum 🟢 | APY: 3.42% (3.42% base) | TVL: $23.45B
- **Aave v3** — USDC on Ethereum 🟢 | APY: 4.85% (1.50% base + 3.35% reward) | TVL: $1.85B
- **Compound v3** — USDC on Ethereum 🟢 | APY: 5.12% (3.20% base + 1.92% reward) | TVL: $890.45M

get_tvl_by_chain

Ethereum — Chain TVL

- **Total TVL:** $115.32B
- **Native Token:** ETH
- **CoinGecko ID:** ethereum

### Top Tokens by TVL
- **ETH** (Ether): $67.23B
- **USDC** (USD Coin): $4.12B
- **USDT** (Tether): $3.45B
- **WBTC** (Wrapped BTC): $2.89B
- **WSTETH** (Wrapped stETH): $2.34B

Requirements

• Node.js 18+
• No API key needed (DeFi Llama is a free public API)

Rate Limits

DeFi Llama doesn't publish hard rate limits, but the server automatically throttles requests to ~2 calls/second (500ms minimum interval) to be a polite citizen. The /protocols and /pools endpoints are large (multi-MB), so the throttle also helps avoid unnecessary load.

Data Sources

• Protocols & TVL: https://api.llama.fi
• Yields: https://yields.llama.fi
• Stablecoins: https://stablecoins.llama.fi

All endpoints are free and require no authentication. Full API documentation: https://defillama.com/docs/api

Development

git clone https://github.com/nova/defillama-mcp-server.git
cd defillama-mcp-server
npm install
npm run build
npm start

License

MIT