@supernova123/defillama-mcp-server 1.0.0

package/.github/FUNDING.yml

@@ -0,0 +1,8 @@
+# These funding sources support Nova MCP Servers
+
+github: [nova]
+# ko_fi: # Replace with a single Ko-fi username
+# patreon: # Replace with a single Patreon username
+# open_collective: # Replace with a single Open Collective username
+# community_bridge: # Replace with a single Community Bridge project name
+# custom: # Replace with up to 4 custom sponsorship URLs e.g., ["link1", "link2"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MARKETPLACE-LISTINGS.md

@@ -0,0 +1,85 @@
+# Marketplace Listings — DeFi Llama MCP Server
+
+## Listing 1: mcp.so
+
+**Title:** DeFi Llama MCP Server
+
+**Category:** Finance & Crypto → DeFi
+
+**Description:**
+MCP server for DeFi Llama — the free DeFi data API powering https://defillama.com. Query protocol TVL, chain TVL, yield pools, stablecoins, bridges, DEX volumes, and protocol fees through natural language. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
+
+Features:
+- Search DeFi protocols by name with TVL, category, and chain info
+- Get detailed TVL breakdown for a specific protocol (chain distribution, history, description)
+- Get total TVL for any chain (Ethereum, Arbitrum, Base, Solana, etc.)
+- Filter yield pools by chain, project, min TVL, and min APY
+- Get stablecoin market caps and rankings
+- Get cross-chain bridge TVL and volume data
+- Get DEX trading volumes across chains
+- Get protocol fee and revenue data
+- No API key required (DeFi Llama is fully free)
+- Automatic rate limiting, clean markdown output
+
+**Tags:** defillama, defi, tvl, yields, stablecoins, bridges, dex, fees, mcp, finance, ethereum, bitcoin, lido, aave, uniswap
+
+**Installation:**
+```bash
+npx -y defillama-mcp-server
+```
+
+---
+
+## Listing 2: Smithery (smithery.ai)
+
+**Title:** DeFi Llama
+
+**Description:**
+Connect AI assistants to DeFi Llama's free DeFi data API. Query protocol TVL, chain TVL, yield/APY pools, stablecoin market caps, cross-chain bridges, DEX volumes, and protocol fees through the Model Context Protocol. No API key required.
+
+**Tools:** 8 (search_protocols, get_protocol_tvl, get_tvl_by_chain, get_yields, get_stablecoins, get_bridges, get_dex_volumes, get_protocol_fees)
+
+**Transport:** stdio
+
+**Config:**
+```json
+{
+  "command": "npx",
+  "args": ["-y", "defillama-mcp-server"]
+}
+```
+
+---
+
+## Listing 3: Glama MCP
+
+**Title:** DeFi Llama MCP Server
+
+**Description:**
+Access DeFi Llama's free DeFi data through MCP. Search protocols, get TVL breakdowns for protocols and chains, filter yield pools, view stablecoin rankings, explore cross-chain bridge TVL, compare DEX volumes, and track protocol fees. Works with Claude Desktop, Cursor, and other MCP clients. No API key needed.
+
+**Category:** Finance
+
+**Tools:** 8
+
+**Tags:** defi, defillama, tvl, yields, stablecoins, bridges, dex, fees, ethereum
+
+---
+
+## Listing 4: There's An AI For That (TAAIFT)
+
+**Title:** DeFi Llama MCP Server
+
+**Category:** Developer Tools → AI Development → MCP Servers
+
+**Description:**
+MCP server that connects AI assistants to DeFi Llama's free DeFi data API. Ask your AI about protocol TVL, chain TVL, yield pools, stablecoins, bridges, DEX volumes, and protocol fees — no API key required. 8 tools covering the most common DeFi queries.
+
+**Price:** Free (open source, MIT)
+
+---
+
+## Listing 5: Awesome MCP Servers (GitHub)
+
+**PR Description:**
+Add DeFi Llama MCP Server — free DeFi data for AI assistants. 8 tools: search protocols, get protocol/chain TVL, filter yield pools, stablecoin rankings, bridge TVL, DEX volumes, protocol fees. No API key required. TypeScript, MIT license, no dependencies beyond MCP SDK + zod.

package/README.md

