mpp32-mcp-server 1.3.1 → 1.4.0

package/CHANGELOG.md

@@ -4,6 +4,56 @@ 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.4.0] - 2026-05-21
+
+### Added
+
+* **`get_pivx_dao_intelligence` MCP tool — real-time PIVX DAO governance
+  intelligence.** Returns active budget proposals with masternode voting
+  tallies (Yes/No counts, net yes percentage), budget allocation status,
+  network health metrics, and deflation/fee burn analysis. 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 is sourced live from pivx.org/proposals (HTML
+  scraping with structured `data-*` attributes) and the Chainz CryptoID
+  blockchain API. Cached for 5 minutes. Free — no payment key required.
+
+  Parameters:
+  - `filter` (optional, enum: `all` | `passing` | `failing`) — filter
+    proposals by voting status. Default: `all`.
+  - `includeStats` (optional, boolean) — include network stats and deflation
+    metrics. Default: `true`.
+
+  The response includes:
+  - **Network Overview:** masternode count, passing threshold (10% of
+    masternodes), monthly budget (PIV and USD), budget allocation percentage,
+    block height, total/circulating supply.
+  - **Deflation Metrics:** unallocated treasury PIV per cycle (never minted),
+    annual unallocated estimate, effective inflation reduction percentage,
+    proposal submission fee burn (50 PIV per proposal).
+  - **Active Proposals:** name, status (passing/failing), funded flag,
+    vote counts (yes/no), net yes percentage, monthly and total payment
+    amounts (PIV and USD), installments remaining, budget usage percentage,
+    and link to proposal details.
+
+* **PIVX Governance Oracle catalog entry.** Listed as `curated:pivx-governance`
+  in the federated catalog (category: crypto, free, verified). Discoverable
+  via `list_mpp32_services` with `q=pivx` or `category=crypto`.
+
+* **Backend `/api/governance` endpoints.** Three routes serve the PIVX data:
+  `GET /api/governance` (full governance data + deflation), `GET
+  /api/governance/proposals?status=passing|failing` (filtered proposals),
+  `GET /api/governance/stats` (network stats only). Rate limited to 30
+  req/min.
+
+* **Frontend `/governance` page** at mpp32.org/governance. Live dashboard
+  with proposal cards, vote bars, budget stats, deflation metrics, and an
+  explainer on how PIVX governance works.
+
+### Changed
+
+* **`server.json` version bumped to 1.4.0** to match the npm release.
+
 ## [1.3.1] - 2026-05-15
 
 ### Fixed

package/README.md

@@ -33,6 +33,7 @@ MPP32 replaces all of that with one MCP server. Your agent asks for a service by
 * Browse a live catalog of over 4,500 paid and free APIs across categories like token intelligence, market data, web search, image generation, embeddings, DeFi analytics, wallet scoring, on chain queries, and trading signals.
 * Pay any provider in the catalog using whichever protocol fits, with settlement that lands in seconds.
 * Run real time Solana token intelligence with alpha scoring, rug risk, whale flow, and 24 hour pump probability.
+* Query live PIVX DAO governance data: active proposals, masternode voting tallies, budget allocation, and network deflation metrics — all free, no payment key needed.
 * Track every call, every dollar settled, and every protocol used from a dashboard at mpp32.org.
 * Get an automatic 20 percent or 40 percent discount on native services for holding M32 once your wallet is verified.
 * Access M32-gated exclusive APIs: Whale Tracker (1M M32), Token Comparison (2.5M M32), and Portfolio Scanner (5M M32) — free for holders, unavailable to non-holders.
