mpp32-mcp-server 1.4.1 → 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.1";
+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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mpp32-mcp-server",
-  "version": "1.4.1",
+  "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",