@venicestats/mcp-server 0.1.0

package/dist/tools/buzz.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtAgo } from "../lib/format.js";
+export function registerBuzzTool(server) {
+    server.tool("venicestats_buzz", "Get recent articles, tweets, and videos about Venice.ai. A curated news feed of community content. Use when someone asks about Venice news, what people are saying, recent articles, or community discussion.", {
+        type: z.enum(["article", "video", "tweet"]).optional().describe("Filter by content type"),
+        limit: z.number().int().min(1).max(20).default(10).describe("Number of items to return (1-20, default 10)"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ type, limit }) => {
+        try {
+            const params = { limit };
+            if (type)
+                params.type = type;
+            const d = await apiGet("/api/buzz", params);
+            const typeLabel = type || "all";
+            const lines = [
+                `## Venice Buzz — ${typeLabel} (${d.total} total)`,
+                "",
+            ];
+            for (const item of d.items) {
+                const source = item.sourceName || item.authorHandle || "Unknown";
+                const engagement = [
+                    item.likeCount ? `${item.likeCount} likes` : null,
+                    item.retweetCount ? `${item.retweetCount} RTs` : null,
+                ].filter(Boolean).join(", ");
+                lines.push(`### ${item.title}`);
+                lines.push(`${item.type} by ${source} — ${fmtAgo(item.publishedAt)}${engagement ? ` (${engagement})` : ""}`);
+                if (item.summary)
+                    lines.push(item.summary);
+                lines.push(`[Read more](${item.url})`, "");
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/buzz",
+                tip: "Use venicestats_social for quantitative sentiment metrics (Twitter followers, CoinGecko sentiment).",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=buzz.js.map

package/dist/tools/buzz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buzz.js","sourceRoot":"","sources":["../../src/tools/buzz.ts"],"names":[],"mappings":"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"}

package/dist/tools/diem.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDiemTool(server: McpServer): void;

package/dist/tools/diem.js

@@ -0,0 +1,35 @@
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtToken, fmtUsd } from "../lib/format.js";
+export function registerDiemTool(server) {
+    server.tool("venicestats_diem", "Analyze DIEM token minting: cohort breakdown (Genesis to Current), top minters with burn rates, total locked sVVV, Venice revenue, and current mint rate. DIEM is minted by locking staked VVV (sVVV). Use when someone asks about DIEM minting, cohorts, burn rate, or who the biggest DIEM minters are.", { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => {
+        try {
+            const d = await apiGet("/api/diem-analytics");
+            const lines = [
+                `## DIEM Minting Overview`,
+                `Current Mint Rate: ${Math.round(d.currentMintRate)} sVVV per DIEM`,
+                `Total Locked: ${fmtToken(d.totalLockedSvvv, "sVVV")}`,
+                `Venice Revenue (20% haircut): ${fmtUsd(d.veniceRevenue20Pct)}/year`,
+                "",
+                `## Cohorts`,
+            ];
+            for (const c of d.cohorts) {
+                lines.push(`- **${c.name}**: ${c.walletCount} wallets, ${fmtToken(c.totalDiemMinted, "DIEM")} minted, avg burn rate ${Math.round(c.avgBurnRate)} sVVV/DIEM, ${Math.round(c.stillLockedPct * 100)}% still locked`);
+            }
+            lines.push("", `## Top 10 Minters`);
+            for (const m of d.topMinters.slice(0, 10)) {
+                const name = m.ensName || `${m.address.slice(0, 8)}...`;
+                const inference = m.inferencePerDay > 0 ? ` | $${Math.round(m.inferencePerDay)}/day inference` : "";
+                lines.push(`- **${name}** (${m.badge}): ${fmtToken(m.outstandingDiem, "DIEM")} outstanding, ${fmtToken(m.svvvLocked, "sVVV")} locked, rate ${Math.round(m.burnRate)}${inference}`);
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/diem",
+                tip: "Use venicestats_protocol_overview with category='diem' for DIEM price and supply metrics.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=diem.js.map

package/dist/tools/diem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diem.js","sourceRoot":"","sources":["../../src/tools/diem.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA4BpD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,2SAA2S,EAC3S,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EACzF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAe,qBAAqB,CAAC,CAAC;YAE5D,MAAM,KAAK,GAAG;gBACZ,0BAA0B;gBAC1B,sBAAsB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,gBAAgB;gBACnE,iBAAiB,QAAQ,CAAC,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE;gBACtD,iCAAiC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO;gBACpE,EAAE;gBACF,YAAY;aACb,CAAC;YAEF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,aAAa,QAAQ,CAAC,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,0BAA0B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACpN,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;gBACxD,MAAM,SAAS,GAAG,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpG,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,iBAAiB,QAAQ,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC;YACrL,CAAC;YAED,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvC,QAAQ,EAAE,OAAO;gBACjB,GAAG,EAAE,2FAA2F;aACjG,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/insider-flow.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerInsiderFlowTool(server: McpServer): void;

package/dist/tools/insider-flow.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtToken, fmtPct } from "../lib/format.js";
+export function registerInsiderFlowTool(server) {
+    server.tool("venicestats_insider_flow", "Analyze vesting recipient (insider) trading activity: are insiders buying or selling? Shows net flow, sell pressure trend, retention rate, and top recipients by behavior. Use when someone asks about insider selling, vesting recipient activity, or sell pressure from team/investors.", {
+        mode: z.enum(["overview", "recipients"]).default("overview").describe("'overview' for KPIs and trends, 'recipients' for per-wallet breakdown"),
+        limit: z.number().int().min(1).max(50).default(10).describe("Number of recipients to return (recipients mode only, default 10)"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mode, limit }) => {
+        try {
+            if (mode === "overview") {
+                const d = await apiGet("/api/insider-flow", { mode: "overview" });
+                const k = d.kpis;
+                const flowDir = k.netFlow30d < 0 ? "net selling" : "net buying";
+                const flowChange = k.prevNetFlow30d !== 0
+                    ? ((k.netFlow30d - k.prevNetFlow30d) / Math.abs(k.prevNetFlow30d)) * 100
+                    : 0;
+                const lines = [
+                    `## Insider Flow (30d)`,
+                    `Net Flow: ${fmtToken(k.netFlow30d, "VVV")} (${flowDir}, ${fmtPct(flowChange)} vs prev 30d)`,
+                    `Sell Volume: ${fmtToken(k.sellVolume30d, "VVV")} | Buy Volume: ${fmtToken(k.buyVolume30d, "VVV")}`,
+                    `Sell Pressure: **${k.sellPressure}** (${k.sellTrendPct}% sell ratio)`,
+                    "",
+                    `## Retention`,
+                    `Total Claimed: ${fmtToken(k.totalClaimed, "VVV")} | Currently Held: ${fmtToken(k.totalHeld, "VVV")}`,
+                    `Retention Rate: ${k.retentionRate}%`,
+                    "",
+                    `## Activity`,
+                    `Active Traders: ${k.activeTraders7d} (7d) / ${k.activeTraders30d} (30d)`,
+                    `Total Trades (30d): ${k.totalTrades30d}`,
+                ];
+                return brandedResponse(lines.join("\n"), {
+                    deepLink: "/vesting",
+                    tip: "Use venicestats_insider_flow with mode='recipients' for per-wallet breakdown, or venicestats_vesting for unlock schedules.",
+                });
+            }
+            else {
+                const d = await apiGet("/api/insider-flow", { mode: "recipients" });
+                const top = d.recipients.slice(0, limit);
+                const lines = [
+                    `## Top ${top.length} Insider Recipients`,
+                    "",
+                ];
+                for (const r of top) {
+                    const name = r.name || `${r.address.slice(0, 8)}...`;
+                    const netFlow = r.buyVolume - r.sellVolume;
+                    const netLabel = netFlow >= 0 ? "net buyer" : "net seller";
+                    lines.push(`- **${name}** — ${r.behavior} | Claimed: ${fmtToken(r.claimed, "VVV")} | Sold: ${fmtToken(r.sellVolume)} | Retention: ${r.retention}% (${netLabel})`);
+                }
+                return brandedResponse(lines.join("\n"), {
+                    deepLink: "/vesting",
+                    tip: "Use venicestats_wallet to see full identity for any of these addresses.",
+                });
+            }
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=insider-flow.js.map

package/dist/tools/insider-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insider-flow.js","sourceRoot":"","sources":["../../src/tools/insider-flow.ts"],"names":[],"mappings":"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"}

package/dist/tools/large-trades.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLargeTradesTool(server: McpServer): void;

package/dist/tools/large-trades.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtUsd, fmtToken, fmtAgo } from "../lib/format.js";
+export function registerLargeTradesTool(server) {
+    server.tool("venicestats_large_trades", "Get individual large trades (swaps) for VVV or DIEM with trader identity, pool, direction, and insider flag. Use when someone asks about whale trades, big buys/sells, or where buy/sell pressure is coming from.", {
+        token: z.enum(["VVV", "DIEM"]).default("VVV").describe("Token to filter trades for"),
+        period: z.enum(["24h", "7d", "30d", "90d"]).default("7d").describe("Lookback period"),
+        direction: z.enum(["buy", "sell", "all"]).default("all").describe("Filter by trade direction"),
+        minVolume: z.number().min(0).default(1000).describe("Minimum trade volume in USD (default $1000)"),
+        limit: z.number().int().min(1).max(20).default(10).describe("Number of trades to return (1-20, default 10)"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ token, period, direction, minVolume, limit }) => {
+        try {
+            const d = await apiGet("/api/markets/large-swaps", {
+                token,
+                period,
+                direction: direction === "all" ? undefined : direction,
+                minVolume,
+                limit,
+                sort: "volume",
+                order: "desc",
+            });
+            const lines = [
+                `## Large ${token} Trades — ${period} (${d.pagination.total.toLocaleString()} total above ${fmtUsd(minVolume)})`,
+                "",
+            ];
+            if (d.swaps.length === 0) {
+                lines.push("No trades found matching the criteria.");
+            }
+            else {
+                for (const s of d.swaps) {
+                    const dir = s.direction === "buy" ? "🟢 BUY" : "🔴 SELL";
+                    const name = s.traderName || `${s.trader.slice(0, 8)}...`;
+                    const insider = s.isVesting ? " [INSIDER]" : "";
+                    const price = s.effectivePrice ? ` @ $${s.effectivePrice.toFixed(2)}` : "";
+                    lines.push(`- ${dir} ${fmtUsd(s.volumeUsd)} (${fmtToken(s.tokenAmount, s.tokenLabel)}${price}) via ${s.poolName} (${s.dex}) by ${name}${insider} — ${fmtAgo(s.timestamp)}`);
+                }
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: `/markets?token=${token}&period=${period}`,
+                tip: "Use venicestats_wallet to look up any trader's full profile, or venicestats_insider_flow for aggregate insider activity.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=large-trades.js.map

package/dist/tools/large-trades.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"large-trades.js","sourceRoot":"","sources":["../../src/tools/large-trades.ts"],"names":[],"mappings":"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"}

package/dist/tools/leaderboard.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLeaderboardTool(server: McpServer): void;

package/dist/tools/leaderboard.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtToken } from "../lib/format.js";
+export function registerLeaderboardTool(server) {
+    server.tool("venicestats_leaderboard", "Get the top VVV holders ranked by sVVV balance, DIEM staked, conviction score, or locked amount. Use when someone asks who the biggest holders/stakers are, top wallets, or leaderboard rankings.", {
+        sort: z.enum(["svvv", "diem", "conviction", "locked"]).default("svvv").describe("Sort by: svvv (staked balance), diem (DIEM staked), conviction (conviction score), locked (locked sVVV)"),
+        limit: z.number().int().min(1).max(25).default(10).describe("Number of holders to return (1-25, default 10)"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ sort, limit }) => {
+        try {
+            const d = await apiGet("/api/holders", { sort, limit });
+            const sortLabel = { svvv: "sVVV Balance", diem: "DIEM Staked", conviction: "Conviction Score", locked: "Locked sVVV" }[sort];
+            const lines = [
+                `## Venice Leaderboard — Top ${d.holders.length} by ${sortLabel}`,
+                `(${d.totalHolders.toLocaleString()} total holders)`,
+                "",
+            ];
+            for (const h of d.holders) {
+                const name = h.ensName || h.username || `${h.address.slice(0, 8)}...`;
+                const lockPct = h.svvvBalance > 0 ? Math.round((h.svvvLocked / h.svvvBalance) * 100) : 0;
+                lines.push(`${h.rank}. **${name}** — ${fmtToken(h.svvvBalance, "sVVV")} (${lockPct}% locked) | DIEM: ${fmtToken(h.diemStaked)} staked | Conviction: ${h.convictionScore.toLocaleString()}`);
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/venetians",
+                tip: "Use venicestats_wallet to see the full profile of any holder.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=leaderboard.js.map

package/dist/tools/leaderboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.js","sourceRoot":"","sources":["../../src/tools/leaderboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAoB5C,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,mMAAmM,EACnM;QACE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,yGAAyG,CAAC;QAC1L,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KAC9G,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EACzF,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAkB,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAEzE,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC;YAE7H,MAAM,KAAK,GAAG;gBACZ,+BAA+B,CAAC,CAAC,OAAO,CAAC,MAAM,OAAO,SAAS,EAAE;gBACjE,IAAI,CAAC,CAAC,YAAY,CAAC,cAAc,EAAE,iBAAiB;gBACpD,EAAE;aACH,CAAC;YAEF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;gBACtE,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzF,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,CAAC,IAAI,OAAO,IAAI,QAAQ,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,OAAO,qBAAqB,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC,eAAe,CAAC,cAAc,EAAE,EAAE,CAChL,CAAC;YACJ,CAAC;YAED,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvC,QAAQ,EAAE,YAAY;gBACtB,GAAG,EAAE,+DAA+D;aACrE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/live.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLiveTool(server: McpServer): void;

package/dist/tools/live.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtToken, fmtUsd, fmtPct, fmtAgo } from "../lib/format.js";
+const TYPE_LABELS = {
+    buy: "🟢 BUY VVV",
+    sell: "🔴 SELL VVV",
+    buy_diem: "🟢 BUY DIEM",
+    sell_diem: "🔴 SELL DIEM",
+    stake: "📥 STAKE",
+    unstake: "📤 UNSTAKE",
+    claim: "🎁 CLAIM REWARDS",
+    finalize: "✅ FINALIZE UNSTAKE",
+    mint: "🔵 MINT DIEM",
+    burn: "🔥 BURN",
+};
+export function registerLiveTool(server) {
+    server.tool("venicestats_live", "Get a real-time feed of on-chain activity: swaps (buy/sell), staking events (stake, unstake, claim, finalize), DIEM events (mint, burn, stake), and vesting claims. Shows what is happening RIGHT NOW on Venice. Use when someone asks what's happening today, recent activity, or real-time events.", {
+        limit: z.number().int().min(1).max(50).default(20).describe("Number of events to return (1-50, default 20)"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ limit }) => {
+        try {
+            const d = await apiGet("/api/live", { limit });
+            const p = d.prices;
+            const lines = [
+                `## Live Feed (${d.events.length} events)`,
+                `VVV: ${fmtUsd(p.vvv)} (${fmtPct(p.vvvChange24h)}) | 24h Vol: ${fmtUsd(p.vvvVolume24h)}`,
+                `DIEM: ${fmtUsd(p.diem)} (${fmtPct(p.diemChange24h)}) | 24h Vol: ${fmtUsd(p.diemVolume24h)}`,
+                "",
+            ];
+            for (const e of d.events) {
+                const label = TYPE_LABELS[e.type] || e.type.toUpperCase();
+                const name = e.ensName || e.username || `${e.address.slice(0, 8)}...`;
+                const bot = e.botLabel ? ` [${e.botLabel}]` : "";
+                const token = e.source === "swap"
+                    ? (e.type.includes("diem") ? "DIEM" : "VVV")
+                    : (e.source === "diem" ? "DIEM" : "VVV");
+                lines.push(`- ${label} ${fmtToken(e.amount, token)} by ${name}${bot} — ${fmtAgo(e.timestamp)}`);
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/terminal",
+                tip: "Use venicestats_large_trades for filtered large trades, or venicestats_wallet to look up any address.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=live.js.map

package/dist/tools/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/tools/live.ts"],"names":[],"mappings":"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"}

package/dist/tools/market-volume.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMarketVolumeTool(server: McpServer): void;

package/dist/tools/market-volume.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtUsd, fmtPct } from "../lib/format.js";
+export function registerMarketVolumeTool(server) {
+    server.tool("venicestats_market_volume", "Get DEX trading volume for VVV or DIEM: total volume, buy/sell ratio, trader count, and breakdown by pool (Aerodrome, Uniswap, RFQ). Use when someone asks about trading activity, volume, or market dynamics.", {
+        token: z.enum(["VVV", "DIEM"]).default("VVV").describe("Token to view market data for"),
+        period: z.enum(["24h", "7d", "30d", "90d", "1y", "all"]).default("24h").describe("Lookback period"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ token, period }) => {
+        try {
+            const d = await apiGet("/api/markets", { token, period });
+            const volChange = d.kpis.volumePrev > 0
+                ? ((d.kpis.volume - d.kpis.volumePrev) / d.kpis.volumePrev) * 100
+                : 0;
+            const traderChange = d.kpis.tradersPrev > 0
+                ? ((d.kpis.traders - d.kpis.tradersPrev) / d.kpis.tradersPrev) * 100
+                : 0;
+            const lines = [
+                `## ${token} Market — ${period}`,
+                `Volume: ${fmtUsd(d.kpis.volume)} (${fmtPct(volChange)} vs prev period)`,
+                `Buy/Sell: ${d.kpis.buyPct}% buy / ${100 - d.kpis.buyPct}% sell`,
+                `Traders: ${d.kpis.traders.toLocaleString()} (${fmtPct(traderChange)}) | Swaps: ${d.kpis.swaps.toLocaleString()}`,
+                "",
+                `## Pool Breakdown`,
+                ...d.pools
+                    .filter((p) => p.volume > 0)
+                    .map((p) => `- **${p.name}** (${p.dex}): ${fmtUsd(p.volume)} (${p.volumePct}%) — ${p.swaps} swaps, ${p.buyPct}% buy`),
+            ];
+            return brandedResponse(lines.join("\n"), {
+                deepLink: `/markets?token=${token}&period=${period}`,
+                tip: "Use venicestats_large_trades for individual large trades, or venicestats_insider_flow for vesting recipient activity.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=market-volume.js.map

package/dist/tools/market-volume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-volume.js","sourceRoot":"","sources":["../../src/tools/market-volume.ts"],"names":[],"mappings":"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"}

package/dist/tools/price.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPriceTool(server: McpServer): void;

package/dist/tools/price.js

@@ -0,0 +1,28 @@
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtUsd, fmtPct } from "../lib/format.js";
+export function registerPriceTool(server) {
+    server.tool("venicestats_price", "Get current VVV and DIEM token prices with 24h changes, market cap, and FDV. Use this when someone asks about Venice token prices.", { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => {
+        try {
+            const data = await apiGet("/api/metrics");
+            const lines = [
+                `## VVV Price: ${fmtUsd(data.vvvPrice)} (${fmtPct(data.priceChange24h)})`,
+                `Market Cap: ${fmtUsd(data.marketCap)} | FDV: ${fmtUsd(data.fdv)}`,
+                "",
+                `## DIEM Price: ${fmtUsd(data.diemPrice)} (${fmtPct(data.diemPriceChange24h)})`,
+                `Market Cap: ${fmtUsd(data.diemMarketCap)} | FDV: ${fmtUsd(data.diemFdv)}`,
+            ];
+            if (data.priceStale) {
+                lines.push("", "⚠️ Price data may be stale — last updated: " + (data.priceLastUpdated ?? "unknown"));
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/",
+                tip: "Use venicestats_staking for yield and staking details, or venicestats_protocol_overview for a full snapshot.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=price.js.map

package/dist/tools/price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../src/tools/price.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAelD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,oIAAoI,EACpI,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EACzF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAkB,cAAc,CAAC,CAAC;YAE3D,MAAM,KAAK,GAAG;gBACZ,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG;gBACzE,eAAe,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBAClE,EAAE;gBACF,kBAAkB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG;gBAC/E,eAAe,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;aAC3E,CAAC;YAEF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,6CAA6C,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,SAAS,CAAC,CAAC,CAAC;YACvG,CAAC;YAED,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvC,QAAQ,EAAE,GAAG;gBACb,GAAG,EAAE,8GAA8G;aACpH,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/protocol-overview.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerProtocolOverviewTool(server: McpServer): void;

package/dist/tools/protocol-overview.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtUsd, fmtToken, fmtPct, fmtRatio } from "../lib/format.js";
+const CATEGORIES = ["token", "staking", "diem", "burns", "economics", "growth", "vesting"];
+function formatCategory(cat, d) {
+    switch (cat) {
+        case "token":
+            return [
+                `## Token`,
+                `Price: ${fmtUsd(d.vvvPrice)} (${fmtPct(d.priceChange24h)})`,
+                `Market Cap: ${fmtUsd(d.marketCap)} | FDV: ${fmtUsd(d.fdv)}`,
+                `Total Supply: ${fmtToken(d.totalSupply, "VVV")}`,
+                `Circulating: ${fmtToken(d.circulatingSupply)} | Burned: ${fmtToken(d.burnedSupply)}`,
+            ];
+        case "staking":
+            return [
+                `## Staking`,
+                `Total Staked: ${fmtToken(d.totalStaked, "sVVV")} (${fmtRatio(d.stakingRatio)})`,
+                `APR: ${d.stakerApr.toFixed(1)}% | Locked: ${fmtToken(d.svvvLocked)} (${fmtRatio(d.lockRatio)})`,
+                `Emission: ${fmtToken(d.emissionPerYear, "VVV")}/year`,
+            ];
+        case "diem":
+            return [
+                `## DIEM`,
+                `Price: ${fmtUsd(d.diemPrice)} (${fmtPct(d.diemPriceChange24h)})`,
+                `Supply: ${fmtToken(d.diemSupply, "DIEM")} | Staked: ${fmtToken(d.diemStaked)} (${fmtRatio(d.diemStakeRatio)})`,
+                `Mint Rate: ${Math.round(d.mintRate)} sVVV/DIEM | Mint Cost: ${fmtUsd(d.mintCostUsd)}`,
+                `Market Discount: ${fmtRatio(1 - d.mintParity)} vs mint cost`,
+                `Break-even: ${d.diemBreakEvenDays} days | Remaining mintable: ${fmtToken(d.remainingMintable, "DIEM")}`,
+            ];
+        case "burns":
+            return [
+                `## Burns & Revenue`,
+                `Total Burned: ${fmtToken(d.totalBurnedFromEvents, "VVV")} (${fmtToken(d.organicBurned)} organic)`,
+                `Annualized Revenue: ${fmtUsd(d.burnRevenueAnnualized)}`,
+                `Deflation Rate: ${d.burnDeflationRate.toFixed(2)}%/year`,
+            ];
+        case "economics":
+            return [
+                `## Economics`,
+                `Ecosystem TVL: ${fmtUsd(d.ecosystemTvl)}`,
+                `Venice Revenue (est.): ${fmtUsd(d.veniceRevenue)}/year`,
+                `P/E Ratio: ${d.peRatio.toFixed(1)}`,
+                `Implied Confidence: ${d.impliedConfidence.toFixed(2)}x`,
+            ];
+        case "growth":
+            return [
+                `## Growth & Activity`,
+                `Net Flow (7d): ${fmtToken(d.netFlow7d, "VVV")}`,
+                `Staking Growth: 7d ${fmtPct(d.stakingGrowth7d)} | 30d ${fmtPct(d.stakingGrowth30d)}`,
+                `New Stakers (7d): ${d.newStakers7dCount} | Active Wallets: ${d.activeWallets7dCount}`,
+                `Cooldown: ${fmtToken(d.cooldownVvv, "VVV")} across ${d.cooldownWallets} wallets`,
+            ];
+        case "vesting":
+            return [
+                `## Vesting`,
+                `Locked: ${fmtToken(d.vestingTotalLocked, "VVV")}`,
+                `Daily Drip: ${fmtToken(d.vestingDailyDrip, "VVV")}/day`,
+                `Active Streams: ${d.vestingActiveStreams}`,
+            ];
+        default:
+            return [];
+    }
+}
+export function registerProtocolOverviewTool(server) {
+    server.tool("venicestats_protocol_overview", "Get a comprehensive Venice protocol snapshot with 40+ KPIs organized by category: token, staking, diem, burns, economics, growth, vesting. Use the category parameter to focus on one area, or omit it for the full picture. This is the most complete overview tool.", {
+        category: z.enum(CATEGORIES).optional().describe("Focus on a specific category. Omit for full overview."),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ category }) => {
+        try {
+            const d = await apiGet("/api/metrics");
+            const cats = category ? [category] : [...CATEGORIES];
+            const sections = cats.flatMap((c) => [...formatCategory(c, d), ""]);
+            return brandedResponse(sections.join("\n"), {
+                deepLink: "/",
+                tip: category
+                    ? `Omit the category parameter to see the full protocol overview.`
+                    : "Use venicestats_price for a quick price check, or venicestats_wallet to look up a specific holder.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=protocol-overview.js.map

package/dist/tools/protocol-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-overview.js","sourceRoot":"","sources":["../../src/tools/protocol-overview.ts"],"names":[],"mappings":"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"}

package/dist/tools/social.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSocialTool(server: McpServer): void;

package/dist/tools/social.js

@@ -0,0 +1,38 @@
+import { apiGet, ApiError } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+export function registerSocialTool(server) {
+    server.tool("venicestats_social", "Get social and sentiment metrics for Venice: Twitter followers (@AskVenice, @ErikVoorhees), CoinGecko watchlist users, sentiment percentage, social volume, and social dominance. Use when someone asks about community sentiment, social metrics, or whether the mood is bullish or bearish.", { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => {
+        try {
+            const d = await apiGet("/api/social");
+            const lines = [
+                `## Venice Social Metrics`,
+            ];
+            if (d.twitterFollowers != null)
+                lines.push(`Twitter Followers: ${d.twitterFollowers.toLocaleString()}`);
+            if (d.watchlistUsers != null)
+                lines.push(`CoinGecko Watchlist: ${d.watchlistUsers.toLocaleString()}`);
+            if (d.sentimentUpPct != null)
+                lines.push(`Sentiment: ${d.sentimentUpPct}% bullish`);
+            if (d.marketCapRank != null)
+                lines.push(`Market Cap Rank: #${d.marketCapRank}`);
+            if (d.socialVolume != null)
+                lines.push(`Social Volume: ${Math.round(d.socialVolume)}`);
+            if (d.socialDominance != null)
+                lines.push(`Social Dominance: ${d.socialDominance.toFixed(4)}%`);
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/",
+                tip: "Use venicestats_buzz for recent articles and tweets about Venice.",
+            });
+        }
+        catch (err) {
+            if (err instanceof ApiError && (err.status === 404 || err.status === 500)) {
+                return brandedResponse("## Venice Social Metrics\n\nSocial data endpoint is not yet available — coming soon.\n\nVeniceStats tracks Twitter followers, CoinGecko watchlist/sentiment, and Santiment social volume. This data will be exposed via the API shortly.", {
+                    deepLink: "/",
+                    tip: "Use venicestats_buzz for recent articles and tweets about Venice in the meantime.",
+                });
+            }
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=social.js.map

package/dist/tools/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","sourceRoot":"","sources":["../../src/tools/social.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAapE,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,+RAA+R,EAC/R,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EACzF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAiB,aAAa,CAAC,CAAC;YAEtD,MAAM,KAAK,GAAG;gBACZ,0BAA0B;aAC3B,CAAC;YAEF,IAAI,CAAC,CAAC,gBAAgB,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,gBAAgB,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACxG,IAAI,CAAC,CAAC,cAAc,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACtG,IAAI,CAAC,CAAC,cAAc,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,cAAc,WAAW,CAAC,CAAC;YACpF,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;YAChF,IAAI,CAAC,CAAC,YAAY,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACvF,IAAI,CAAC,CAAC,eAAe,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAEhG,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvC,QAAQ,EAAE,GAAG;gBACb,GAAG,EAAE,mEAAmE;aACzE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC1E,OAAO,eAAe,CACpB,0OAA0O,EAC1O;oBACE,QAAQ,EAAE,GAAG;oBACb,GAAG,EAAE,mFAAmF;iBACzF,CACF,CAAC;YACJ,CAAC;YACD,OAAO,aAAa,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/staking.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStakingTool(server: McpServer): void;