mpp32-mcp-server 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -4,6 +4,40 @@ All notable changes to `mpp32-mcp-server` are documented here. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the
 project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.0] - 2026-06-01
+
+### Added
+
+* **`try_solana_token_intelligence_free` MCP tool — zero-friction preview.**
+  Hits the backend `/api/intelligence/demo` endpoint. Returns the same alpha
+  score, rug risk, whale activity, smart money signals, pump probability, and
+  market data payload as the paid endpoint, but requires no `MPP32_AGENT_KEY`
+  and no Solana private key. Rate-limited to 10 calls/minute per IP. Intended
+  as the first call new users (and Claude itself) make when evaluating MPP32 —
+  see the data quality, THEN configure paid access. This closes the
+  conversion-funnel gap where new agents previously hit a 402 wall on their
+  very first call before ever seeing the oracle's output.
+
+### Changed
+
+* **`get_solana_token_intelligence` description updated** to point new users
+  with no keys configured at `try_solana_token_intelligence_free` first.
+* **`get_mpp32_diagnostics` output updated** to mention the free demo when
+  the user is not yet ready to pay end-to-end.
+
+### Backend (server-side compatibility, no client action required)
+
+* MPP32 backend now defaults to PayAI (`https://facilitator.payai.network`)
+  as the x402 facilitator, with Coinbase CDP as a documented fallback. PayAI
+  is the only public facilitator that supports Solana **mainnet**
+  (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`); the previous default
+  (`x402.org/facilitator`) is testnet/devnet-only and was silently failing
+  every mainnet settlement. The backend now refuses to boot in production
+  if no configured facilitator supports the configured network — making this
+  exact regression class impossible. No MCP client change required: the
+  signer's network detection (`x402-signers.ts`) and protocol handling are
+  unchanged.
+
 ## [1.4.0] - 2026-05-21
 
 ### Added

package/README.md

@@ -22,6 +22,12 @@ One install. Pay any x402 endpoint on Solana from your agent. Browse a federated
 
 The MCP server ships signers for both Solana and Base out of the box. When a paid call returns a 402, the server picks the network that matches the key you configured and settles the payment in one round trip.
 
+## Try it free first (no keys, no setup)
+
+The MCP server exposes a **`try_solana_token_intelligence_free`** tool that returns the full Intelligence Oracle payload (alpha score, rug risk, whale activity, smart money signals, 24h pump probability, market data) for any Solana token with **zero configuration** — no `MPP32_AGENT_KEY`, no Solana key, no payment. Rate-limited to 10 calls/minute per IP. Use it to evaluate the oracle, then switch to `get_solana_token_intelligence` for unlimited attributed usage at $0.008/query (M32 holders save up to 40%).
+
+Just install the server and ask your agent: _"Use mpp32 to get a free intelligence preview for SOL."_
+
 ## Why this beats running your own integrations
 
 Most agent stacks stop at "the model can call a function." That works until the function costs money. The moment your agent needs premium data, a paid model, a trading signal, or a token analytics call, you are back to building accounts, storing API keys, watching budgets, and writing custom 402 handlers for every provider.

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.5.0";
 // ── 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
@@ -252,7 +252,7 @@ server.tool("get_mpp32_diagnostics", "Report what the mpp32-mcp-server detected
         `- x402 (USDC on Solana) payment: ${SOLANA_PRIVATE_KEY ? "yes" : "no — set MPP32_SOLANA_PRIVATE_KEY"}`,
         `- x402 (USDC on Base/EVM) payment: ${PRIVATE_KEY ? "yes" : "no — set MPP32_PRIVATE_KEY"}`,
         ``,
-        `**Ready to pay end-to-end:** ${readyToPay ? "YES — try `get_solana_token_intelligence` with token=\"M32\" to confirm." : "NO — see the missing items above."}`,
+        `**Ready to pay end-to-end:** ${readyToPay ? "YES — try `get_solana_token_intelligence` with token=\"M32\" to confirm." : "NO — see the missing items above. Meanwhile, you can still call `try_solana_token_intelligence_free` (10/min/IP, no keys required) to evaluate the oracle."}`,
         ``,
         `**If a variable shows NOT SET but you set it in claude_desktop_config.json:**`,
         `1. Confirm the file path Claude Desktop actually reads:`,
@@ -450,7 +450,7 @@ server.tool("call_mpp32_endpoint", "Call any HTTP-callable service in the MPP32
     return await callViaLegacyProxy(slug, method, parsedBody, query, path);
 });
 // ── Tool 3: get_solana_token_intelligence ───────────────────────────────────
-server.tool("get_solana_token_intelligence", "Get real-time Solana token intelligence from the MPP32 Intelligence Oracle. Returns alpha score (0-100), rug risk assessment, whale activity, smart money signals, 24h pump probability, projected ROI ranges, and aggregated DexScreener/Jupiter/CoinGecko market data. Costs $0.008 per query, paid automatically via x402 (USDC on Solana) or Tempo (pathUSD on Eth L2). M32 token holders receive up to 40% discount once their wallet is signature-verified. Set MPP32_AGENT_KEY in config to attribute calls to your dashboard.", {
+server.tool("get_solana_token_intelligence", "Get real-time Solana token intelligence from the MPP32 Intelligence Oracle. Returns alpha score (0-100), rug risk assessment, whale activity, smart money signals, 24h pump probability, projected ROI ranges, and aggregated DexScreener/Jupiter/CoinGecko market data. Costs $0.008 per query, paid automatically via x402 (USDC on Solana) or Tempo (pathUSD on Eth L2). M32 token holders receive up to 40% discount once their wallet is signature-verified. Set MPP32_AGENT_KEY in config to attribute calls to your dashboard. **New users with no keys configured: call `try_solana_token_intelligence_free` first** — it returns the same payload, rate-limited to 10/min, no payment or key required.", {
     token: z
         .string()
         .describe("Solana token mint address or ticker symbol (e.g. SOL, BONK, JUP, M32, or full base58 address)."),
@@ -466,6 +466,63 @@ server.tool("get_solana_token_intelligence", "Get real-time Solana token intelli
     // Legacy path — direct call to /api/intelligence with manual 402 handling.
     return await legacyIntelligenceCall(token, walletAddress);
 });
+// ── Tool 3b: Free Intelligence Demo ────────────────────────────────────────
+// No payment, no key. Hits /api/intelligence/demo, which is rate-limited per
+// IP. Intended as the first call new users (and Claude itself) make when
+// trying MPP32 — they see real alpha scores and signals BEFORE encountering
+// any payment wall. This is the conversion funnel fix: agents today bounce
+// off the 402, so we let them taste the product first.
+server.tool("try_solana_token_intelligence_free", "FREE preview of the MPP32 Intelligence Oracle. No payment, no agent key, no Solana private key required. Returns the SAME payload as the paid endpoint (alpha score, rug risk, whale activity, smart money signals, pump probability, market data) for any Solana token. Rate-limited to 10 calls/minute per IP. Use this to evaluate the data quality. Once you're convinced, set MPP32_AGENT_KEY + a payment key and switch to `get_solana_token_intelligence` for unlimited, attributed usage and M32-holder discounts.", {
+    token: z
+        .string()
+        .describe("Solana token mint address or ticker symbol (e.g. SOL, BONK, JUP, M32, or full base58 address)."),
+}, async ({ token }) => {
+    try {
+        const res = await fetchWithTimeout(`${API_URL}/api/intelligence/demo`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ token }),
+        });
+        const text = await res.text();
+        let formatted;
+        try {
+            formatted = JSON.stringify(JSON.parse(text), null, 2);
+        }
+        catch {
+            formatted = text;
+        }
+        if (res.status === 429) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Demo rate limit reached (10 calls/minute per IP). Wait a minute and retry, or set up paid access for unlimited queries:\n\n1. Get an agent key: ${API_URL}/agent-console\n2. Add MPP32_AGENT_KEY + MPP32_SOLANA_PRIVATE_KEY to your MCP config\n3. Call \`get_solana_token_intelligence\` instead — $0.008/query, M32 holders save up to 40%.`,
+                    }],
+            };
+        }
+        if (!res.ok) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Demo returned HTTP ${res.status}:\n\n\`\`\`json\n${formatted}\n\`\`\``,
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `**MPP32 Intelligence Oracle (FREE DEMO)** — \`${token}\`\n\n${formatted}\n\n---\n_Demo result. Same payload as the paid endpoint. Rate-limited to 10/min/IP. For unlimited usage and dashboard attribution, set MPP32_AGENT_KEY (get one at ${API_URL}/agent-console) and use \`get_solana_token_intelligence\`._`,
+                }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Network error reaching ${API_URL}: ${err instanceof Error ? err.message : String(err)}`,
+                }],
+        };
+    }
+});
 // ── Tool 4: M32-gated Whale Tracker ───────────────────────────────────────
 server.tool("get_m32_whale_tracker", "M32-gated whale analysis for any Solana token. Returns top 20 holders, concentration risk, holder distribution, and buy/sell pressure. Requires the caller to hold 1,000,000+ M32 tokens (balance verified on-chain via X-Wallet-Address header). Free for qualifying holders — no payment required. Returns 403 if the wallet holds insufficient M32.", {
     token: z
@@ -575,7 +632,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 +648,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 +685,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 +702,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 +712,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.5.0",
   "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"