IQAIcom/mcp-defillama

📊 DefiLlama MCP Server

📖 Overview

The DefiLlama MCP Server enables AI agents to interact with DefiLlama, a comprehensive DeFi data aggregator. This server provides access to TVL metrics, DEX volumes, protocol statistics, stablecoin data, token prices, yield farming pools, and more.

By implementing the Model Context Protocol (MCP), this server allows Large Language Models (LLMs) to discover DeFi protocols, analyze market data, and track blockchain metrics directly through their context window, bridging the gap between AI and decentralized finance analytics.

✨ Features

• Protocol & TVL Data: Access blockchain chains ranked by TVL, protocol TVL data, and historical chain TVL.
• DEX Data: Fetch DEX trading volume data and metrics.
• Fees & Revenue: Retrieve fees and revenue metrics for DeFi protocols.
• Stablecoin Analytics: Access stablecoin data including circulation, price information, and historical charts.
• Token Prices: Fetch current and historical token prices, percentage changes, and price charts.
• Yield Farming: Get current and historical yield farming pool data including APY rates and TVL.
• Options Data: Access options protocol data including trading volume and premium metrics.
• Auto-Resolution: AI-powered entity resolution for protocols, chains, and stablecoins.

📦 Installation

🚀 Using pnpm dlx (Recommended)

To use this server without installing it globally:

pnpm dlx @iqai/defillama-mcp

🔧 Build from Source

git clone https://github.com/IQAIcom/defillama-mcp.git
cd defillama-mcp
pnpm install
pnpm run build

⚡ Running with an MCP Client

Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json).

📋 Minimal Configuration

{
  "mcpServers": {
    "defillama": {
      "command": "pnpm",
      "args": ["dlx", "@iqai/defillama-mcp"],
      "env": {}
    }
  }
}

Basic Configuration (With API Key)

{
  "mcpServers": {
    "defillama": {
      "command": "pnpm",
      "args": ["dlx", "@iqai/defillama-mcp"],
      "env": {
        "DEFILLAMA_API_KEY": "your_defillama_api_key_here"
      }
    }
  }
}

Advanced Configuration (With IQ Gateway)

{
  "mcpServers": {
    "defillama": {
      "command": "pnpm",
      "args": ["dlx", "@iqai/defillama-mcp"],
      "env": {
        "IQ_GATEWAY_URL": "your_iq_gateway_url",
        "IQ_GATEWAY_KEY": "your_iq_gateway_key",
        "OPENROUTER_API_KEY": "your_openrouter_api_key_if_needed",
        "LLM_MODEL": "openai/gpt-4.1-mini"
      }
    }
  }
}

🔐 Configuration (Environment Variables)

💡 Usage Examples

Protocol & TVL Data

• "What are the top 10 DeFi protocols by TVL?"
• "Show me the historical TVL for Ethereum."
• "Get TVL data for Uniswap."

DEX Data

• "What are the top DEXs by trading volume?"
• "Show me DEX volume data for Arbitrum."

Stablecoin Analytics

• "What is the current market cap of USDC?"
• "Show me stablecoin distribution across chains."
• "Get historical price data for Tether."

Token Prices

• "What is the current price of ETH?"
• "Show me the 24h price change for BTC."
• "Get historical prices for multiple tokens."

Yield Farming

• "What are the highest APY yield farming pools?"
• "Show me pool data for Aave on Ethereum."

🛠️ MCP Tools

defillama_get_batch_historical

Fetches historical price data for multiple cryptocurrencies at specific timestamps. Useful for getting prices of multiple coins at the same or different points in time

defillama_get_blockchain_timestamp

Fetches blockchain block information for a specific chain at a given timestamp. Returns the block number, timestamp, and height that existed at that point in time. This is essential for historical DeFi queries - many blockchain APIs require a specific block number to retrieve historical state (e.g., 'What was the TVL on date X?' requires knowing which block number corresponded to date X). Use this tool to convert human-readable dates into block numbers. AUTO-RESOLUTION ENABLED: Chain names are automatically matched.

defillama_get_chains

Fetches blockchain chains ranked by Total Value Locked (TVL), returning the top 20. Use this tool to: (1) answer user queries about leading DeFi blockchains, or (2) discover valid chain name formats before calling other tools. The returned chain names (e.g., 'Ethereum', 'Arbitrum', 'Polygon') can be used directly in the 'chain' parameter of defillama_get_dexs_data, defillama_get_fees_and_revenue, and defillama_get_historical_chain_tvl

