@mrfentmen/defillama-mcp 1.0.0

package/README.md

@@ -0,0 +1,25 @@
+# defillama-mcp
+
+DefiLlama protocols, chains, and TVL (merged).
+
+A merged MCP server that consolidates duplicate single-purpose servers in this monorepo into one focused server.
+
+## Tools
+
+- `chains` — TVL by chain.
+- `protocol` — TVL history for a protocol.
+- `top_protocols` — Get the top DeFi protocols by TVL.
+- `chain_tvl` — Get TVL for all chains.
+- `protocol_info` — Get details for a specific protocol.
+
+## Run
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+## Source
+
+Public free APIs only. See `src/api.ts` for exact endpoints.

package/dist/api.js

@@ -0,0 +1,110 @@
+const m0 = (() => {
+    const BASE = 'https://api.llama.fi';
+    async function chains(_args) {
+        const res = await fetch(`${BASE}/v2/chains`, {
+            headers: { 'User-Agent': 'mrfentmen-defillama-mcp/1.0', Accept: 'application/json' },
+            signal: AbortSignal.timeout(20000),
+        });
+        if (!res.ok)
+            throw new Error(`DefiLlama returned ${res.status}`);
+        const d = (await res.json());
+        if (!d.length)
+            return 'No chain data returned.';
+        const fmt = (v) => {
+            const n = Number(v);
+            if (!n)
+                return '$0';
+            if (n >= 1e9)
+                return `$${(n / 1e9).toFixed(2)}B`;
+            if (n >= 1e6)
+                return `$${(n / 1e6).toFixed(1)}M`;
+            return `$${n.toFixed(0)}`;
+        };
+        return `DeFi TVL by chain (${d.length} chains):\n` +
+            d.slice(0, 20).map((c, i) => {
+                const s = (k) => (c[k] != null ? String(c[k]) : '');
+                return `${i + 1}. ${s('name')} | ${fmt(c.tvl)}`;
+            }).join('\n');
+    }
+    async function protocol(args) {
+        const slug = (args.slug ?? '').trim();
+        if (!slug)
+            return 'Provide a protocol slug.';
+        const res = await fetch(`${BASE}/protocol/${encodeURIComponent(slug)}`, {
+            headers: { 'User-Agent': 'mrfentmen-defillama-mcp/1.0', Accept: 'application/json' },
+            signal: AbortSignal.timeout(20000),
+        });
+        if (!res.ok)
+            throw new Error(`DefiLlama returned ${res.status}`);
+        const d = (await res.json());
+        const s = (k) => (d[k] != null ? String(d[k]) : '');
+        const tvl = d.tvl ?? [];
+        const latest = Array.isArray(tvl) && tvl.length ? tvl.at(-1) : null;
+        const chainTvls = (d.currentChainTvls ?? {});
+        return [
+            `Protocol: ${s('name')}`,
+            s('url') ? `Site: ${s('url')}` : '',
+            latest ? `Latest TVL: $${Number(latest.tvl ?? 0).toLocaleString()}` : '',
+            Object.keys(chainTvls).length ? `Chains: ${Object.entries(chainTvls).slice(0, 8).map(([k, v]) => `${k} $${Math.round(Number(v)).toLocaleString()}`).join(', ')}` : '',
+        ].filter(Boolean).join('\n');
+    }
+    return { chains, protocol };
+})();
+const m1 = (() => {
+    const BASE = "https://api.llama.fi";
+    const UA = "mrfentmen-defi-tvl-mcp/1.0 (https://github.com/mrfentmen)";
+    class DefiError extends Error {
+    }
+    async function get(url) {
+        const res = await fetch(url, { headers: { "User-Agent": UA, Accept: "application/json" }, signal: AbortSignal.timeout(25000) });
+        if (res.status === 429)
+            throw new DefiError("DefiLlama rate limit hit, wait and retry");
+        if (!res.ok)
+            throw new DefiError(`DefiLlama error ${res.status}`);
+        return (await res.json());
+    }
+    function fmtUsd(v) {
+        if (v === undefined || v === null)
+            return "n/a";
+        return "$" + v.toLocaleString(undefined, { maximumFractionDigits: 0 });
+    }
+    async function topProtocols(args) {
+        const limit = Math.min(args.limit ?? 10, 50);
+        const d = await get(`${BASE}/protocols`);
+        const rows = d
+            .filter((p) => !p?.misrepresentedTokens)
+            .sort((a, b) => (b?.tvl ?? 0) - (a?.tvl ?? 0))
+            .slice(0, limit);
+        if (!rows.length)
+            return "No protocols returned";
+        return rows.map((p, i) => `${i + 1}. ${p?.name ?? "n/a"} | ${fmtUsd(p?.tvl)} | chains: ${(p?.chains ?? []).slice(0, 4).join(", ") || "n/a"}`).join("\n");
+    }
+    async function chainTvl(args) {
+        const limit = Math.min(args.limit ?? 10, 50);
+        const d = await get(`${BASE}/v2/chains`);
+        const rows = [...d].sort((a, b) => (b?.tvl ?? 0) - (a?.tvl ?? 0)).slice(0, limit);
+        if (!rows.length)
+            return "No chains returned";
+        return rows.map((c, i) => `${i + 1}. ${c?.name ?? "n/a"} | ${fmtUsd(c?.tvl)} | ${c?.tokenSymbol ?? ""}`).join("\n");
+    }
+    async function protocolInfo(args) {
+        const slug = (args.protocol ?? "").trim().toLowerCase().replace(/ /g, "-");
+        if (!slug)
+            throw new DefiError("Provide a protocol slug");
+        const d = await get(`${BASE}/protocol/${encodeURIComponent(slug)}`);
+        return `Protocol: ${d?.name ?? slug}\nCurrent TVL: ${fmtUsd(d?.tvl)}\nChains: ${(d?.chains ?? []).join(", ") || "n/a"}\nCategory: ${d?.category ?? "n/a"}\nDescription: ${d?.description ?? "n/a"}\nWebsite: ${d?.url ?? "n/a"}`;
+    }
+    return { DefiError, chainTvl, protocolInfo, topProtocols };
+})();
+export const DefiError = m1.DefiError;
+export const chainTvl = m1.chainTvl;
+export const chains = m0.chains;
+export const protocol = m0.protocol;
+export const protocolInfo = m1.protocolInfo;
+export const topProtocols = m1.topProtocols;
+export const m0_protocol = m0.protocol;
+export const m0_chains = m0.chains;
+export const m1_topProtocols = m1.topProtocols;
+export const m1_chainTvl = m1.chainTvl;
+export const m1_protocolInfo = m1.protocolInfo;
+export const m1_DefiError = m1.DefiError;

