@0xprotovox/deficlaw 0.1.1

package/dist/tools/getTopTraders.d.ts

@@ -0,0 +1,45 @@
+export declare function handleGetTopTraders(args: {
+    address: string;
+    limit?: number;
+}): Promise<{
+    error: string;
+    token?: undefined;
+    totalHoldersAnalyzed?: undefined;
+    profitSummary?: undefined;
+    topWinners?: undefined;
+    topLosers?: undefined;
+} | {
+    token: string;
+    totalHoldersAnalyzed: number;
+    profitSummary: {
+        totalProfit: number;
+        totalLoss: number;
+        profitableCount: number;
+        losingCount: number;
+    };
+    topWinners: {
+        address: string;
+        pnl: number;
+        profitMultiple: number;
+        tags: string[];
+        twitterHandle: string | null;
+        buyTx: number;
+        sellTx: number;
+        stillHolding: boolean;
+        isDeployer: boolean;
+        isDiamondHands: boolean;
+    }[];
+    topLosers: {
+        address: string;
+        pnl: number;
+        profitMultiple: number;
+        tags: string[];
+        twitterHandle: string | null;
+        buyTx: number;
+        sellTx: number;
+        stillHolding: boolean;
+        isDeployer: boolean;
+        isDiamondHands: boolean;
+    }[];
+    error?: undefined;
+}>;

package/dist/tools/getTopTraders.js

@@ -0,0 +1,44 @@
+/**
+ * get_top_traders tool — Who made/lost money on a token
+ * Uses GMGN holder data already collected by analyze_token
+ */
+import * as gmgn from '../sources/gmgn.js';
+export async function handleGetTopTraders(args) {
+    const limit = args.limit || 10;
+    if (!(await gmgn.isPlaywrightAvailable())) {
+        return { error: 'Playwright not installed. Run: npm install playwright && npx playwright install chromium' };
+    }
+    const { holders } = await gmgn.getHolders(args.address);
+    if (holders.length === 0)
+        return { error: 'No holder data found' };
+    const withPnl = holders.filter(h => h.totalPnl !== 0);
+    const winners = [...withPnl].sort((a, b) => b.totalPnl - a.totalPnl).slice(0, limit);
+    const losers = [...withPnl].sort((a, b) => a.totalPnl - b.totalPnl).slice(0, limit);
+    const totalProfit = withPnl.filter(h => h.totalPnl > 0).reduce((s, h) => s + h.totalPnl, 0);
+    const totalLoss = withPnl.filter(h => h.totalPnl < 0).reduce((s, h) => s + h.totalPnl, 0);
+    const format = (h) => ({
+        address: h.address,
+        pnl: Math.round(h.totalPnl * 100) / 100,
+        profitMultiple: Math.round(h.profitMultiple * 100) / 100,
+        tags: h.tags,
+        twitterHandle: h.twitterHandle,
+        buyTx: h.buyTxCount,
+        sellTx: h.sellTxCount,
+        stillHolding: h.balance > 0,
+        isDeployer: h.isDeployer,
+        isDiamondHands: h.tags.some(t => /diamond/i.test(t)),
+    });
+    return {
+        token: args.address,
+        totalHoldersAnalyzed: holders.length,
+        profitSummary: {
+            totalProfit: Math.round(totalProfit),
+            totalLoss: Math.round(totalLoss),
+            profitableCount: withPnl.filter(h => h.totalPnl > 0).length,
+            losingCount: withPnl.filter(h => h.totalPnl < 0).length,
+        },
+        topWinners: winners.map(format),
+        topLosers: losers.map(format),
+    };
+}
+//# sourceMappingURL=getTopTraders.js.map

package/dist/tools/getTopTraders.js.map

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

package/dist/tools/getTrending.d.ts

@@ -0,0 +1,9 @@
+export declare function handleGetTrending(args: {
+    chain?: string;
+    limit?: number;
+}): Promise<{
+    chain: string;
+    count: number;
+    tokens: any[];
+    fetchedAt: string;
+}>;

