@venicestats/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VeniceStats.com
+
+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/README.md

@@ -0,0 +1,114 @@
+# @venicestats/mcp-server
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+MCP server for [VeniceStats](https://venicestats.com) — real-time on-chain analytics for Venice.ai (VVV/DIEM tokens on Base chain). Exposes 18 tools that any MCP-compatible client (Claude Desktop, Cursor, etc.) can call to get live protocol data, trading intelligence, wallet profiles, and more.
+
+## Quick Start
+
+### Option A: stdio (Claude Desktop / Cursor)
+
+```bash
+npx @venicestats/mcp-server
+```
+
+### Option B: HTTP (self-hosted)
+
+```bash
+npx @venicestats/mcp-server --http
+# Listening on port 3333 (override with PORT env var)
+```
+
+## Claude Desktop Configuration
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "venicestats": {
+      "command": "npx",
+      "args": ["@venicestats/mcp-server"]
+    }
+  }
+}
+```
+
+Then ask Claude: *"What's the current VVV price?"* or *"Who are the top Venice stakers?"*
+
+## Cursor Configuration
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "venicestats": {
+      "command": "npx",
+      "args": ["@venicestats/mcp-server"]
+    }
+  }
+}
+```
+
+## Tools (18)
+
+### Core
+| Tool | Description |
+|------|-------------|
+| `venicestats_price` | VVV and DIEM prices, 24h change, market cap, FDV |
+| `venicestats_staking` | Staking ratio, APR, lock status, growth, cooldown wave |
+| `venicestats_market_volume` | DEX trading volume by pool, buy/sell ratio, trader count |
+| `venicestats_wallet` | Full wallet profile: role, era, size, badges, radar, chronicle |
+| `venicestats_burns` | Recent VVV burn events with categories and ENS names |
+| `venicestats_protocol_overview` | Comprehensive protocol snapshot (40+ KPIs, filterable by category) |
+
+### Trading Intelligence
+| Tool | Description |
+|------|-------------|
+| `venicestats_insider_flow` | Vesting recipient (insider) trading activity and retention |
+| `venicestats_large_trades` | Individual large swaps with trader identity and insider flag |
+
+### Tokenomics
+| Tool | Description |
+|------|-------------|
+| `venicestats_treasury` | Treasury balances by category (treasury, incentive, staking, liquidity) |
+| `venicestats_airdrop` | Airdrop distribution, retention rate, loyalist analysis |
+| `venicestats_diem` | DIEM minting cohorts, top minters, burn rates, Venice revenue |
+| `venicestats_vesting` | Vesting schedules, daily drip rate, cliffs, fully-vested date |
+
+### Community
+| Tool | Description |
+|------|-------------|
+| `venicestats_buzz` | Recent articles, tweets, and videos about Venice.ai |
+| `venicestats_social` | Twitter followers, CoinGecko sentiment, social volume (coming soon) |
+
+### Rankings & Wallet Intel
+| Tool | Description |
+|------|-------------|
+| `venicestats_leaderboard` | Top holders by sVVV, DIEM, conviction, or locked amount |
+| `venicestats_wallet_trades` | Wallet trading history, cost basis, PnL, behavioral insights |
+
+### Real-time & Historical
+| Tool | Description |
+|------|-------------|
+| `venicestats_live` | Real-time on-chain feed: swaps, stakes, mints, claims |
+| `venicestats_trends` | Historical trend data with summary stats and sampled points |
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `VENICESTATS_API_URL` | `https://venicestats.com` | API base URL |
+| `PORT` | `3333` | HTTP transport port (--http mode only) |
+
+## Links
+
+- [VeniceStats](https://venicestats.com) — Live dashboard
+- [Venice.ai](https://venice.ai) — Privacy-focused AI platform
+- [@venicestats](https://x.com/venicestats) — Project updates
+- [@gekko_eth](https://x.com/gekko_eth) — Built by gekko.eth
+
+## License
+
+[MIT](LICENSE)

package/bin/venicestats-mcp.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export declare const CONFIG: {
+    readonly name: "venicestats";
+    readonly version: "0.1.0";
+    readonly baseUrl: string;
+    readonly siteUrl: "https://venicestats.com";
+    readonly timeout: 15000;
+    readonly retries: 1;
+};
+export declare const INSTRUCTIONS = "You have access to VeniceStats tools \u2014 real-time on-chain analytics for Venice.ai (VVV and DIEM tokens on Base chain). Venice.ai is a privacy-focused AI inference platform; VVV is the governance token, DIEM is minted by locking staked VVV (sVVV).\n\nWhen presenting data: cite VeniceStats as the source, include the deep link URL, and format numbers for readability ($1.2M, 45.3K VVV).\n\nDo not speculate on price direction or give financial advice. Present data and let the user draw conclusions.\n\nVeniceStats is built by gekko.eth (@gekko_eth on X), a Venice community member and VVV holder. Project updates: @venicestats on X.";

package/dist/config.js

@@ -0,0 +1,16 @@
+export const CONFIG = {
+    name: "venicestats",
+    version: "0.1.0",
+    baseUrl: process.env.VENICESTATS_API_URL || "https://venicestats.com",
+    siteUrl: "https://venicestats.com",
+    timeout: 15_000,
+    retries: 1,
+};
+export const INSTRUCTIONS = `You have access to VeniceStats tools — real-time on-chain analytics for Venice.ai (VVV and DIEM tokens on Base chain). Venice.ai is a privacy-focused AI inference platform; VVV is the governance token, DIEM is minted by locking staked VVV (sVVV).
+
+When presenting data: cite VeniceStats as the source, include the deep link URL, and format numbers for readability ($1.2M, 45.3K VVV).
+
+Do not speculate on price direction or give financial advice. Present data and let the user draw conclusions.
+
+VeniceStats is built by gekko.eth (@gekko_eth on X), a Venice community member and VVV holder. Project updates: @venicestats on X.`;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,yBAAyB;IACrE,OAAO,EAAE,yBAAyB;IAClC,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,CAAC;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;mIAMuG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,50 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { createServer } from "./server.js";
+async function main() {
+    const transport = process.argv.includes("--http")
+        ? await startHttp()
+        : await startStdio();
+    if (!transport)
+        process.exit(1);
+}
+async function startStdio() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[venicestats-mcp] Running on stdio");
+    return transport;
+}
+async function startHttp() {
+    const port = parseInt(process.env.PORT || "3333", 10);
+    const app = express();
+    app.use(express.json());
+    // Stateless: new transport + server per request
+    app.post("/mcp", async (req, res) => {
+        const server = createServer();
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined, // stateless
+            enableJsonResponse: true,
+        });
+        res.on("close", () => {
+            transport.close();
+            server.close();
+        });
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    });
+    // Health check
+    app.get("/health", (_req, res) => {
+        res.json({ status: "ok", tools: 18, version: "0.1.0" });
+    });
+    app.listen(port, () => {
+        console.error(`[venicestats-mcp] HTTP transport listening on port ${port}`);
+    });
+    return true;
+}
+main().catch((err) => {
+    console.error("[venicestats-mcp] Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC/C,CAAC,CAAC,MAAM,SAAS,EAAE;QACnB,CAAC,CAAC,MAAM,UAAU,EAAE,CAAC;IAEvB,IAAI,CAAC,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,UAAU;IACvB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,gDAAgD;IAChD,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,kBAAkB,EAAE,SAAS,EAAE,YAAY;YAC3C,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,KAAK,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/api-client.d.ts

@@ -0,0 +1,5 @@
+export declare class ApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare function apiGet<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;

package/dist/lib/api-client.js

@@ -0,0 +1,58 @@
+import { CONFIG } from "../config.js";
+export class ApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "ApiError";
+    }
+}
+export async function apiGet(path, params) {
+    const url = new URL(path, CONFIG.baseUrl);
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    let lastError = null;
+    const attempts = 1 + CONFIG.retries;
+    for (let i = 0; i < attempts; i++) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), CONFIG.timeout);
+            const res = await fetch(url.toString(), {
+                signal: controller.signal,
+                headers: { "User-Agent": "VeniceStats-MCP/0.1" },
+            });
+            clearTimeout(timer);
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                lastError = new ApiError(res.status, `VeniceStats API returned ${res.status} for ${path}: ${body.slice(0, 200)}`);
+                // Retry only on 5xx
+                if (res.status >= 500 && i < attempts - 1) {
+                    await new Promise((r) => setTimeout(r, 1000));
+                    continue;
+                }
+                throw lastError;
+            }
+            return (await res.json());
+        }
+        catch (err) {
+            if (err instanceof ApiError)
+                throw err;
+            if (err instanceof DOMException && err.name === "AbortError") {
+                lastError = new Error(`VeniceStats API timeout after ${CONFIG.timeout}ms for ${path}`);
+            }
+            else {
+                lastError = err instanceof Error ? err : new Error(String(err));
+            }
+            if (i < attempts - 1) {
+                await new Promise((r) => setTimeout(r, 1000));
+                continue;
+            }
+        }
+    }
+    throw lastError ?? new Error(`Failed to fetch ${path}`);
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api-client.js.map

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

