@supernova123/defillama-mcp-server
Advanced tools
MCP server for DeFi Llama — TVL, yields, stablecoins, bridges, DEX data, and protocol analytics for Claude, Cursor, and AI agents
An MCP server for DeFi Llama — connect any MCP-compatible client to free DeFi protocol data.
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.
| 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 |
Add this to your MCP client config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"defillama": {
"command": "npx",
"args": ["-y", "defillama-mcp-server"]
}
}
}
That's it. npx downloads and runs it automatically. No API key, no install step.
Ask your AI assistant things like:
search_protocolsTop 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_yieldsTop 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_chainEthereum — 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
"Search for Aave and show me the chain breakdown" — find protocols, compare TVL across chains, and understand where value is concentrated. Works with any protocol in DeFi Llama's database of 3,000+ projects.
"Show me the highest yield stablecoin pools on Base with at least $10M TVL" — filter yield opportunities by chain, project, minimum TVL, and asset type. Find safe yields without hunting through dashboards.
"What's the total TVL on Arbitrum?" — get chain-level stats including top tokens by TVL. Useful for understanding where liquidity is flowing and which chains are growing.
"List the top 5 stablecoins by market cap" — track stablecoin market caps, circulating supply, and price deviations. Essential for understanding DeFi's dollar-denominated liquidity.
"Which bridges have the most TVL?" — monitor cross-chain bridge activity and volume. Track which bridges are gaining or losing share.
"What are the protocols with the most fees?" — analyze protocol fee generation and revenue. Useful for fundamental analysis and comparing protocol economics.
Use search_protocols first to find the correct DeFi Llama slug. Protocol slugs are lowercase with hyphens (e.g. aave-v3, lido), not ticker symbols.
DeFi Llama's /protocols and /pools endpoints return multi-MB responses. The server throttles to ~2 calls/second. For large queries, results may take 1-2 seconds.
Make sure Node.js 18+ is installed: node --version. If using npx, ensure npm is up to date: npm install -g npm@latest.
Verify the config path is correct. Claude Desktop uses ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows. Restart the client after config changes.
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.
https://api.llama.fihttps://yields.llama.fihttps://stablecoins.llama.fiAll endpoints are free and require no authentication. Full API documentation: https://defillama.com/docs/api
git clone https://github.com/nova/defillama-mcp-server.git
cd defillama-mcp-server
npm install
npm run build
npm start
MIT
FAQs
MCP server for DeFi Llama — TVL, yields, stablecoins, bridges, DEX data, and protocol analytics for Claude, Cursor, and AI agents
We found that @supernova123/defillama-mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
A new federal program will let vetted U.S. cybersecurity firms help investigate and disrupt foreign cybercrime groups under government direction.
Research
/Security News
The campaign amassed more than 75,000 installs by targeting Russian-speaking users seeking access to blocked services.
Company News
Open source maintainers are under more pressure than ever. We're raising our open source program from the Team plan to the Business plan, free.