package/dist/tools/getTrending.js

@@ -0,0 +1,16 @@
+/**
+ * get_trending tool — Trending/boosted tokens
+ */
+import { getTrending } from '../sources/dexscreener.js';
+export async function handleGetTrending(args) {
+    const chain = args.chain || 'solana';
+    const limit = args.limit || 20;
+    const tokens = await getTrending(chain, limit);
+    return {
+        chain,
+        count: tokens.length,
+        tokens,
+        fetchedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=getTrending.js.map

package/dist/tools/getTrending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTrending.js","sourceRoot":"","sources":["../../src/tools/getTrending.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAwC;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAE/C,OAAO;QACL,KAAK;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,127 @@
+export interface DexPair {
+    chainId: string;
+    dexId: string;
+    pairAddress: string;
+    baseToken: {
+        address: string;
+        name: string;
+        symbol: string;
+    };
+    quoteToken: {
+        address: string;
+        name: string;
+        symbol: string;
+    };
+    priceNative: string;
+    priceUsd: string;
+    volume: {
+        h24: number;
+        h6: number;
+        h1: number;
+        m5: number;
+    };
+    priceChange: {
+        h24: number;
+        h6: number;
+        h1: number;
+        m5: number;
+    };
+    liquidity: {
+        usd: number;
+        base: number;
+        quote: number;
+    };
+    fdv: number;
+    marketCap: number;
+    info?: {
+        imageUrl?: string;
+        websites?: {
+            url: string;
+        }[];
+        socials?: {
+            type: string;
+            url: string;
+        }[];
+    };
+    pairCreatedAt?: number;
+}
+export interface Holder {
+    address: string;
+    tags: string[];
+    twitterHandle: string | null;
+    twitterName: string | null;
+    name: string | null;
+    balance: number;
+    supplyPercent: number;
+    valueUsd: number;
+    avgBuyPrice: number;
+    cost: number;
+    unrealizedPnl: number;
+    realizedPnl: number;
+    totalPnl: number;
+    profitMultiple: number;
+    buyAmount: number;
+    sellAmount: number;
+    buyTxCount: number;
+    sellTxCount: number;
+    isDeployer: boolean;
+    isFreshWallet: boolean;
+    lastActiveAt: string | null;
+}
+export interface RiskFlag {
+    type: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    message: string;
+}
+export interface RiskAssessment {
+    score: number;
+    level: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    flags: RiskFlag[];
+    summary: string;
+}
+export interface TokenAnalysis {
+    token: {
+        address: string;
+        name: string;
+        symbol: string;
+        chain: string;
+        imageUrl?: string;
+    };
+    price: {
+        usd: number;
+        nativePrice: string;
+        change1h: number;
+        change24h: number;
+    };
+    market: {
+        marketCap: number;
+        fdv: number;
+        volume24h: number;
+        volume1h: number;
+        liquidity: number;
+        dex: string;
+        pairAddress: string;
+        pairCreatedAt?: string;
+    };
+    holders?: {
+        total: number;
+        top: Holder[];
+        devWallet: {
+            address: string;
+            holdingPercent: number;
+            status: string;
+        } | null;
+        distribution: {
+            top10Percent: number;
+            top20Percent: number;
+            freshWalletPercent: number;
+            sniperCount: number;
+            kolCount: number;
+        };
+    };
+    risk: RiskAssessment;
+    meta: {
+        sources: string[];
+        fetchTimeMs: number;
+    };
+}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@0xprotovox/deficlaw",
+  "version": "0.1.1",
+  "description": "DeFi MCP Server for Claude Code — token analysis, prices, trending, holder intelligence",
+  "author": "0xprotovox",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "deficlaw": "dist/index.js"
+  },
+  "main": "dist/server.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "playwright": "^1.58.2"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "defi",
+    "solana",
+    "crypto",
+    "token-analysis",
+    "claude-code",
+    "ai-tools"
+  ]
+}