demcp/demcp-defillama-mcp

## Overview
DeFiLlama MCP is a powerful and flexible tool that provides a microservice-based API wrapper around the DeFi Llama ecosystem. It leverages the FastMCP framework to transform DeFi Llama's comprehensive DeFi data into easily accessible tool endpoints that can be integrated with various AI applications, including LLM agents and autonomous systems.
This project serves as a bridge between the rich data sources provided by DeFi Llama and the emerging needs of AI-driven applications in the Web3 space. By wrapping DeFi Llama's APIs in a standardized MCP (Microservice Communication Protocol) format, developers can quickly integrate real-time DeFi data into their AI systems without dealing with the complexities of direct API integration.
## Features
Protocol Data Access: Retrieve comprehensive information about DeFi protocols including TVL (Total Value Locked) metrics.
Blockchain Analytics: Access historical TVL data for specific blockchains to analyze trends and growth patterns.
Token Price Tracking: Fetch current price information for various tokens across multiple chains.
Liquidity Pool Data: Get detailed insights into liquidity pools, including TVL and other critical metrics.
Standardized Interface: All data is accessible through a consistent API pattern, making it easy to integrate with AI systems.
Docker Support: Ready-to-deploy containerization for easy implementation in any environment.
Server-Sent Events: Real-time data updates using SSE transport mechanism.
## Architecture
DeFiLlama MCP is built using a modular architecture that separates the data-fetching logic from the API interface. The core components include:
1. API Clients: Specialized HTTP clients for each of DeFi Llama's API endpoints (Main, Coins, Yields).
2. MCP Tools: Function-based tools that transform raw API responses into structured data for consumption by AI agents.
3. FastMCP Server: A lightweight server that exposes the tools via HTTP and SSE (Server-Sent Events).
4. Error Handling: Robust error management to ensure reliability even when upstream services experience issues.
## Installation
### Prerequisites
Python 3.13 or higher
uv (Python package installer and environment manager)
### Option 1: Local Installation
bash
# Clone the repository
git clone https://github.com/demcp/defillama-mcp.git
cd defillama-mcp
# Create a virtual environment and install dependencies
uv venv
uv pip install -e .
# Run the server
uv run defillama.py
### Option 2: Docker Installation
bash
# Clone the repository
git clone https://github.com/demcp/defillama-mcp.git
cd defillama-mcp
# Build the Docker image
docker build -t defillama-mcp .
# Run the container
docker run -p 8080:8080 defillama-mcp
## Usage
Once the server is running, it exposes several endpoints that can be used to interact with DeFi Llama data:
### Available Tools
getprotocols: Retrieve information about top DeFi protocols.
getprotocoltvl: Get TVL data for a specific protocol.
getchaintvl: Access historical TVL data for a specific blockchain.
gettokenprices: Obtain current price information for specific tokens.
getpools: List available liquidity pools.
getpooltvl: Get detailed information about a specific liquidity pool.