@@ -177,6 +178,27 @@ M32-gated full wallet portfolio scan. Discovers all SPL tokens in a wallet, runs
 { "wallet": "<wallet-to-scan>", "walletAddress": "<your-solana-wallet>" }
 ```
 
+### `get_pivx_dao_intelligence`
+
+Real-time PIVX DAO governance intelligence. Returns active budget proposals with masternode voting tallies, budget allocation status, network deflation metrics, and masternode network health. PIVX is a fully community-governed cryptocurrency where Masternode owners vote on budget proposals every ~30 days. Data sourced live from pivx.org/proposals and the PIVX blockchain. Free — no payment key required.
+
+```json
+{ "filter": "all" }
+```
+
+```json
+{ "filter": "passing", "includeStats": true }
+```
+
+Two parameters:
+
+* **filter** (optional) — `all` (default), `passing`, or `failing`. Filters proposals by voting status.
+* **includeStats** (optional, default true) — include network overview and deflation metrics alongside proposals.
+
+The response includes a network overview (masternode count, passing threshold, monthly budget in PIV and USD, budget allocation percentage, block height, supply stats), deflation metrics (unallocated treasury PIV that are never minted, effective inflation reduction, proposal fee burn), and all active proposals with vote counts, payment amounts, installments, and links.
+
+View the governance dashboard at [mpp32.org/governance](https://mpp32.org/governance).
+
 ### `manage_agent_budget`
 
 View, set, or reset the economic circuit breaker for your agent session. Prevents runaway spending with infrastructure-level budget enforcement.

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.3.1";
+const SERVER_VERSION = "1.4.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
@@ -574,6 +574,114 @@ server.tool("scan_portfolio_m32", "M32-gated full wallet portfolio scan. Discove
         return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }] };
     }
 });
+// ── 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.", {
+    filter: z
+        .enum(["all", "passing", "failing"])
+        .default("all")
+        .optional()
+        .describe("Filter proposals by status: 'all' (default), 'passing' (funded proposals), or 'failing' (below threshold)."),
+    includeStats: z
+        .boolean()
+        .default(true)
+        .optional()
+        .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 lines = [];
+        lines.push("# PIVX DAO Governance Intelligence");
+        lines.push("");
+        // Network stats
+        const network = data.network;
+        if (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("");
+        }
+        // Deflation stats
+        const deflation = data.deflation;
+        if (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("");
+        }
+        // Proposals
+        let proposals = (data.proposals ?? []);
+        if (filter === "passing")
+            proposals = proposals.filter((p) => p.status === "passing");
+        else if (filter === "failing")
+            proposals = proposals.filter((p) => p.status === "failing");
+        if (proposals.length > 0) {
+            lines.push(`## Active Proposals (${proposals.length})`);
+            lines.push("");
+            for (const p of proposals) {
+                const status = p.status === "passing" ? "PASSING" : "FAILING";
+                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`);
+                }
+                if (Number(p.installmentsRemaining) > 0) {
+                    lines.push(`- **Installments Remaining:** ${p.installmentsRemaining}`);
+                }
+                if (p.budgetPercent)
+                    lines.push(`- **Budget Usage:** ${p.budgetPercent}%`);
+                if (p.url)
+                    lines.push(`- **Details:** ${p.url}`);
+                lines.push("");
+            }
+        }
+        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)" : ""}`);
+        }
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Failed to fetch PIVX governance data: ${err instanceof Error ? err.message : String(err)}`,
+                }],
+        };
+    }
+});
 // ── Tool 8: manage_agent_budget ────────────────────────────────────────────
 server.tool("manage_agent_budget", "View, set, or reset the spending circuit breaker for your MPP32 agent session. Use 'get' to check current budget status (remaining budget, hourly velocity, circuit breaker state). Use 'set' to configure spending limits (budget cap in USD, hourly velocity limit, alert threshold percentage). Use 'reset' to manually reset a tripped circuit breaker so the session can resume spending. Circuit breakers trip automatically when budget or velocity limits are exceeded, preventing runaway agent spending.", {
     action: z.enum(["get", "set", "reset"]).describe("Action: 'get' = view budget status, 'set' = update limits, 'reset' = clear tripped circuit breaker"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mpp32-mcp-server",
-  "version": "1.3.1",
+  "version": "1.4.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",
@@ -52,7 +52,10 @@
     "crypto",
     "defi",
     "token-intelligence",
-    "api-marketplace"
+    "api-marketplace",
+    "pivx",
+    "governance",
+    "dao"
   ],
   "license": "MIT",
   "author": "MPP32 <admin@mpp32.org> (https://mpp32.org)",