package/dist/index.js

@@ -0,0 +1,4 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const main = async () => { const server = createServer(); await server.connect(new StdioServerTransport()); };
+main().catch((error) => { console.error("Fatal error:", error); process.exit(1); });

package/dist/server.js

@@ -0,0 +1,77 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { m0_chains, m0_protocol, m1_chainTvl, m1_protocolInfo, m1_topProtocols } from './api.js';
+const text = (value) => ({ content: [{ type: 'text', text: value }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+const error = (e) => `Error: ${e instanceof Error ? e.message : String(e)}`;
+const errorMessage = error;
+export function createServer() {
+    const server = new McpServer({ name: 'defillama-mcp', version: '1.0.0' });
+    server.registerTool("chains", {
+        title: "Chains",
+        description: "TVL by chain.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await m0_chains(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool("protocol", {
+        title: "Protocol",
+        description: "TVL history for a protocol.",
+        inputSchema: z.object({ slug: z.string().describe("Protocol slug.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await m0_protocol(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool("top_protocols", {
+        title: "Top protocols",
+        description: "Get the top DeFi protocols by TVL.",
+        inputSchema: z.object({ limit: z.number().describe("Max results.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await m1_topProtocols(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool("chain_tvl", {
+        title: "Chain tvl",
+        description: "Get TVL for all chains.",
+        inputSchema: z.object({ limit: z.number().describe("Max results.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await m1_chainTvl(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool("protocol_info", {
+        title: "Protocol info",
+        description: "Get details for a specific protocol.",
+        inputSchema: z.object({ protocol: z.string().describe("Protocol slug.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await m1_protocolInfo(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@mrfentmen/defillama-mcp",
+  "version": "1.0.0",
+  "description": "DefiLlama protocols, chains, and TVL (merged).",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "mcpName": "io.github.mrfentmen/defillama-mcp"
+}

package/server.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.mrfentmen/defillama-mcp",
+  "description": "DefiLlama protocols, chains, and TVL (merged).",
+  "repository": {
+    "url": "https://github.com/mrfentmen/awesome-mcps",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@mrfentmen/defillama-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

package/src/api.ts

@@ -0,0 +1,107 @@
+const m0 = (() => {
+const BASE = 'https://api.llama.fi';
+
+async function chains(_args?: unknown): Promise<string> {
+  const res = await fetch(`${BASE}/v2/chains`, {
+    headers: { 'User-Agent': 'mrfentmen-defillama-mcp/1.0', Accept: 'application/json' },
+    signal: AbortSignal.timeout(20000),
+  });
+  if (!res.ok) throw new Error(`DefiLlama returned ${res.status}`);
+  const d = (await res.json()) as Array<Record<string, unknown>>;
+  if (!d.length) return 'No chain data returned.';
+  const fmt = (v: unknown) => {
+    const n = Number(v);
+    if (!n) return '$0';
+    if (n >= 1e9) return `$${(n / 1e9).toFixed(2)}B`;
+    if (n >= 1e6) return `$${(n / 1e6).toFixed(1)}M`;
+    return `$${n.toFixed(0)}`;
+  };
+  return `DeFi TVL by chain (${d.length} chains):\n` +
+    d.slice(0, 20).map((c, i) => {
+      const s = (k: string) => (c[k] != null ? String(c[k]) : '');
+      return `${i + 1}. ${s('name')} | ${fmt(c.tvl)}`;
+    }).join('\n');
+}
+
+async function protocol(args: { slug: string }): Promise<string> {
+  const slug = (args.slug ?? '').trim();
+  if (!slug) return 'Provide a protocol slug.';
+  const res = await fetch(`${BASE}/protocol/${encodeURIComponent(slug)}`, {
+    headers: { 'User-Agent': 'mrfentmen-defillama-mcp/1.0', Accept: 'application/json' },
+    signal: AbortSignal.timeout(20000),
+  });
+  if (!res.ok) throw new Error(`DefiLlama returned ${res.status}`);
+  const d = (await res.json()) as Record<string, unknown>;
+  const s = (k: string) => (d[k] != null ? String(d[k]) : '');
+  const tvl = d.tvl ?? [];
+  const latest = Array.isArray(tvl) && tvl.length ? (tvl as Array<Record<string, unknown>>).at(-1) : null;
+  const chainTvls = (d.currentChainTvls ?? {}) as Record<string, unknown>;
+  return [
+    `Protocol: ${s('name')}`,
+    s('url') ? `Site: ${s('url')}` : '',
+    latest ? `Latest TVL: $${Number(latest.tvl ?? 0).toLocaleString()}` : '',
+    Object.keys(chainTvls).length ? `Chains: ${Object.entries(chainTvls).slice(0, 8).map(([k, v]) => `${k} $${Math.round(Number(v)).toLocaleString()}`).join(', ')}` : '',
+  ].filter(Boolean).join('\n');
+}
+
+return { chains, protocol };
+})();
+
+const m1 = (() => {
+const BASE = "https://api.llama.fi"
+const UA = "mrfentmen-defi-tvl-mcp/1.0 (https://github.com/mrfentmen)"
+class DefiError extends Error {}
+
+async function get<T>(url: string): Promise<T> {
+  const res = await fetch(url, { headers: { "User-Agent": UA, Accept: "application/json" }, signal: AbortSignal.timeout(25000) })
+  if (res.status === 429) throw new DefiError("DefiLlama rate limit hit, wait and retry")
+  if (!res.ok) throw new DefiError(`DefiLlama error ${res.status}`)
+  return (await res.json()) as T
+}
+
+function fmtUsd(v: number | undefined): string {
+  if (v === undefined || v === null) return "n/a"
+  return "$" + v.toLocaleString(undefined, { maximumFractionDigits: 0 })
+}
+
+async function topProtocols(args: { limit?: number }): Promise<string> {
+  const limit = Math.min(args.limit ?? 10, 50)
+  const d = await get<any[]>(`${BASE}/protocols`)
+  const rows = d
+    .filter((p: any) => !p?.misrepresentedTokens)
+    .sort((a: any, b: any) => (b?.tvl ?? 0) - (a?.tvl ?? 0))
+    .slice(0, limit)
+  if (!rows.length) return "No protocols returned"
+  return rows.map((p: any, i: number) => `${i + 1}. ${p?.name ?? "n/a"} | ${fmtUsd(p?.tvl)} | chains: ${(p?.chains ?? []).slice(0, 4).join(", ") || "n/a"}`).join("\n")
+}
+
+async function chainTvl(args: { limit?: number }): Promise<string> {
+  const limit = Math.min(args.limit ?? 10, 50)
+  const d = await get<any[]>(`${BASE}/v2/chains`)
+  const rows = [...d].sort((a: any, b: any) => (b?.tvl ?? 0) - (a?.tvl ?? 0)).slice(0, limit)
+  if (!rows.length) return "No chains returned"
+  return rows.map((c: any, i: number) => `${i + 1}. ${c?.name ?? "n/a"} | ${fmtUsd(c?.tvl)} | ${c?.tokenSymbol ?? ""}`).join("\n")
+}
+
+async function protocolInfo(args: { protocol?: string }): Promise<string> {
+  const slug = (args.protocol ?? "").trim().toLowerCase().replace(/ /g, "-")
+  if (!slug) throw new DefiError("Provide a protocol slug")
+  const d = await get<any>(`${BASE}/protocol/${encodeURIComponent(slug)}`)
+  return `Protocol: ${d?.name ?? slug}\nCurrent TVL: ${fmtUsd(d?.tvl)}\nChains: ${(d?.chains ?? []).join(", ") || "n/a"}\nCategory: ${d?.category ?? "n/a"}\nDescription: ${d?.description ?? "n/a"}\nWebsite: ${d?.url ?? "n/a"}`
+}
+
+return { DefiError, chainTvl, protocolInfo, topProtocols };
+})();
+
+export const DefiError = m1.DefiError;
+export const chainTvl = m1.chainTvl;
+export const chains = m0.chains;
+export const protocol = m0.protocol;
+export const protocolInfo = m1.protocolInfo;
+export const topProtocols = m1.topProtocols;
+export const m0_protocol = m0.protocol;
+export const m0_chains = m0.chains;
+export const m1_topProtocols = m1.topProtocols;
+export const m1_chainTvl = m1.chainTvl;
+export const m1_protocolInfo = m1.protocolInfo;
+export const m1_DefiError = m1.DefiError;

package/src/index.ts

@@ -0,0 +1,4 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
+import { createServer } from "./server.js"
+const main = async () => { const server = createServer(); await server.connect(new StdioServerTransport()) }
+main().catch((error) => { console.error("Fatal error:", error); process.exit(1) })

package/src/server.ts

@@ -0,0 +1,74 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import { m0_chains, m0_protocol, m1_chainTvl, m1_protocolInfo, m1_topProtocols } from './api.js'
+
+const text = (value: string) => ({ content: [{ type: 'text' as const, text: value }] })
+const textError = (t: string) => ({ content: [{ type: "text" as const, text: t }], isError: true as const })
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true } as const
+const error = (e: unknown) => `Error: ${e instanceof Error ? e.message : String(e)}`
+const errorMessage = error
+
+export function createServer(): McpServer {
+  const server = new McpServer({ name: 'defillama-mcp', version: '1.0.0' })
+server.registerTool(
+    "chains",
+    {
+      title: "Chains",
+      description: "TVL by chain.",
+      inputSchema: z.object( {  }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+    try { return text(await m0_chains(args)) } catch (e) { return textError(error(e)) }
+  }
+  )
+server.registerTool(
+    "protocol",
+    {
+      title: "Protocol",
+      description: "TVL history for a protocol.",
+      inputSchema: z.object( { slug: z.string().describe("Protocol slug.") }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+    try { return text(await m0_protocol(args)) } catch (e) { return textError(error(e)) }
+  }
+  )
+server.registerTool(
+    "top_protocols",
+    {
+      title: "Top protocols",
+      description: "Get the top DeFi protocols by TVL.",
+      inputSchema: z.object( { limit: z.number().describe("Max results.").optional() }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+    try { return text(await m1_topProtocols(args)) } catch (e) { return textError(error(e)) }
+  }
+  )
+server.registerTool(
+    "chain_tvl",
+    {
+      title: "Chain tvl",
+      description: "Get TVL for all chains.",
+      inputSchema: z.object( { limit: z.number().describe("Max results.").optional() }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+    try { return text(await m1_chainTvl(args)) } catch (e) { return textError(error(e)) }
+  }
+  )
+server.registerTool(
+    "protocol_info",
+    {
+      title: "Protocol info",
+      description: "Get details for a specific protocol.",
+      inputSchema: z.object( { protocol: z.string().describe("Protocol slug.") }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+    try { return text(await m1_protocolInfo(args)) } catch (e) { return textError(error(e)) }
+  }
+  )
+  return server
+}

package/tsconfig.json

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