DeFi Yields MCP

1# DeFi Yields MCP
2 
3An MCP server for AI agents to explore DeFi yield opportunities, powered by DefiLlama.
4 
5[![Discord](https://img.shields.io/discord/1353556181251133481?cacheSeconds=3600)](https://discord.gg/aRnuu2eJ)
6![GitHub License](https://img.shields.io/github/license/kukapay/defi-yields-mcp)
7![Python Version](https://img.shields.io/badge/python-3.10+-blue)
8![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
9 
10## Features
11 
12- **Data Fetching Tool**: The `get_yield_pools` tool retrieves DeFi yield pool data from the DefiLlama, allowing filtering by chain (e.g., Ethereum, Solana) or project (e.g., Lido, Aave).
13- **Analysis Prompt**: The `analyze_yields` prompt generates tailored instructions for AI agents to analyze yield pool data, focusing on key metrics like APY, 30-day mean APY, and predictions.
14- **Packaged for Ease**: Run the server directly with `uvx defi-yields-mcp`.
15 
16## Installation
17 
18To use the server with Claude Desktop, you can either install it automatically or manually configure the Claude Desktop configuration file.
19 
20### Option 1: Automatic Installation
21Install the server for Claude Desktop:
22```bash
23uvx mcp install -m defi_yields_mcp --name "DeFi Yields Server"
24```
25 
26### Option 2: Manual Configuration
27 
28 
29Locate the configuration file:
30- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
31- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
32 
33Add the server configuration:
34 
35```json
36{
37 "mcpServers": {
38   "defi-yields-mcp": {
39     "command": "uvx",
40     "args": [ "defi-yields-mcp" ]
41   }
42 }
43}
44```
45 
46Restart Claude Desktop.
47 
48## Examples
49 
50You can use commands like:
51 
52- "Fetch yield pools for the Lido project."
53- "Analyze yield pools on Ethereum."
54- "What are the 30-day mean APYs for Solana pools?"
55 
56The `get_yield_pools` tool fetches and filters the data, while the `analyze_yields` prompt guides the LLM to provide a detailed analysis.
57 
58### Example Output
59 
60Running the `get_yield_pools` tool with a filter for Ethereum:
61```json
62[
63  {
64    "chain": "Ethereum",
65    "pool": "STETH",
66    "project": "lido",
67    "tvlUsd": 14804019222,
68    "apy": 2.722,
69    "apyMean30d": 3.00669,
70    "predictions": {
71        "predictedClass": "Stable/Up",
72        "predictedProbability": 75,
73        "binnedConfidence": 3      
74    }
75  },
76  ...
77]
78```
79 
80## License
81 
82This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
83