@supernova123/defillama-mcp-server 1.0.0 → 1.1.0

package/README.md

@@ -15,7 +15,7 @@ Use it with **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **Continue*
 ## 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
+- **10 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
 
@@ -26,11 +26,12 @@ Use it with **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **Continue*
 | `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_yields` | Get yield/APY data for lending pools and staking, filter by chain / project / min TVL, sort by APY or 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 |
+| `get_token_price` | Get current price for any token by CoinGecko ID, symbol, or chain:address (batch lookups) |
 
 ## Quick Start
 

package/dist/index.js

@@ -198,8 +198,9 @@ server.tool("get_yields", "Get yield/APY data for lending pools and staking acro
     project: z.string().optional().describe("Filter by project (e.g. 'Aave', 'Lido', 'Compound')"),
     min_tvl: z.number().optional().default(1_000_000).describe("Minimum TVL in USD (default $1M)"),
     min_apy: z.number().optional().default(0).describe("Minimum APY % (default 0)"),
+    sort_by: z.enum(["tvl", "apy"]).optional().default("tvl").describe("Sort by 'tvl' (default) or 'apy' (highest APY first)"),
     limit: z.number().optional().default(20).describe("Max results (default 20)"),
-}, async ({ chain, project, min_tvl, min_apy, limit }) => {
+}, async ({ chain, project, min_tvl, min_apy, sort_by, limit }) => {
     try {
         const data = await rateLimitedFetch(`${YIELDS_BASE}/pools`);
         if (!data || !Array.isArray(data.data)) {
@@ -221,7 +222,11 @@ server.tool("get_yields", "Get yield/APY data for lending pools and staking acro
                 return false;
             return true;
         })
-            .sort((a, b) => (b.tvlUsd || 0) - (a.tvlUsd || 0))
+            .sort((a, b) => {
+            if (sort_by === "apy")
+                return (b.apy || 0) - (a.apy || 0);
+            return (b.tvlUsd || 0) - (a.tvlUsd || 0);
+        })
             .slice(0, limit);
         if (matches.length === 0) {
             return { content: [{ type: "text", text: `No yield pools matched (chain: ${chain || "any"}, project: ${project || "any"}, min TVL $${min_tvl.toLocaleString()}, min APY ${min_apy}%).` }] };
@@ -401,6 +406,42 @@ server.tool("get_protocol_fees", "Get protocol fee and revenue data — protocol
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
     }
 });
+// ── Tool: get_token_price ──
+server.tool("get_token_price", "Get current price for any token by CoinGecko ID, symbol, or chain:address format. Supports batch lookups.", {
+    tokens: z.array(z.string()).describe("Token identifiers — CoinGecko IDs (e.g. 'ethereum', 'bitcoin'), symbols (e.g. 'ETH', 'BTC'), or chain:address (e.g. 'ethereum:0x...')"),
+}, async ({ tokens }) => {
+    try {
+        // DeFi Llama prices API uses "coingecko:id" or "chain:address" format
+        const coinIds = tokens.map((t) => {
+            if (t.includes(":"))
+                return t; // Already chain:address format
+            // Treat as CoinGecko ID or symbol
+            if (t.startsWith("0x"))
+                return `ethereum:${t}`;
+            return `coingecko:${t.toLowerCase()}`;
+        });
+        const url = `https://coins.llama.fi/prices/current/${coinIds.join(",")}`;
+        const data = await rateLimitedFetch(url);
+        if (!data || !data.coins) {
+            return { content: [{ type: "text", text: "No price data returned." }] };
+        }
+        const lines = Object.entries(data.coins).map(([id, info]) => {
+            const price = info.price != null ? `$${info.price.toLocaleString(undefined, { minimumFractionDigits: 2, maximumFractionDigits: 6 })}` : "N/A";
+            const symbol = info.symbol || "?";
+            const confidence = info.confidence != null ? ` (${Math.round(info.confidence * 100)}% conf)` : "";
+            return `- **${symbol}** (${id}) — ${price}${confidence}`;
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Token Prices:**\n\n${lines.join("\n")}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
 // Start server
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova123/defillama-mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for DeFi Llama \u2014 free DeFi TVL, yields, stablecoins, bridges, DEX, and fee data for AI assistants",
   "type": "module",
   "main": "dist/index.js",
@@ -48,4 +48,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/server.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.friendlygeorge/defillama-mcp-server",
+  "description": "MCP server for DeFi Llama \u2014 free DeFi TVL, yields, stablecoins, bridges, DEX, and fee data for AI...",
+  "repository": {
+    "url": "https://github.com/friendlygeorge/defillama-mcp-server",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@supernova123/defillama-mcp-server",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "description": "Your API key for the service",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true,
+          "name": "YOUR_API_KEY"
+        }
+      ]
+    }
+  ]
+}

package/src/index.ts

@@ -236,9 +236,10 @@ server.tool(
     project: z.string().optional().describe("Filter by project (e.g. 'Aave', 'Lido', 'Compound')"),
     min_tvl: z.number().optional().default(1_000_000).describe("Minimum TVL in USD (default $1M)"),
     min_apy: z.number().optional().default(0).describe("Minimum APY % (default 0)"),
+    sort_by: z.enum(["tvl", "apy"]).optional().default("tvl").describe("Sort by 'tvl' (default) or 'apy' (highest APY first)"),
     limit: z.number().optional().default(20).describe("Max results (default 20)"),
   },
-  async ({ chain, project, min_tvl, min_apy, limit }) => {
+  async ({ chain, project, min_tvl, min_apy, sort_by, limit }) => {
     try {
       const data = await rateLimitedFetch(`${YIELDS_BASE}/pools`);
       if (!data || !Array.isArray(data.data)) {
@@ -257,7 +258,10 @@ server.tool(
           if (projectFilter && !(p.project || "").toLowerCase().includes(projectFilter)) return false;
           return true;
         })
-        .sort((a: any, b: any) => (b.tvlUsd || 0) - (a.tvlUsd || 0))
+        .sort((a: any, b: any) => {
+          if (sort_by === "apy") return (b.apy || 0) - (a.apy || 0);
+          return (b.tvlUsd || 0) - (a.tvlUsd || 0);
+        })
         .slice(0, limit);
 
       if (matches.length === 0) {
@@ -472,6 +476,49 @@ server.tool(
   }
 );
 
+// ── Tool: get_token_price ──
+server.tool(
+  "get_token_price",
+  "Get current price for any token by CoinGecko ID, symbol, or chain:address format. Supports batch lookups.",
+  {
+    tokens: z.array(z.string()).describe("Token identifiers — CoinGecko IDs (e.g. 'ethereum', 'bitcoin'), symbols (e.g. 'ETH', 'BTC'), or chain:address (e.g. 'ethereum:0x...')"),
+  },
+  async ({ tokens }) => {
+    try {
+      // DeFi Llama prices API uses "coingecko:id" or "chain:address" format
+      const coinIds = tokens.map((t: string) => {
+        if (t.includes(":")) return t; // Already chain:address format
+        // Treat as CoinGecko ID or symbol
+        if (t.startsWith("0x")) return `ethereum:${t}`;
+        return `coingecko:${t.toLowerCase()}`;
+      });
+
+      const url = `https://coins.llama.fi/prices/current/${coinIds.join(",")}`;
+      const data = await rateLimitedFetch(url);
+
+      if (!data || !data.coins) {
+        return { content: [{ type: "text" as const, text: "No price data returned." }] };
+      }
+
+      const lines = Object.entries(data.coins).map(([id, info]: [string, any]) => {
+        const price = info.price != null ? `$${info.price.toLocaleString(undefined, { minimumFractionDigits: 2, maximumFractionDigits: 6 })}` : "N/A";
+        const symbol = info.symbol || "?";
+        const confidence = info.confidence != null ? ` (${Math.round(info.confidence * 100)}% conf)` : "";
+        return `- **${symbol}** (${id}) — ${price}${confidence}`;
+      });
+
+      return {
+        content: [{
+          type: "text" as const,
+          text: `**Token Prices:**\n\n${lines.join("\n")}`,
+        }],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
 // Start server
 async function main() {
   const transport = new StdioServerTransport();