@@ -0,0 +1,157 @@
+# DeFi Llama MCP Server
+
+> An MCP server for [DeFi Llama](https://defillama.com) — connect any MCP-compatible client to free DeFi protocol data.
+
+[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## What is this?
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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.
+
+## 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
+- **Clean markdown output** — results read naturally in chat
+- **Rate-limited automatically** — polite 500ms throttle across all endpoints
+
+## Tools
+
+| 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 |
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g defillama-mcp-server
+```
+
+Or run directly with npx:
+
+```bash
+npx -y defillama-mcp-server
+```
+
+### 2. Configure your MCP client
+
+Add to your MCP client config (e.g. `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "defillama": {
+      "command": "npx",
+      "args": ["-y", "defillama-mcp-server"]
+    }
+  }
+}
+```
+
+Or with global install:
+
+```json
+{
+  "mcpServers": {
+    "defillama": {
+      "command": "defillama-mcp-server"
+    }
+  }
+}
+```
+
+### 3. Use it
+
+Ask your AI assistant things like:
+
+- "What are the top DeFi protocols by TVL on Ethereum?"
+- "Search for Aave and show me the chain breakdown"
+- "What's the total TVL on Arbitrum?"
+- "Show me the highest yield stablecoin pools on Base with at least $10M TVL"
+- "List the top 5 stablecoins by market cap"
+- "Which bridges have the most TVL?"
+- "Show me DEX trading volumes for the last 24h"
+- "What are the protocols with the most fees?"
+
+## Example Output
+
+### `search_protocols`
+
+```
+Top 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_yields`
+
+```
+Top 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_chain`
+
+```
+Ethereum — 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
+```
+
+## Requirements
+
+- Node.js 18+
+- No API key needed (DeFi Llama is a free public API)
+
+## Rate Limits
+
+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.
+
+## Data Sources
+
+- **Protocols & TVL:** `https://api.llama.fi`
+- **Yields:** `https://yields.llama.fi`
+- **Stablecoins:** `https://stablecoins.llama.fi`
+
+All endpoints are free and require no authentication. Full API documentation: https://defillama.com/docs/api
+
+## Development
+
+```bash
+git clone https://github.com/nova/defillama-mcp-server.git
+cd defillama-mcp-server
+npm install
+npm run build
+npm start
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * DeFi Llama MCP Server
+ *
+ * Connect AI assistants to DeFi Llama's free DeFi data API.
+ * Query protocol TVL, chain TVL, yields, stablecoins, bridges,
+ * DEX volumes, and protocol fees through the Model Context Protocol.
+ *
+ * Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP client.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,413 @@
+#!/usr/bin/env node
+/**
+ * DeFi Llama MCP Server
+ *
+ * Connect AI assistants to DeFi Llama's free DeFi data API.
+ * Query protocol TVL, chain TVL, yields, stablecoins, bridges,
+ * DEX volumes, and protocol fees through the Model Context Protocol.
+ *
+ * Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP client.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const LLAMA_BASE = "https://api.llama.fi";
+const YIELDS_BASE = "https://yields.llama.fi";
+const STABLECOINS_BASE = "https://stablecoins.llama.fi";
+// Rate limiter: DeFi Llama doesn't publish hard limits, but be polite.
+// ~500ms between calls is safe and well below any reasonable limit.
+let lastCall = 0;
+const MIN_INTERVAL = 500;
+async function rateLimitedFetch(url) {
+    const now = Date.now();
+    const wait = MIN_INTERVAL - (now - lastCall);
+    if (wait > 0) {
+        await new Promise((r) => setTimeout(r, wait));
+    }
+    lastCall = Date.now();
+    const res = await fetch(url, {
+        headers: { Accept: "application/json" },
+    });
+    if (!res.ok) {
+        throw new Error(`DeFi Llama API error: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+}
+function formatTVL(value) {
+    if (value == null || isNaN(value))
+        return "N/A";
+    if (value >= 1e12)
+        return `$${(value / 1e12).toFixed(2)}T`;
+    if (value >= 1e9)
+        return `$${(value / 1e9).toFixed(2)}B`;
+    if (value >= 1e6)
+        return `$${(value / 1e6).toFixed(2)}M`;
+    if (value >= 1e3)
+        return `$${(value / 1e3).toFixed(2)}K`;
+    return `$${value.toFixed(2)}`;
+}
+function formatPct(value) {
+    if (value == null || isNaN(value))
+        return "N/A";
+    return `${value >= 0 ? "+" : ""}${value.toFixed(2)}%`;
+}
+// Create server
+const server = new McpServer({
+    name: "defillama",
+    version: "1.0.0",
+});
+// ── Tool: search_protocols ──
+server.tool("search_protocols", "Search DeFi protocols by name. Returns top results with TVL, chains, and category.", {
+    query: z.string().describe("Search term (e.g. 'aave', 'uniswap', 'lido')"),
+    limit: z.number().optional().default(10).describe("Max results to return (default 10)"),
+}, async ({ query, limit }) => {
+    try {
+        const data = await rateLimitedFetch(`${LLAMA_BASE}/protocols`);
+        if (!Array.isArray(data)) {
+            return { content: [{ type: "text", text: "Unexpected API response from DeFi Llama." }] };
+        }
+        const q = query.toLowerCase().trim();
+        const matches = data
+            .filter((p) => {
+            const name = (p.name || "").toLowerCase();
+            const symbol = (p.symbol || "").toLowerCase();
+            const slug = (p.slug || "").toLowerCase();
+            return name.includes(q) || symbol.includes(q) || slug.includes(q);
+        })
+            .sort((a, b) => (b.tvl || 0) - (a.tvl || 0))
+            .slice(0, limit);
+        if (matches.length === 0) {
+            return { content: [{ type: "text", text: `No protocols found for "${query}".` }] };
+        }
+        const lines = matches.map((p) => {
+            const chains = (p.chains || []).slice(0, 4).join(", ");
+            const more = (p.chains || []).length > 4 ? ` +${p.chains.length - 4}` : "";
+            const category = p.category || "Unknown";
+            return `- **${p.name}** (${(p.symbol || "").toUpperCase()}) — TVL: ${formatTVL(p.tvl)} | Category: ${category} | Chains: ${chains}${more} | Slug: \`${p.slug}\``;
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Top ${matches.length} protocols matching "${query}" (by TVL):**\n\n${lines.join("\n")}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_protocol_tvl ──
+server.tool("get_protocol_tvl", "Get detailed TVL breakdown for a specific DeFi protocol (chain distribution, TVL history, category, description).", {
+    slug: z.string().describe("Protocol slug (e.g. 'aave', 'uniswap', 'lido'). Use search_protocols to find slugs."),
+}, async ({ slug }) => {
+    try {
+        const data = await rateLimitedFetch(`${LLAMA_BASE}/protocol/${encodeURIComponent(slug)}`);
+        const lines = [
+            `**${data.name}** (${(data.symbol || "").toUpperCase()})`,
+            "",
+            `- **Category:** ${data.category || "Unknown"}`,
+            `- **Chain:** ${data.chain || "Multi-chain"}`,
+            `- **Current TVL:** ${formatTVL(data.tvl)}`,
+            `- **mcap / TVL:** ${data.mcap || "N/A"}`,
+            `- **Website:** ${data.url || "N/A"}`,
+        ];
+        // Chain breakdown
+        if (Array.isArray(data.currentChainTvls) && data.currentChainTvls.length > 0) {
+            const chainLines = data.currentChainTvls
+                .map((c) => `  - ${c.name}: ${formatTVL(c.tvl)}`)
+                .join("\n");
+            lines.push("", "### TVL by Chain", chainLines);
+        }
+        // Recent TVL change
+        if (data.change_1d != null || data.change_7d != null) {
+            lines.push("", "### TVL Change", `- **24h:** ${formatPct(data.change_1d)}`, `- **7d:** ${formatPct(data.change_7d)}`);
+        }
+        // Description
+        if (data.description) {
+            const desc = String(data.description).replace(/<[^>]*>/g, "").slice(0, 400);
+            lines.push("", "### Description", desc + (String(data.description).length > 400 ? "..." : ""));
+        }
+        // Recent TVL history (sample)
+        if (data.tvl && Array.isArray(data.tvl) && data.tvl.length > 0) {
+            const hist = data.tvl;
+            const step = Math.max(1, Math.floor(hist.length / 10));
+            const samples = hist.filter((_, i) => i % step === 0);
+            const histLines = samples
+                .map(([ts, v]) => `${new Date(ts * 1000).toISOString().split("T")[0]}: ${formatTVL(v)}`)
+                .join("\n");
+            lines.push("", "### TVL History (sampled)", histLines);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_tvl_by_chain ──
+server.tool("get_tvl_by_chain", "Get total TVL for a specific chain (Ethereum, Arbitrum, Base, Solana, etc.) plus chain-level token breakdown.", {
+    chain: z.string().describe("Chain name (e.g. 'Ethereum', 'Arbitrum', 'Base', 'Solana', 'BSC', 'Polygon')"),
+}, async ({ chain }) => {
+    try {
+        const data = await rateLimitedFetch(`${LLAMA_BASE}/v2/chains`);
+        if (!Array.isArray(data)) {
+            return { content: [{ type: "text", text: "Unexpected API response from DeFi Llama." }] };
+        }
+        const c = chain.toLowerCase().trim();
+        const match = data.find((x) => (x.name || "").toLowerCase() === c)
+            || data.find((x) => (x.name || "").toLowerCase().includes(c));
+        if (!match) {
+            return { content: [{ type: "text", text: `Chain "${chain}" not found. Try one of: ${data.slice(0, 15).map((x) => x.name).join(", ")}...` }] };
+        }
+        const lines = [
+            `**${match.name} — Chain TVL**`,
+            "",
+            `- **Total TVL:** ${formatTVL(match.tvl)}`,
+        ];
+        if (match.tokenSymbol)
+            lines.push(`- **Native Token:** ${match.tokenSymbol}`);
+        if (match.gecko_id)
+            lines.push(`- **CoinGecko ID:** ${match.gecko_id}`);
+        if (match.cmcdId)
+            lines.push(`- **CMC ID:** ${match.cmcdId}`);
+        // Top tokens on this chain by TVL
+        if (Array.isArray(match.tokens) && match.tokens.length > 0) {
+            const topTokens = match.tokens
+                .filter((t) => t.tvl != null && t.tvl > 0)
+                .sort((a, b) => b.tvl - a.tvl)
+                .slice(0, 10);
+            if (topTokens.length > 0) {
+                const tokenLines = topTokens
+                    .map((t) => `- **${t.symbol || t.name || "?"}** (${t.name || ""}): ${formatTVL(t.tvl)}`)
+                    .join("\n");
+                lines.push("", "### Top Tokens by TVL", tokenLines);
+            }
+        }
+        // gecko_id link hint
+        if (match.gecko_id) {
+            lines.push("", `_View chart: https://defillama.com/chain/${match.name}_${match.gecko_id}_Coingecko__${match.name}_Coingecko_?_${match.geckoId || ""}_`);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_yields ──
+server.tool("get_yields", "Get yield/APY data for lending pools and staking across DeFi protocols. Filter by chain, project, or min TVL.", {
+    chain: z.string().optional().describe("Filter by chain (e.g. 'Ethereum', 'Arbitrum', 'Base', 'Solana')"),
+    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)"),
+    limit: z.number().optional().default(20).describe("Max results (default 20)"),
+}, async ({ chain, project, min_tvl, min_apy, limit }) => {
+    try {
+        const data = await rateLimitedFetch(`${YIELDS_BASE}/pools`);
+        if (!data || !Array.isArray(data.data)) {
+            return { content: [{ type: "text", text: "Unexpected API response from DeFi Llama yields." }] };
+        }
+        const chainFilter = chain ? chain.toLowerCase().trim() : null;
+        const projectFilter = project ? project.toLowerCase().trim() : null;
+        const matches = data.data
+            .filter((p) => {
+            if (p.tvlUsd == null || p.tvlUsd < min_tvl)
+                return false;
+            if (p.apy == null || p.apy < min_apy)
+                return false;
+            if (p.ilRisk === "yes")
+                return false; // Skip impermanent-loss pools by default
+            if (chainFilter && !(p.chain || "").toLowerCase().includes(chainFilter))
+                return false;
+            if (projectFilter && !(p.project || "").toLowerCase().includes(projectFilter))
+                return false;
+            return true;
+        })
+            .sort((a, b) => (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}%).` }] };
+        }
+        const lines = matches.map((p) => {
+            const apy = p.apy != null ? `${p.apy.toFixed(2)}%` : "N/A";
+            const apyBase = p.apyBase != null ? `${p.apyBase.toFixed(2)}% base` : "";
+            const apyReward = p.apyReward != null ? `+ ${p.apyReward.toFixed(2)}% reward` : "";
+            const apyDetails = [apyBase, apyReward].filter(Boolean).join(" ");
+            const tvl = formatTVL(p.tvlUsd);
+            const symbol = p.symbol || "?";
+            const projectName = p.project || "?";
+            const chainName = p.chain || "?";
+            const stable = p.stablecoin ? " 🟢" : "";
+            return `- **${projectName}** — ${symbol} on ${chainName}${stable} | APY: ${apy}${apyDetails ? ` (${apyDetails})` : ""} | TVL: ${tvl}`;
+        });
+        const headerParts = [];
+        if (chain)
+            headerParts.push(`chain: ${chain}`);
+        if (project)
+            headerParts.push(`project: ${project}`);
+        headerParts.push(`min TVL: ${formatTVL(min_tvl)}`);
+        headerParts.push(`min APY: ${min_apy}%`);
+        const header = headerParts.join(" | ");
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Top ${matches.length} yield pools (${header}):**\n\n${lines.join("\n")}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_stablecoins ──
+server.tool("get_stablecoins", "Get stablecoin market cap data and rankings (circulating supply, chains, prices).", {
+    limit: z.number().optional().default(25).describe("Max results (default 25)"),
+}, async ({ limit }) => {
+    try {
+        const data = await rateLimitedFetch(`${STABLECOINS_BASE}/stablecoins`);
+        if (!Array.isArray(data)) {
+            return { content: [{ type: "text", text: "Unexpected API response from DeFi Llama stablecoins." }] };
+        }
+        const sorted = [...data]
+            .filter((s) => s.circulating != null)
+            .sort((a, b) => (b.circulating?.usd || 0) - (a.circulating?.usd || 0))
+            .slice(0, limit);
+        if (sorted.length === 0) {
+            return { content: [{ type: "text", text: "No stablecoins returned by API." }] };
+        }
+        const lines = sorted.map((s, i) => {
+            const mcap = formatTVL(s.circulating?.usd);
+            const price = s.price != null ? `$${Number(s.price).toFixed(4)}` : "N/A";
+            const symbol = s.symbol || s.name || "?";
+            const pegType = s.pegType || "USD";
+            const chains = Array.isArray(s.chains) ? s.chains.length : 0;
+            return `${i + 1}. **${symbol}** (${pegType}) — MCap: ${mcap} | Price: ${price} | Chains: ${chains}`;
+        });
+        const totalMcap = sorted.reduce((acc, s) => acc + (s.circulating?.usd || 0), 0);
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Top ${sorted.length} Stablecoins by Market Cap (combined: ${formatTVL(totalMcap)}):**\n\n${lines.join("\n")}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_bridges ──
+server.tool("get_bridges", "Get bridge TVL and volume data — cross-chain bridges ranked by total value locked.", {
+    limit: z.number().optional().default(20).describe("Max results (default 20)"),
+}, async ({ limit }) => {
+    try {
+        const data = await rateLimitedFetch(`${LLAMA_BASE}/v2/bridges`);
+        const bridges = Array.isArray(data) ? data : (data.bridges || []);
+        if (!Array.isArray(bridges)) {
+            return { content: [{ type: "text", text: "Unexpected API response from DeFi Llama bridges." }] };
+        }
+        const sorted = [...bridges]
+            .filter((b) => b.tvl != null && b.tvl > 0)
+            .sort((a, b) => (b.tvl || 0) - (a.tvl || 0))
+            .slice(0, limit);
+        if (sorted.length === 0) {
+            return { content: [{ type: "text", text: "No bridge data returned." }] };
+        }
+        const lines = sorted.map((b, i) => {
+            const tvl = formatTVL(b.tvl);
+            const dayVol = b.lastDayVolume != null ? `${formatTVL(b.lastDayVolume)} 24h` : "";
+            const weekVol = b.weeklyVolume != null ? `${formatTVL(b.weeklyVolume)} 7d` : "";
+            const volDetails = [dayVol, weekVol].filter(Boolean).join(" / ");
+            return `${i + 1}. **${b.name || b.displayName || "Unknown"}** — TVL: ${tvl}${volDetails ? ` | Vol: ${volDetails}` : ""}`;
+        });
+        const totalTvl = sorted.reduce((acc, b) => acc + (b.tvl || 0), 0);
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Top ${sorted.length} Bridges by TVL (combined: ${formatTVL(totalTvl)}):**\n\n${lines.join("\n")}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_dex_volumes ──
+server.tool("get_dex_volumes", "Get DEX trading volumes across chains — decentralized exchanges ranked by 24h/7d volume.", {
+    limit: z.number().optional().default(25).describe("Max results (default 25)"),
+}, async ({ limit }) => {
+    try {
+        const data = await rateLimitedFetch(`${LLAMA_BASE}/overview/dexs`);
+        const dexs = (data && (data.protocols || data)) || [];
+        if (!Array.isArray(dexs)) {
+            return { content: [{ type: "text", text: "Unexpected API response from DeFi Llama dexs." }] };
+        }
+        const sorted = [...dexs]
+            .filter((d) => d.total24h != null)
+            .sort((a, b) => (b.total24h || 0) - (a.total24h || 0))
+            .slice(0, limit);
+        if (sorted.length === 0) {
+            return { content: [{ type: "text", text: "No DEX data returned." }] };
+        }
+        const lines = sorted.map((d, i) => {
+            const v24 = formatTVL(d.total24h);
+            const v7d = d.total7d != null ? formatTVL(d.total7d) : "N/A";
+            const v30d = d.total30d != null ? formatTVL(d.total30d) : "N/A";
+            const change = d.change_1d != null ? formatPct(d.change_1d) : "N/A";
+            return `${i + 1}. **${d.name || d.displayName || "Unknown"}** — 24h: ${v24} | 7d: ${v7d} | 30d: ${v30d} | Δ24h: ${change}`;
+        });
+        const total24h = sorted.reduce((acc, d) => acc + (d.total24h || 0), 0);
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Top ${sorted.length} DEXes by 24h Volume (combined: ${formatTVL(total24h)}):**\n\n${lines.join("\n")}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_protocol_fees ──
+server.tool("get_protocol_fees", "Get protocol fee and revenue data — protocols ranked by 24h/7d/30d fees and revenue.", {
+    limit: z.number().optional().default(25).describe("Max results (default 25)"),
+}, async ({ limit }) => {
+    try {
+        const data = await rateLimitedFetch(`${LLAMA_BASE}/overview/fees`);
+        const protos = (data && (data.protocols || data)) || [];
+        if (!Array.isArray(protos)) {
+            return { content: [{ type: "text", text: "Unexpected API response from DeFi Llama fees." }] };
+        }
+        const sorted = [...protos]
+            .filter((p) => p.total24h != null)
+            .sort((a, b) => (b.total24h || 0) - (a.total24h || 0))
+            .slice(0, limit);
+        if (sorted.length === 0) {
+            return { content: [{ type: "text", text: "No fee data returned." }] };
+        }
+        const lines = sorted.map((p, i) => {
+            const f24 = formatTVL(p.total24h);
+            const f7d = p.total7d != null ? formatTVL(p.total7d) : "N/A";
+            const f30d = p.total30d != null ? formatTVL(p.total30d) : "N/A";
+            const rev = p.revenue24h != null ? `${formatTVL(p.revenue24h)} rev` : "";
+            return `${i + 1}. **${p.name || p.displayName || "Unknown"}** — Fees 24h: ${f24} | 7d: ${f7d} | 30d: ${f30d}${rev ? ` | ${rev}` : ""}`;
+        });
+        const total24h = sorted.reduce((acc, p) => acc + (p.total24h || 0), 0);
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Top ${sorted.length} Protocols by 24h Fees (combined: ${formatTVL(total24h)}):**\n\n${lines.join("\n")}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@supernova123/defillama-mcp-server",
+  "version": "1.0.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",
+  "bin": {
+    "defillama-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "defillama",
+    "defi",
+    "tvl",
+    "yields",
+    "stablecoins",
+    "bridges",
+    "dex",
+    "ai",
+    "claude",
+    "cursor"
+  ],
+  "author": "Nova",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0"
+  },
+  "mcpName": "io.github.friendlygeorge/defillama-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/friendlygeorge/defillama-mcp-server.git"
+  },
+  "homepage": "https://github.com/friendlygeorge/defillama-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/friendlygeorge/defillama-mcp-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,484 @@
+#!/usr/bin/env node
+/**
+ * DeFi Llama MCP Server
+ *
+ * Connect AI assistants to DeFi Llama's free DeFi data API.
+ * Query protocol TVL, chain TVL, yields, stablecoins, bridges,
+ * DEX volumes, and protocol fees through the Model Context Protocol.
+ *
+ * Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP client.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const LLAMA_BASE = "https://api.llama.fi";
+const YIELDS_BASE = "https://yields.llama.fi";
+const STABLECOINS_BASE = "https://stablecoins.llama.fi";
+
+// Rate limiter: DeFi Llama doesn't publish hard limits, but be polite.
+// ~500ms between calls is safe and well below any reasonable limit.
+let lastCall = 0;
+const MIN_INTERVAL = 500;
+
+async function rateLimitedFetch(url: string): Promise<any> {
+  const now = Date.now();
+  const wait = MIN_INTERVAL - (now - lastCall);
+  if (wait > 0) {
+    await new Promise((r) => setTimeout(r, wait));
+  }
+  lastCall = Date.now();
+
+  const res = await fetch(url, {
+    headers: { Accept: "application/json" },
+  });
+
+  if (!res.ok) {
+    throw new Error(`DeFi Llama API error: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+
+function formatTVL(value: number | null | undefined): string {
+  if (value == null || isNaN(value)) return "N/A";
+  if (value >= 1e12) return `$${(value / 1e12).toFixed(2)}T`;
+  if (value >= 1e9) return `$${(value / 1e9).toFixed(2)}B`;
+  if (value >= 1e6) return `$${(value / 1e6).toFixed(2)}M`;
+  if (value >= 1e3) return `$${(value / 1e3).toFixed(2)}K`;
+  return `$${value.toFixed(2)}`;
+}
+
+function formatPct(value: number | null | undefined): string {
+  if (value == null || isNaN(value)) return "N/A";
+  return `${value >= 0 ? "+" : ""}${value.toFixed(2)}%`;
+}
+
+// Create server
+const server = new McpServer({
+  name: "defillama",
+  version: "1.0.0",
+});
+
+// ── Tool: search_protocols ──
+server.tool(
+  "search_protocols",
+  "Search DeFi protocols by name. Returns top results with TVL, chains, and category.",
+  {
+    query: z.string().describe("Search term (e.g. 'aave', 'uniswap', 'lido')"),
+    limit: z.number().optional().default(10).describe("Max results to return (default 10)"),
+  },
+  async ({ query, limit }) => {
+    try {
+      const data = await rateLimitedFetch(`${LLAMA_BASE}/protocols`);
+      if (!Array.isArray(data)) {
+        return { content: [{ type: "text" as const, text: "Unexpected API response from DeFi Llama." }] };
+      }
+      const q = query.toLowerCase().trim();
+      const matches = data
+        .filter((p: any) => {
+          const name = (p.name || "").toLowerCase();
+          const symbol = (p.symbol || "").toLowerCase();
+          const slug = (p.slug || "").toLowerCase();
+          return name.includes(q) || symbol.includes(q) || slug.includes(q);
+        })
+        .sort((a: any, b: any) => (b.tvl || 0) - (a.tvl || 0))
+        .slice(0, limit);
+
+      if (matches.length === 0) {
+        return { content: [{ type: "text" as const, text: `No protocols found for "${query}".` }] };
+      }
+
+      const lines = matches.map((p: any) => {
+        const chains = (p.chains || []).slice(0, 4).join(", ");
+        const more = (p.chains || []).length > 4 ? ` +${p.chains.length - 4}` : "";
+        const category = p.category || "Unknown";
+        return `- **${p.name}** (${(p.symbol || "").toUpperCase()}) — TVL: ${formatTVL(p.tvl)} | Category: ${category} | Chains: ${chains}${more} | Slug: \`${p.slug}\``;
+      });
+
+      return {
+        content: [{
+          type: "text" as const,
+          text: `**Top ${matches.length} protocols matching "${query}" (by TVL):**\n\n${lines.join("\n")}`,
+        }],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_protocol_tvl ──
+server.tool(
+  "get_protocol_tvl",
+  "Get detailed TVL breakdown for a specific DeFi protocol (chain distribution, TVL history, category, description).",
+  {
+    slug: z.string().describe("Protocol slug (e.g. 'aave', 'uniswap', 'lido'). Use search_protocols to find slugs."),
+  },
+  async ({ slug }) => {
+    try {
+      const data = await rateLimitedFetch(`${LLAMA_BASE}/protocol/${encodeURIComponent(slug)}`);
+      const lines: string[] = [
+        `**${data.name}** (${(data.symbol || "").toUpperCase()})`,
+        "",
+        `- **Category:** ${data.category || "Unknown"}`,
+        `- **Chain:** ${data.chain || "Multi-chain"}`,
+        `- **Current TVL:** ${formatTVL(data.tvl)}`,
+        `- **mcap / TVL:** ${data.mcap || "N/A"}`,
+        `- **Website:** ${data.url || "N/A"}`,
+      ];
+
+      // Chain breakdown
+      if (Array.isArray(data.currentChainTvls) && data.currentChainTvls.length > 0) {
+        const chainLines = data.currentChainTvls
+          .map((c: any) => `  - ${c.name}: ${formatTVL(c.tvl)}`)
+          .join("\n");
+        lines.push("", "### TVL by Chain", chainLines);
+      }
+
+      // Recent TVL change
+      if (data.change_1d != null || data.change_7d != null) {
+        lines.push(
+          "",
+          "### TVL Change",
+          `- **24h:** ${formatPct(data.change_1d)}`,
+          `- **7d:** ${formatPct(data.change_7d)}`,
+        );
+      }
+
+      // Description
+      if (data.description) {
+        const desc = String(data.description).replace(/<[^>]*>/g, "").slice(0, 400);
+        lines.push("", "### Description", desc + (String(data.description).length > 400 ? "..." : ""));
+      }
+
+      // Recent TVL history (sample)
+      if (data.tvl && Array.isArray(data.tvl) && data.tvl.length > 0) {
+        const hist = data.tvl;
+        const step = Math.max(1, Math.floor(hist.length / 10));
+        const samples = hist.filter((_: any, i: number) => i % step === 0);
+        const histLines = samples
+          .map(([ts, v]: [number, number]) => `${new Date(ts * 1000).toISOString().split("T")[0]}: ${formatTVL(v)}`)
+          .join("\n");
+        lines.push("", "### TVL History (sampled)", histLines);
+      }
+
+      return { content: [{ type: "text" as const, text: lines.join("\n") }] };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_tvl_by_chain ──
+server.tool(
+  "get_tvl_by_chain",
+  "Get total TVL for a specific chain (Ethereum, Arbitrum, Base, Solana, etc.) plus chain-level token breakdown.",
+  {
+    chain: z.string().describe("Chain name (e.g. 'Ethereum', 'Arbitrum', 'Base', 'Solana', 'BSC', 'Polygon')"),
+  },
+  async ({ chain }) => {
+    try {
+      const data = await rateLimitedFetch(`${LLAMA_BASE}/v2/chains`);
+      if (!Array.isArray(data)) {
+        return { content: [{ type: "text" as const, text: "Unexpected API response from DeFi Llama." }] };
+      }
+      const c = chain.toLowerCase().trim();
+      const match = data.find((x: any) => (x.name || "").toLowerCase() === c)
+        || data.find((x: any) => (x.name || "").toLowerCase().includes(c));
+
+      if (!match) {
+        return { content: [{ type: "text" as const, text: `Chain "${chain}" not found. Try one of: ${data.slice(0, 15).map((x: any) => x.name).join(", ")}...` }] };
+      }
+
+      const lines: string[] = [
+        `**${match.name} — Chain TVL**`,
+        "",
+        `- **Total TVL:** ${formatTVL(match.tvl)}`,
+      ];
+
+      if (match.tokenSymbol) lines.push(`- **Native Token:** ${match.tokenSymbol}`);
+      if (match.gecko_id) lines.push(`- **CoinGecko ID:** ${match.gecko_id}`);
+      if (match.cmcdId) lines.push(`- **CMC ID:** ${match.cmcdId}`);
+
+      // Top tokens on this chain by TVL
+      if (Array.isArray(match.tokens) && match.tokens.length > 0) {
+        const topTokens = match.tokens
+          .filter((t: any) => t.tvl != null && t.tvl > 0)
+          .sort((a: any, b: any) => b.tvl - a.tvl)
+          .slice(0, 10);
+        if (topTokens.length > 0) {
+          const tokenLines = topTokens
+            .map((t: any) => `- **${t.symbol || t.name || "?"}** (${t.name || ""}): ${formatTVL(t.tvl)}`)
+            .join("\n");
+          lines.push("", "### Top Tokens by TVL", tokenLines);
+        }
+      }
+
+      // gecko_id link hint
+      if (match.gecko_id) {
+        lines.push("", `_View chart: https://defillama.com/chain/${match.name}_${match.gecko_id}_Coingecko__${match.name}_Coingecko_?_${match.geckoId || ""}_`);
+      }
+
+      return { content: [{ type: "text" as const, text: lines.join("\n") }] };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_yields ──
+server.tool(
+  "get_yields",
+  "Get yield/APY data for lending pools and staking across DeFi protocols. Filter by chain, project, or min TVL.",
+  {
+    chain: z.string().optional().describe("Filter by chain (e.g. 'Ethereum', 'Arbitrum', 'Base', 'Solana')"),
+    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)"),
+    limit: z.number().optional().default(20).describe("Max results (default 20)"),
+  },
+  async ({ chain, project, min_tvl, min_apy, limit }) => {
+    try {
+      const data = await rateLimitedFetch(`${YIELDS_BASE}/pools`);
+      if (!data || !Array.isArray(data.data)) {
+        return { content: [{ type: "text" as const, text: "Unexpected API response from DeFi Llama yields." }] };
+      }
+
+      const chainFilter = chain ? chain.toLowerCase().trim() : null;
+      const projectFilter = project ? project.toLowerCase().trim() : null;
+
+      const matches = data.data
+        .filter((p: any) => {
+          if (p.tvlUsd == null || p.tvlUsd < min_tvl) return false;
+          if (p.apy == null || p.apy < min_apy) return false;
+          if (p.ilRisk === "yes") return false; // Skip impermanent-loss pools by default
+          if (chainFilter && !(p.chain || "").toLowerCase().includes(chainFilter)) return false;
+          if (projectFilter && !(p.project || "").toLowerCase().includes(projectFilter)) return false;
+          return true;
+        })
+        .sort((a: any, b: any) => (b.tvlUsd || 0) - (a.tvlUsd || 0))
+        .slice(0, limit);
+
+      if (matches.length === 0) {
+        return { content: [{ type: "text" as const, text: `No yield pools matched (chain: ${chain || "any"}, project: ${project || "any"}, min TVL $${min_tvl.toLocaleString()}, min APY ${min_apy}%).` }] };
+      }
+
+      const lines = matches.map((p: any) => {
+        const apy = p.apy != null ? `${p.apy.toFixed(2)}%` : "N/A";
+        const apyBase = p.apyBase != null ? `${p.apyBase.toFixed(2)}% base` : "";
+        const apyReward = p.apyReward != null ? `+ ${p.apyReward.toFixed(2)}% reward` : "";
+        const apyDetails = [apyBase, apyReward].filter(Boolean).join(" ");
+        const tvl = formatTVL(p.tvlUsd);
+        const symbol = p.symbol || "?";
+        const projectName = p.project || "?";
+        const chainName = p.chain || "?";
+        const stable = p.stablecoin ? " 🟢" : "";
+        return `- **${projectName}** — ${symbol} on ${chainName}${stable} | APY: ${apy}${apyDetails ? ` (${apyDetails})` : ""} | TVL: ${tvl}`;
+      });
+
+      const headerParts: string[] = [];
+      if (chain) headerParts.push(`chain: ${chain}`);
+      if (project) headerParts.push(`project: ${project}`);
+      headerParts.push(`min TVL: ${formatTVL(min_tvl)}`);
+      headerParts.push(`min APY: ${min_apy}%`);
+      const header = headerParts.join(" | ");
+
+      return {
+        content: [{
+          type: "text" as const,
+          text: `**Top ${matches.length} yield pools (${header}):**\n\n${lines.join("\n")}`,
+        }],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_stablecoins ──
+server.tool(
+  "get_stablecoins",
+  "Get stablecoin market cap data and rankings (circulating supply, chains, prices).",
+  {
+    limit: z.number().optional().default(25).describe("Max results (default 25)"),
+  },
+  async ({ limit }) => {
+    try {
+      const data = await rateLimitedFetch(`${STABLECOINS_BASE}/stablecoins`);
+      if (!Array.isArray(data)) {
+        return { content: [{ type: "text" as const, text: "Unexpected API response from DeFi Llama stablecoins." }] };
+      }
+      const sorted = [...data]
+        .filter((s: any) => s.circulating != null)
+        .sort((a: any, b: any) => (b.circulating?.usd || 0) - (a.circulating?.usd || 0))
+        .slice(0, limit);
+
+      if (sorted.length === 0) {
+        return { content: [{ type: "text" as const, text: "No stablecoins returned by API." }] };
+      }
+
+      const lines = sorted.map((s: any, i: number) => {
+        const mcap = formatTVL(s.circulating?.usd);
+        const price = s.price != null ? `$${Number(s.price).toFixed(4)}` : "N/A";
+        const symbol = s.symbol || s.name || "?";
+        const pegType = s.pegType || "USD";
+        const chains = Array.isArray(s.chains) ? s.chains.length : 0;
+        return `${i + 1}. **${symbol}** (${pegType}) — MCap: ${mcap} | Price: ${price} | Chains: ${chains}`;
+      });
+
+      const totalMcap = sorted.reduce((acc: number, s: any) => acc + (s.circulating?.usd || 0), 0);
+      return {
+        content: [{
+          type: "text" as const,
+          text: `**Top ${sorted.length} Stablecoins by Market Cap (combined: ${formatTVL(totalMcap)}):**\n\n${lines.join("\n")}`,
+        }],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_bridges ──
+server.tool(
+  "get_bridges",
+  "Get bridge TVL and volume data — cross-chain bridges ranked by total value locked.",
+  {
+    limit: z.number().optional().default(20).describe("Max results (default 20)"),
+  },
+  async ({ limit }) => {
+    try {
+      const data = await rateLimitedFetch(`${LLAMA_BASE}/v2/bridges`);
+      const bridges = Array.isArray(data) ? data : (data.bridges || []);
+      if (!Array.isArray(bridges)) {
+        return { content: [{ type: "text" as const, text: "Unexpected API response from DeFi Llama bridges." }] };
+      }
+      const sorted = [...bridges]
+        .filter((b: any) => b.tvl != null && b.tvl > 0)
+        .sort((a: any, b: any) => (b.tvl || 0) - (a.tvl || 0))
+        .slice(0, limit);
+
+      if (sorted.length === 0) {
+        return { content: [{ type: "text" as const, text: "No bridge data returned." }] };
+      }
+
+      const lines = sorted.map((b: any, i: number) => {
+        const tvl = formatTVL(b.tvl);
+        const dayVol = b.lastDayVolume != null ? `${formatTVL(b.lastDayVolume)} 24h` : "";
+        const weekVol = b.weeklyVolume != null ? `${formatTVL(b.weeklyVolume)} 7d` : "";
+        const volDetails = [dayVol, weekVol].filter(Boolean).join(" / ");
+        return `${i + 1}. **${b.name || b.displayName || "Unknown"}** — TVL: ${tvl}${volDetails ? ` | Vol: ${volDetails}` : ""}`;
+      });
+
+      const totalTvl = sorted.reduce((acc: number, b: any) => acc + (b.tvl || 0), 0);
+      return {
+        content: [{
+          type: "text" as const,
+          text: `**Top ${sorted.length} Bridges by TVL (combined: ${formatTVL(totalTvl)}):**\n\n${lines.join("\n")}`,
+        }],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_dex_volumes ──
+server.tool(
+  "get_dex_volumes",
+  "Get DEX trading volumes across chains — decentralized exchanges ranked by 24h/7d volume.",
+  {
+    limit: z.number().optional().default(25).describe("Max results (default 25)"),
+  },
+  async ({ limit }) => {
+    try {
+      const data = await rateLimitedFetch(`${LLAMA_BASE}/overview/dexs`);
+      const dexs = (data && (data.protocols || data)) || [];
+      if (!Array.isArray(dexs)) {
+        return { content: [{ type: "text" as const, text: "Unexpected API response from DeFi Llama dexs." }] };
+      }
+      const sorted = [...dexs]
+        .filter((d: any) => d.total24h != null)
+        .sort((a: any, b: any) => (b.total24h || 0) - (a.total24h || 0))
+        .slice(0, limit);
+
+      if (sorted.length === 0) {
+        return { content: [{ type: "text" as const, text: "No DEX data returned." }] };
+      }
+
+      const lines = sorted.map((d: any, i: number) => {
+        const v24 = formatTVL(d.total24h);
+        const v7d = d.total7d != null ? formatTVL(d.total7d) : "N/A";
+        const v30d = d.total30d != null ? formatTVL(d.total30d) : "N/A";
+        const change = d.change_1d != null ? formatPct(d.change_1d) : "N/A";
+        return `${i + 1}. **${d.name || d.displayName || "Unknown"}** — 24h: ${v24} | 7d: ${v7d} | 30d: ${v30d} | Δ24h: ${change}`;
+      });
+
+      const total24h = sorted.reduce((acc: number, d: any) => acc + (d.total24h || 0), 0);
+      return {
+        content: [{
+          type: "text" as const,
+          text: `**Top ${sorted.length} DEXes by 24h Volume (combined: ${formatTVL(total24h)}):**\n\n${lines.join("\n")}`,
+        }],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_protocol_fees ──
+server.tool(
+  "get_protocol_fees",
+  "Get protocol fee and revenue data — protocols ranked by 24h/7d/30d fees and revenue.",
+  {
+    limit: z.number().optional().default(25).describe("Max results (default 25)"),
+  },
+  async ({ limit }) => {
+    try {
+      const data = await rateLimitedFetch(`${LLAMA_BASE}/overview/fees`);
+      const protos = (data && (data.protocols || data)) || [];
+      if (!Array.isArray(protos)) {
+        return { content: [{ type: "text" as const, text: "Unexpected API response from DeFi Llama fees." }] };
+      }
+      const sorted = [...protos]
+        .filter((p: any) => p.total24h != null)
+        .sort((a: any, b: any) => (b.total24h || 0) - (a.total24h || 0))
+        .slice(0, limit);
+
+      if (sorted.length === 0) {
+        return { content: [{ type: "text" as const, text: "No fee data returned." }] };
+      }
+
+      const lines = sorted.map((p: any, i: number) => {
+        const f24 = formatTVL(p.total24h);
+        const f7d = p.total7d != null ? formatTVL(p.total7d) : "N/A";
+        const f30d = p.total30d != null ? formatTVL(p.total30d) : "N/A";
+        const rev = p.revenue24h != null ? `${formatTVL(p.revenue24h)} rev` : "";
+        return `${i + 1}. **${p.name || p.displayName || "Unknown"}** — Fees 24h: ${f24} | 7d: ${f7d} | 30d: ${f30d}${rev ? ` | ${rev}` : ""}`;
+      });
+
+      const total24h = sorted.reduce((acc: number, p: any) => acc + (p.total24h || 0), 0);
+      return {
+        content: [{
+          type: "text" as const,
+          text: `**Top ${sorted.length} Protocols by 24h Fees (combined: ${formatTVL(total24h)}):**\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();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}