mpp32-mcp-server 1.4.0 → 1.4.1

package/dist/index.js

@@ -3,7 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { signX402Payment } from "./x402-signers.js";
-const SERVER_VERSION = "1.4.0";
+const SERVER_VERSION = "1.4.1";
 // ── Env loading: trim and sanitize aggressively ─────────────────────────────
 // Copy-paste from Claude Desktop / Cursor / Windsurf JSON config UIs frequently
 // adds trailing \n, \r, NBSP, BOM, or wraps the value in literal quotes. Any
@@ -575,7 +575,10 @@ server.tool("scan_portfolio_m32", "M32-gated full wallet portfolio scan. Discove
     }
 });
 // ── Tool 7: get_pivx_dao_intelligence ─────────────────────────────────────
-server.tool("get_pivx_dao_intelligence", "Get real-time PIVX DAO governance intelligence. Returns active budget proposals with masternode voting tallies (Yes/No/Abstain percentages), budget allocation status, network deflation metrics (unallocated treasury PIV that are never minted), and masternode network health. PIVX is a fully community-governed cryptocurrency where Masternode owners vote on budget proposals every ~30 days. Data sourced from pivx.org/proposals and the PIVX blockchain. Free — no payment required.", {
+// Self-contained: scrapes pivx.org/proposals + Chainz CryptoID directly.
+// Does NOT depend on any backend endpoint — works for every npm user out of the box.
+import { fetchPivxGovernance } from "./pivx-provider.js";
+server.tool("get_pivx_dao_intelligence", "Get real-time PIVX DAO governance intelligence. Returns active budget proposals with masternode voting tallies (Yes/No counts, net yes percentages), budget allocation status, network deflation metrics (unallocated treasury PIV that are never minted), and masternode network health. PIVX is a fully community-governed cryptocurrency where Masternode owners vote on budget proposals every ~30 days (43,200 blocks per superblock cycle, 432,000 PIV max monthly budget). Data scraped live from pivx.org/proposals and the PIVX blockchain via Chainz CryptoID. Cached for 5 minutes. Free — no payment or API key required.", {
     filter: z
         .enum(["all", "passing", "failing"])
         .default("all")
@@ -588,52 +591,31 @@ server.tool("get_pivx_dao_intelligence", "Get real-time PIVX DAO governance inte
         .describe("Include network stats and deflation metrics (default: true)."),
 }, async ({ filter, includeStats }) => {
     try {
-        const statusFilter = filter === "passing" || filter === "failing" ? `?status=${filter}` : "";
-        const endpoint = includeStats !== false ? "/api/governance" : `/api/governance/proposals${statusFilter}`;
-        const res = await fetchWithTimeout(`${API_URL}${endpoint}`, {
-            headers: buildHeaders(),
-        });
-        if (!res.ok) {
-            const err = await res.json().catch(() => null);
-            return {
-                content: [{
-                        type: "text",
-                        text: `Error fetching PIVX governance data: ${err?.error?.message ?? `HTTP ${res.status}`}`,
-                    }],
-            };
-        }
-        const json = await res.json();
-        const data = json.data;
-        // Build readable output
+        const gov = await fetchPivxGovernance();
         const lines = [];
         lines.push("# PIVX DAO Governance Intelligence");
         lines.push("");
-        // Network stats
-        const network = data.network;
-        if (network) {
+        if (includeStats !== false) {
+            const n = gov.network;
             lines.push("## Network Overview");
-            lines.push(`- **Masternodes Online:** ${network.masternodeCount}`);
-            lines.push(`- **Passing Threshold:** ${network.passingThreshold} votes (10% of masternodes)`);
-            lines.push(`- **Monthly Budget:** ${Number(network.monthlyBudgetPiv).toLocaleString()} PIV (~$${Number(network.monthlyBudgetUsd).toLocaleString()})`);
-            lines.push(`- **Budget Allocated:** ${Number(network.budgetAllocatedPiv).toLocaleString()} PIV (${network.budgetAllocatedPercent}%)`);
-            if (network.blockHeight)
-                lines.push(`- **Block Height:** ${Number(network.blockHeight).toLocaleString()}`);
-            if (network.totalSupply)
-                lines.push(`- **Total Supply:** ${Math.round(Number(network.totalSupply)).toLocaleString()} PIV`);
+            lines.push(`- **Masternodes Online:** ${n.masternodeCount.toLocaleString()}`);
+            lines.push(`- **Passing Threshold:** ${n.passingThreshold} votes (10% of masternodes)`);
+            lines.push(`- **Monthly Budget:** ${n.monthlyBudgetPiv.toLocaleString()} PIV (~$${n.monthlyBudgetUsd.toLocaleString()})`);
+            lines.push(`- **Budget Allocated:** ${n.budgetAllocatedPiv.toLocaleString()} PIV (${n.budgetAllocatedPercent}%)`);
+            if (n.blockHeight)
+                lines.push(`- **Block Height:** ${n.blockHeight.toLocaleString()}`);
+            if (n.totalSupply)
+                lines.push(`- **Total Supply:** ${Math.round(n.totalSupply).toLocaleString()} PIV`);
             lines.push("");
-        }
-        // Deflation stats
-        const deflation = data.deflation;
-        if (deflation) {
+            const d = gov.deflation;
             lines.push("## Deflation / Fee Burn Metrics");
-            lines.push(`- **Unallocated PIV This Cycle:** ${Number(deflation.unallocatedPivPerCycle).toLocaleString()} PIV (never minted)`);
-            lines.push(`- **Annual Unallocated (est.):** ${Number(deflation.annualUnallocatedPiv).toLocaleString()} PIV`);
-            lines.push(`- **Effective Inflation Reduction:** ${deflation.effectiveInflationReduction}`);
-            lines.push(`- **Proposal Submission Fee:** ${deflation.proposalFeeBurnPiv} PIV (burned/destroyed)`);
+            lines.push(`- **Unallocated PIV This Cycle:** ${d.unallocatedPivPerCycle.toLocaleString()} PIV (never minted)`);
+            lines.push(`- **Annual Unallocated (est.):** ${d.annualUnallocatedPiv.toLocaleString()} PIV`);
+            lines.push(`- **Effective Inflation Reduction:** ${d.effectiveInflationReduction}`);
+            lines.push(`- **Proposal Submission Fee:** ${d.proposalFeeBurnPiv} PIV (burned/destroyed)`);
             lines.push("");
         }
-        // Proposals
-        let proposals = (data.proposals ?? []);
+        let proposals = gov.proposals;
         if (filter === "passing")
             proposals = proposals.filter((p) => p.status === "passing");
         else if (filter === "failing")
@@ -646,11 +628,11 @@ server.tool("get_pivx_dao_intelligence", "Get real-time PIVX DAO governance inte
                 const fundedTag = p.funded ? " (Funded)" : "";
                 lines.push(`### ${p.name} — ${status}${fundedTag}`);
                 lines.push(`- **Votes:** ${p.yesVotes} Yes / ${p.noVotes} No (${p.netYesPercent}% net yes)`);
-                lines.push(`- **Monthly Payment:** ${Number(p.monthlyPaymentPiv).toLocaleString()} PIV (~$${Number(p.monthlyPaymentUsd).toLocaleString()})`);
-                if (Number(p.totalPaymentPiv) > Number(p.monthlyPaymentPiv)) {
-                    lines.push(`- **Total Budget:** ${Number(p.totalPaymentPiv).toLocaleString()} PIV`);
+                lines.push(`- **Monthly Payment:** ${p.monthlyPaymentPiv.toLocaleString()} PIV (~$${p.monthlyPaymentUsd.toLocaleString()})`);
+                if (p.totalPaymentPiv > p.monthlyPaymentPiv) {
+                    lines.push(`- **Total Budget:** ${p.totalPaymentPiv.toLocaleString()} PIV`);
                 }
-                if (Number(p.installmentsRemaining) > 0) {
+                if (p.installmentsRemaining > 0) {
                     lines.push(`- **Installments Remaining:** ${p.installmentsRemaining}`);
                 }
                 if (p.budgetPercent)
@@ -663,12 +645,8 @@ server.tool("get_pivx_dao_intelligence", "Get real-time PIVX DAO governance inte
         else {
             lines.push("No proposals found matching the filter.");
         }
-        // Meta
-        const meta = data.meta;
-        if (meta) {
-            lines.push("---");
-            lines.push(`Source: ${meta.source} | ${meta.timestamp}${meta.cacheHit ? " (cached)" : ""}`);
-        }
+        lines.push("---");
+        lines.push(`Source: ${gov.source} | ${gov.timestamp}${gov.cacheHit ? " (cached)" : ""}`);
         return {
             content: [{ type: "text", text: lines.join("\n") }],
         };
@@ -677,7 +655,7 @@ server.tool("get_pivx_dao_intelligence", "Get real-time PIVX DAO governance inte
         return {
             content: [{
                     type: "text",
-                    text: `Failed to fetch PIVX governance data: ${err instanceof Error ? err.message : String(err)}`,
+                    text: `Failed to fetch PIVX governance data: ${err instanceof Error ? err.message : String(err)}. The tool scrapes pivx.org/proposals directly — the site may be temporarily unreachable.`,
                 }],
         };
     }

package/dist/pivx-provider.d.ts

@@ -0,0 +1,42 @@
+export interface PivxProposal {
+    name: string;
+    url: string;
+    status: "passing" | "failing";
+    funded: boolean;
+    netYesPercent: number;
+    yesVotes: number;
+    noVotes: number;
+    monthlyPaymentPiv: number;
+    monthlyPaymentUsd: number;
+    totalPaymentPiv: number;
+    installmentsRemaining: number;
+    totalInstallments: number;
+    budgetPercent: number;
+}
+export interface PivxNetworkStats {
+    masternodeCount: number;
+    passingThreshold: number;
+    monthlyBudgetPiv: number;
+    monthlyBudgetUsd: number;
+    budgetAllocatedPiv: number;
+    budgetAllocatedUsd: number;
+    budgetAllocatedPercent: number;
+    blockHeight: number;
+    totalSupply: number;
+    circulatingSupply: number;
+}
+export interface PivxGovernanceData {
+    proposals: PivxProposal[];
+    network: PivxNetworkStats;
+    deflation: {
+        unallocatedPivPerCycle: number;
+        unallocatedPercent: number;
+        annualUnallocatedPiv: number;
+        proposalFeeBurnPiv: number;
+        effectiveInflationReduction: string;
+    };
+    timestamp: string;
+    source: string;
+    cacheHit: boolean;
+}
+export declare function fetchPivxGovernance(): Promise<PivxGovernanceData>;

package/dist/pivx-provider.js

@@ -0,0 +1,232 @@
+import * as cheerio from "cheerio";
+// 5-minute cache
+const CACHE_TTL_MS = 5 * 60 * 1000;
+let cachedData = null;
+let cacheTimestamp = 0;
+const CHAINZ_BASE = "https://chainz.cryptoid.info/pivx/api.dws";
+async function chainzFetch(query) {
+    const res = await fetch(`${CHAINZ_BASE}?q=${query}`, {
+        signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok)
+        throw new Error(`Chainz API ${query}: HTTP ${res.status}`);
+    return (await res.text()).trim();
+}
+async function fetchNetworkStats() {
+    const [masternodeCount, blockHeight, totalSupply, circulating] = await Promise.allSettled([
+        chainzFetch("masternodecount"),
+        chainzFetch("getblockcount"),
+        chainzFetch("totalcoins"),
+        chainzFetch("circulating"),
+    ]);
+    const mn = masternodeCount.status === "fulfilled"
+        ? parseInt(masternodeCount.value, 10)
+        : 0;
+    const bh = blockHeight.status === "fulfilled"
+        ? parseInt(blockHeight.value, 10)
+        : 0;
+    const ts = totalSupply.status === "fulfilled"
+        ? parseFloat(totalSupply.value)
+        : 0;
+    const cs = circulating.status === "fulfilled"
+        ? parseFloat(circulating.value)
+        : 0;
+    return {
+        masternodeCount: isNaN(mn) ? 0 : mn,
+        blockHeight: isNaN(bh) ? 0 : bh,
+        totalSupply: isNaN(ts) ? 0 : ts,
+        circulatingSupply: isNaN(cs) ? 0 : cs,
+        passingThreshold: isNaN(mn) ? 0 : Math.ceil(mn * 0.1),
+    };
+}
+function parseNumber(text) {
+    const cleaned = text.replace(/[^0-9.\-]/g, "");
+    const num = parseFloat(cleaned);
+    return isNaN(num) ? 0 : num;
+}
+async function scrapePivxProposals() {
+    const res = await fetch("https://pivx.org/proposals", {
+        signal: AbortSignal.timeout(15000),
+        headers: {
+            "User-Agent": "MPP32-Governance-Oracle/1.0 (+https://mpp32.org)",
+            Accept: "text/html",
+        },
+    });
+    if (!res.ok)
+        throw new Error(`pivx.org/proposals returned HTTP ${res.status}`);
+    const html = await res.text();
+    const $ = cheerio.load(html);
+    const pageText = $("body").text();
+    let monthlyBudgetPiv = 432000;
+    let monthlyBudgetUsd = 0;
+    let budgetAllocatedPiv = 0;
+    let budgetAllocatedUsd = 0;
+    let masternodeCount = 0;
+    let passingThreshold = 0;
+    const budgetMatch = pageText.match(/Monthly\s*Budget[:\s]*([\d,]+)\s*PIV/i);
+    if (budgetMatch?.[1])
+        monthlyBudgetPiv = parseNumber(budgetMatch[1]);
+    const budgetUsdMatch = pageText.match(/Monthly\s*Budget[^$]*US?\$([\d,.]+)/i);
+    if (budgetUsdMatch?.[1])
+        monthlyBudgetUsd = parseNumber(budgetUsdMatch[1]);
+    const allocatedMatch = pageText.match(/Budget\s*Allocated[:\s]*([\d,]+)\s*PIV/i);
+    if (allocatedMatch?.[1])
+        budgetAllocatedPiv = parseNumber(allocatedMatch[1]);
+    const allocatedUsdMatch = pageText.match(/Budget\s*Allocated[^$]*US?\$([\d,.]+)/i);
+    if (allocatedUsdMatch?.[1])
+        budgetAllocatedUsd = parseNumber(allocatedUsdMatch[1]);
+    const mnMatch = pageText.match(/([\d,]+)\s*masternodes?\s*online/i);
+    if (mnMatch?.[1])
+        masternodeCount = parseNumber(mnMatch[1]);
+    const thresholdMatch = pageText.match(/Positive\s*votes\s*required[^:]*:\s*(\d+)/i);
+    if (thresholdMatch?.[1])
+        passingThreshold = parseInt(thresholdMatch[1], 10);
+    const proposals = [];
+    const seenHashes = new Set();
+    $("table#js_table tbody tr[data-hash]").each((_i, el) => {
+        const $row = $(el);
+        const hash = $row.attr("data-hash") || "";
+        if (!hash || seenHashes.has(hash))
+            return;
+        seenHashes.add(hash);
+        const name = ($row.attr("data-title") || "").trim();
+        if (!name)
+            return;
+        const cells = $row.find("td");
+        if (cells.length < 5)
+            return;
+        const statusCell = $(cells[0]);
+        const statusText = statusCell.text();
+        const isPassing = /passing/i.test(statusText);
+        const funded = /funded/i.test(statusText);
+        let netYesPercent = 0;
+        const netYesMatch = statusText.match(/([-\d.]+)%/);
+        if (netYesMatch?.[1])
+            netYesPercent = parseFloat(netYesMatch[1]);
+        const nameCell = $(cells[1]);
+        const link = nameCell.find("a").first();
+        const url = link.attr("href") || "";
+        const paymentCell = $(cells[2]);
+        const monthlyPaymentPiv = parseNumber(paymentCell.attr("data-piv") || paymentCell.attr("data-order") || "0");
+        const budgetPercent = parseFloat(paymentCell.attr("data-percent") || "0");
+        let monthlyPaymentUsd = 0;
+        const usdSpan = paymentCell.find(".curr-prefix").parent();
+        if (usdSpan.length) {
+            const usdText = usdSpan.text();
+            const usdMatch = usdText.match(/US?\$\s*([\d,]+(?:\.\d+)?)/i);
+            if (usdMatch?.[1])
+                monthlyPaymentUsd = parseNumber(usdMatch[1]);
+        }
+        let installmentsRemaining = 1;
+        const longLine = paymentCell.find(".long-line");
+        if (longLine.length) {
+            const installB = longLine.find("b").first();
+            if (installB.length) {
+                const n = parseInt(installB.text().trim(), 10);
+                if (!isNaN(n))
+                    installmentsRemaining = n;
+            }
+        }
+        let totalPaymentPiv = monthlyPaymentPiv;
+        if (longLine.length) {
+            const totalB = longLine.find("b").last();
+            if (totalB.length) {
+                const totalText = totalB.text();
+                const totalMatch = totalText.match(/([\d,]+(?:\.\d+)?)\s*PIV/i);
+                if (totalMatch?.[1])
+                    totalPaymentPiv = parseNumber(totalMatch[1]);
+            }
+        }
+        const voteCell = $(cells[4]);
+        const voteText = voteCell.text();
+        let yesVotes = 0;
+        let noVotes = 0;
+        const voteMatch = voteText.match(/(\d+)\s*\/\s*(\d+)/);
+        if (voteMatch?.[1] && voteMatch[2]) {
+            yesVotes = parseInt(voteMatch[1], 10);
+            noVotes = parseInt(voteMatch[2], 10);
+        }
+        proposals.push({
+            name,
+            url,
+            status: isPassing ? "passing" : "failing",
+            funded,
+            netYesPercent,
+            yesVotes,
+            noVotes,
+            monthlyPaymentPiv,
+            monthlyPaymentUsd,
+            totalPaymentPiv,
+            installmentsRemaining,
+            totalInstallments: installmentsRemaining,
+            budgetPercent,
+        });
+    });
+    return {
+        proposals,
+        budgetSummary: {
+            monthlyBudgetPiv,
+            monthlyBudgetUsd,
+            budgetAllocatedPiv,
+            budgetAllocatedUsd,
+            masternodeCount,
+            passingThreshold,
+        },
+    };
+}
+export async function fetchPivxGovernance() {
+    if (cachedData && Date.now() - cacheTimestamp < CACHE_TTL_MS) {
+        return { ...cachedData, cacheHit: true };
+    }
+    const [scrapeResult, networkStats] = await Promise.allSettled([
+        scrapePivxProposals(),
+        fetchNetworkStats(),
+    ]);
+    const scraped = scrapeResult.status === "fulfilled" ? scrapeResult.value : null;
+    const chainzStats = networkStats.status === "fulfilled" ? networkStats.value : {};
+    if (!scraped) {
+        throw new Error(`Failed to fetch PIVX governance data: ${scrapeResult.status === "rejected" ? scrapeResult.reason : "unknown"}`);
+    }
+    const budgetAllocatedPercent = scraped.budgetSummary.monthlyBudgetPiv > 0
+        ? Math.round((scraped.budgetSummary.budgetAllocatedPiv /
+            scraped.budgetSummary.monthlyBudgetPiv) *
+            10000) / 100
+        : 0;
+    const network = {
+        masternodeCount: scraped.budgetSummary.masternodeCount ||
+            chainzStats.masternodeCount ||
+            0,
+        passingThreshold: scraped.budgetSummary.passingThreshold ||
+            chainzStats.passingThreshold ||
+            0,
+        monthlyBudgetPiv: scraped.budgetSummary.monthlyBudgetPiv,
+        monthlyBudgetUsd: scraped.budgetSummary.monthlyBudgetUsd,
+        budgetAllocatedPiv: scraped.budgetSummary.budgetAllocatedPiv,
+        budgetAllocatedUsd: scraped.budgetSummary.budgetAllocatedUsd,
+        budgetAllocatedPercent,
+        blockHeight: chainzStats.blockHeight || 0,
+        totalSupply: chainzStats.totalSupply || 0,
+        circulatingSupply: chainzStats.circulatingSupply || 0,
+    };
+    const unallocatedPivPerCycle = network.monthlyBudgetPiv - network.budgetAllocatedPiv;
+    const annualUnallocatedPiv = unallocatedPivPerCycle * 12;
+    const data = {
+        proposals: scraped.proposals,
+        network,
+        deflation: {
+            unallocatedPivPerCycle,
+            unallocatedPercent: 100 - budgetAllocatedPercent,
+            annualUnallocatedPiv,
+            proposalFeeBurnPiv: 50,
+            effectiveInflationReduction: network.totalSupply > 0
+                ? `${((annualUnallocatedPiv / network.totalSupply) * 100).toFixed(3)}%`
+                : "N/A",
+        },
+        timestamp: new Date().toISOString(),
+        source: "pivx.org/proposals + chainz.cryptoid.info",
+        cacheHit: false,
+    };
+    cachedData = data;
+    cacheTimestamp = Date.now();
+    return data;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mpp32-mcp-server",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "mcpName": "io.github.MPP32/mpp32-mcp-server",
   "description": "Payment layer for AI agents. One MCP, five protocols, thousands of paid APIs your agent can call.",
   "type": "module",
@@ -76,6 +76,7 @@
     "@solana-program/token": "^0.13.0",
     "@solana/kit": "^6.9.0",
     "bs58": "^6.0.0",
+    "cheerio": "^1.2.0",
     "tweetnacl": "^1.0.3",
     "viem": "^2.48.11",
     "zod": "^3.23.0"