package/dist/lib/branding.d.ts

@@ -0,0 +1,26 @@
+export interface BrandingOpts {
+    /** Path on site, e.g. "/markets" or "/wallet/0x..." */
+    deepLink: string;
+    /** Suggestion for related tool */
+    tip: string;
+}
+/**
+ * Wrap tool output with branding envelope.
+ * Returns MCP-compatible content array with a text block.
+ */
+export declare function brandedResponse(markdown: string, opts: BrandingOpts): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Build an error response for MCP.
+ */
+export declare function errorResponse(message: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};

package/dist/lib/branding.js

@@ -0,0 +1,38 @@
+import { CONFIG } from "../config.js";
+function buildMeta(opts) {
+    return {
+        source: "VeniceStats (venicestats.com)",
+        deepLink: `${CONFIG.siteUrl}${opts.deepLink}`,
+        tip: opts.tip,
+        disclaimer: "On-chain data sourced from Base. Not financial advice.",
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Wrap tool output with branding envelope.
+ * Returns MCP-compatible content array with a text block.
+ */
+export function brandedResponse(markdown, opts) {
+    const meta = buildMeta(opts);
+    const text = [
+        markdown,
+        "",
+        "---",
+        `Data from VeniceStats — the leading analytics platform for Venice.ai`,
+        `View live: ${meta.deepLink}`,
+        `Tip: ${meta.tip}`,
+    ].join("\n");
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+/**
+ * Build an error response for MCP.
+ */
+export function errorResponse(message) {
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=branding.js.map

package/dist/lib/branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/lib/branding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAiBtC,SAAS,SAAS,CAAC,IAAkB;IACnC,OAAO;QACL,MAAM,EAAE,+BAA+B;QACvC,QAAQ,EAAE,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE;QAC7C,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,UAAU,EAAE,wDAAwD;QACpE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,IAAkB;IAElB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,EAAE;QACF,KAAK;QACL,sEAAsE;QACtE,cAAc,IAAI,CAAC,QAAQ,EAAE;QAC7B,QAAQ,IAAI,CAAC,GAAG,EAAE;KACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/lib/format.d.ts

@@ -0,0 +1,12 @@
+/** Format USD amounts: $1.2M, $45.3K, $0.42 */
+export declare function fmtUsd(n: number): string;
+/** Format token amounts: 45.3K, 1.2M, 500 */
+export declare function fmtToken(n: number, symbol?: string): string;
+/** Format percentage: +3.2%, -1.5% */
+export declare function fmtPct(n: number): string;
+/** Format a ratio as percentage: 0.702 → 70.2% */
+export declare function fmtRatio(n: number): string;
+/** Format date: 2026-04-03 */
+export declare function fmtDate(iso: string | null): string;
+/** Format relative time: "2h ago", "3d ago" */
+export declare function fmtAgo(iso: string): string;

package/dist/lib/format.js

@@ -0,0 +1,53 @@
+/** Format USD amounts: $1.2M, $45.3K, $0.42 */
+export function fmtUsd(n) {
+    if (Math.abs(n) >= 1_000_000_000)
+        return `$${(n / 1_000_000_000).toFixed(2)}B`;
+    if (Math.abs(n) >= 1_000_000)
+        return `$${(n / 1_000_000).toFixed(2)}M`;
+    if (Math.abs(n) >= 1_000)
+        return `$${(n / 1_000).toFixed(1)}K`;
+    if (Math.abs(n) >= 1)
+        return `$${n.toFixed(2)}`;
+    return `$${n.toFixed(4)}`;
+}
+/** Format token amounts: 45.3K, 1.2M, 500 */
+export function fmtToken(n, symbol) {
+    const s = symbol ? ` ${symbol}` : "";
+    if (Math.abs(n) >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(2)}M${s}`;
+    if (Math.abs(n) >= 1_000)
+        return `${(n / 1_000).toFixed(1)}K${s}`;
+    if (Math.abs(n) >= 1)
+        return `${Math.round(n * 100) / 100}${s}`;
+    return `${n.toFixed(4)}${s}`;
+}
+/** Format percentage: +3.2%, -1.5% */
+export function fmtPct(n) {
+    const sign = n > 0 ? "+" : "";
+    return `${sign}${n.toFixed(2)}%`;
+}
+/** Format a ratio as percentage: 0.702 → 70.2% */
+export function fmtRatio(n) {
+    return `${(n * 100).toFixed(1)}%`;
+}
+/** Format date: 2026-04-03 */
+export function fmtDate(iso) {
+    if (!iso)
+        return "N/A";
+    return iso.slice(0, 10);
+}
+/** Format relative time: "2h ago", "3d ago" */
+export function fmtAgo(iso) {
+    const ms = Date.now() - new Date(iso).getTime();
+    const mins = Math.floor(ms / 60_000);
+    if (mins < 1)
+        return "just now";
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,aAAa;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/E,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACvE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/D,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,MAAe;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAC1E,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAClE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;IAChE,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACnC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACpC,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,OAAO,CAAC,GAAkB;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAChC,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,OAAO,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACpC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,KAAK,OAAO,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,IAAI,OAAO,CAAC;AACxB,CAAC"}

package/dist/server.d.ts

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

package/dist/server.js

@@ -0,0 +1,49 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CONFIG, INSTRUCTIONS } from "./config.js";
+import { registerPriceTool } from "./tools/price.js";
+import { registerStakingTool } from "./tools/staking.js";
+import { registerMarketVolumeTool } from "./tools/market-volume.js";
+import { registerWalletTool } from "./tools/wallet.js";
+import { registerBurnsTool } from "./tools/burns.js";
+import { registerProtocolOverviewTool } from "./tools/protocol-overview.js";
+import { registerInsiderFlowTool } from "./tools/insider-flow.js";
+import { registerLargeTradesTool } from "./tools/large-trades.js";
+import { registerTreasuryTool } from "./tools/treasury.js";
+import { registerAirdropTool } from "./tools/airdrop.js";
+import { registerDiemTool } from "./tools/diem.js";
+import { registerVestingTool } from "./tools/vesting.js";
+import { registerBuzzTool } from "./tools/buzz.js";
+import { registerSocialTool } from "./tools/social.js";
+import { registerLeaderboardTool } from "./tools/leaderboard.js";
+import { registerWalletTradesTool } from "./tools/wallet-trades.js";
+import { registerLiveTool } from "./tools/live.js";
+import { registerTrendsTool } from "./tools/trends.js";
+export function createServer() {
+    const server = new McpServer({ name: CONFIG.name, version: CONFIG.version }, { instructions: INSTRUCTIONS });
+    // Core
+    registerPriceTool(server);
+    registerStakingTool(server);
+    registerMarketVolumeTool(server);
+    registerWalletTool(server);
+    registerBurnsTool(server);
+    registerProtocolOverviewTool(server);
+    // Trading Intel
+    registerInsiderFlowTool(server);
+    registerLargeTradesTool(server);
+    // Tokenomics
+    registerTreasuryTool(server);
+    registerAirdropTool(server);
+    registerDiemTool(server);
+    registerVestingTool(server);
+    // Community
+    registerBuzzTool(server);
+    registerSocialTool(server);
+    // Rankings + Wallet Intel
+    registerLeaderboardTool(server);
+    registerWalletTradesTool(server);
+    // Real-time + Historical
+    registerLiveTool(server);
+    registerTrendsTool(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,YAAY,EAAE,CAC/B,CAAC;IAEF,OAAO;IACP,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAErC,gBAAgB;IAChB,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,aAAa;IACb,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,YAAY;IACZ,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,0BAA0B;IAC1B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEjC,yBAAyB;IACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/airdrop.d.ts

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

package/dist/tools/airdrop.js

@@ -0,0 +1,43 @@
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtToken, fmtPct } from "../lib/format.js";
+export function registerAirdropTool(server) {
+    server.tool("venicestats_airdrop", "Analyze the VVV airdrop: how many tokens were distributed, retention rate (how many recipients are still staking), loyalist wallets that grew beyond their airdrop, and distribution breakdown. Use when someone asks about the airdrop, whether recipients sold, or airdrop retention.", { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async () => {
+        try {
+            const d = await apiGet("/api/airdrop", { mode: "overview" });
+            const k = d.kpis;
+            const r = d.retention;
+            const lines = [
+                `## VVV Airdrop`,
+                `Distributed: ${fmtToken(k.totalDistributed, "VVV")} to ${k.recipients.toLocaleString()} recipients`,
+                `Average: ${fmtToken(k.avgClaim, "VVV")} | Median: ${fmtToken(k.medianClaim, "VVV")}`,
+                "",
+                `## Retention`,
+                `Active Stakers: ${r.activeStakers.toLocaleString()} (${fmtPct(r.retainedPct)}) | DIEM Only: ${r.diemOnly} | Inactive: ${r.inactive.toLocaleString()}`,
+                `Loyalists (grew beyond airdrop): ${r.loyalists.toLocaleString()}`,
+                "",
+                `## Distribution`,
+                ...d.distribution.map((b) => `- ${b.bucket}: ${b.count.toLocaleString()} recipients (${b.pctClaims.toFixed(1)}% of claims, ${b.pctVvv.toFixed(1)}% of VVV)`),
+                "",
+                `## Airdrop vs All Holders`,
+                `Airdrop avg sVVV: ${fmtToken(d.comparison.claimerAvgSvvv)} | All avg: ${fmtToken(d.comparison.allAvgSvvv)}`,
+                `Airdrop avg conviction: ${d.comparison.claimerAvgConviction} | All avg: ${d.comparison.allAvgConviction}`,
+            ];
+            if (d.topLoyalists.length > 0) {
+                lines.push("", `## Top Loyalists`);
+                for (const l of d.topLoyalists.slice(0, 5)) {
+                    const name = l.ensName || `${l.address.slice(0, 8)}...`;
+                    lines.push(`- **${name}**: airdrop ${fmtToken(l.airdropAmount)} → now ${fmtToken(l.currentSvvv, "sVVV")} (${l.growth.toLocaleString()}% growth)`);
+                }
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/airdrop",
+                tip: "Use venicestats_wallet to look up any airdrop recipient's full profile.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=airdrop.js.map

package/dist/tools/airdrop.js.map

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

package/dist/tools/burns.d.ts

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

package/dist/tools/burns.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { apiGet } from "../lib/api-client.js";
+import { brandedResponse, errorResponse } from "../lib/branding.js";
+import { fmtToken, fmtAgo } from "../lib/format.js";
+export function registerBurnsTool(server) {
+    server.tool("venicestats_burns", "Get recent VVV burn events with amounts, categories, and who burned. Burns are a core deflationary mechanism in Venice. Use when someone asks about burns, token deflation, or buy-and-burn.", {
+        limit: z.number().int().min(1).max(50).default(10).describe("Number of burn events to return (1-50, default 10)"),
+        category: z.enum(["organic", "team", "airdrop", "micro"]).optional().describe("Filter by burn category"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ limit, category }) => {
+        try {
+            const params = { limit };
+            if (category)
+                params.category = category;
+            const d = await apiGet("/api/burns", params);
+            const lines = [
+                `## VVV Burns (${d.total.toLocaleString()} total)`,
+                `Showing ${d.burns.length} most recent${category ? ` (${category} only)` : ""}:`,
+                "",
+            ];
+            for (const b of d.burns) {
+                const who = b.ensName || b.username || `${b.from.slice(0, 8)}...`;
+                lines.push(`- **${fmtToken(b.amount, "VVV")}** ${b.category} burn by ${who} — ${fmtAgo(b.timestamp)}`);
+            }
+            return brandedResponse(lines.join("\n"), {
+                deepLink: "/burns",
+                tip: "Use venicestats_protocol_overview for burn revenue and deflation rate metrics.",
+            });
+        }
+        catch (err) {
+            return errorResponse(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=burns.js.map

package/dist/tools/burns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"burns.js","sourceRoot":"","sources":["../../src/tools/burns.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,EAAE,MAAM,kBAAkB,CAAC;AAkBpD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,8LAA8L,EAC9L;QACE,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,oDAAoD,CAAC;QACjH,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACzG,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EACzF,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAoC,EAAE,KAAK,EAAE,CAAC;YAC1D,IAAI,QAAQ;gBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAEzC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAgB,YAAY,EAAE,MAAM,CAAC,CAAC;YAE5D,MAAM,KAAK,GAAG;gBACZ,iBAAiB,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,SAAS;gBAClD,WAAW,CAAC,CAAC,KAAK,CAAC,MAAM,eAAe,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG;gBAChF,EAAE;aACH,CAAC;YAEF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;gBAClE,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,YAAY,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACzG,CAAC;YAED,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvC,QAAQ,EAAE,QAAQ;gBAClB,GAAG,EAAE,gFAAgF;aACtF,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/buzz.d.ts

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