defillama_get_chart_coins

Fetches historical price chart data for one or more cryptocurrency tokens across different blockchains. Returns time-series price data with customizable time range and data point frequency

defillama_get_dexs_data

Fetches DEX (decentralized exchange) trading volume data and metrics. Returns different levels of data based on parameters: specific protocol data (most detailed), chain-specific overview, or global overview (all DEXs). AUTO-RESOLUTION ENABLED: Protocol and chain names are automatically matched.

defillama_get_fees_and_revenue

Fetches fees and revenue metrics for DeFi protocols. Can filter by specific protocol and/or chain. AUTO-RESOLUTION ENABLED: Protocol and chain names are automatically matched.

defillama_get_historical_chain_tvl

Fetches historical TVL (Total Value Locked) data for blockchain chains over time. Returns the last 10 data points showing TVL evolution. Can return data for a specific chain or aggregated data across all chains. AUTO-RESOLUTION ENABLED: Chain names are automatically matched (e.g., 'Ethereum', 'BSC', 'Polygon', 'Avalanche').

defillama_get_historical_pool_data

Fetches historical APY and TVL data for a specific yield farming pool over time. Returns the last 10 data points showing how the pool's metrics have changed

defillama_get_historical_prices_by_contract

Fetches historical prices for tokens at a specific point in time using their contract addresses. Useful for getting price data at exact timestamps for analysis or backtesting

defillama_get_latest_pool_data

Fetches current yield farming pool data including APY rates, TVL, and rewards. Returns a list of pools that can be filtered and sorted by various metrics

defillama_get_options_data

Fetches options protocol data including trading volume and premium metrics. Returns different levels of data: specific protocol data (most detailed), chain-specific overview, or global overview (all options protocols). AUTO-RESOLUTION ENABLED: Protocol and chain names are automatically matched.

defillama_get_percentage_coins

Fetches percentage price change for tokens over a specified time period. Calculates how much token prices changed from a starting point, either looking backward (default) or forward in time

defillama_get_prices_current_coins

Fetches current token prices from DefiLlama. Requires token addresses in the format chain:address (e.g., 'ethereum:0xdac17f958d2ee523a2206206994597c13d831ec7' for USDT). Can fetch multiple tokens at once by comma-separating them

defillama_get_prices_first_coins

Fetches the first recorded historical prices for specified cryptocurrency tokens. Useful for finding when a token was first listed/tracked or its initial price point

defillama_get_protocol_data

Fetches TVL (Total Value Locked) data for DeFi protocols. AUTO-RESOLUTION ENABLED: Pass protocol names as users mention them (e.g., 'Lido', 'Uniswap', 'Aave', 'MakerDAO') - they're automatically resolved to correct slugs via AI. For multiple versions, specify the version (e.g., 'Aave V3') or the most common version is matched. If protocol parameter is omitted, returns top 10 protocols sorted by your chosen criteria.

defillama_get_stablecoin

Fetches stablecoin data including circulation and price information. Returns top 20 stablecoins

defillama_get_stablecoin_chains

Fetches stablecoin data by chains. Returns last 3 chains with market cap data

No parameters

defillama_get_stablecoin_charts

Fetches historical market cap charts for stablecoins over time. Returns the last 10 data points showing circulation, USD values, and bridged amounts. Can filter by blockchain or specific stablecoin, or show global aggregated data

defillama_get_stablecoin_prices

Fetches historical stablecoin price data. Returns last 3 data points

No parameters

👨‍💻 Development

Build Project

pnpm run build

Development Mode (Watch)

pnpm run watch

Linting & Formatting

pnpm run lint
pnpm run format

Release Management

pnpm changeset          # Create a release note
pnpm version-packages   # Apply pending changesets
pnpm release            # Build and publish

Project Structure

• src/tools/: Individual tool definitions
• src/services/: API client and business logic
• src/lib/: Shared utilities
• src/index.ts: Server entry point

📚 Resources

• DefiLlama API Documentation
• Model Context Protocol (MCP)
• DefiLlama Platform

⚠️ Disclaimer

This project is an unofficial tool and is not directly affiliated with DefiLlama. It interacts with DeFi protocol data. Users should exercise caution and verify all data independently. DeFi involves risk.

📄 License