mpp32-mcp-server 1.1.3 → 1.1.4

package/CHANGELOG.md

@@ -4,6 +4,23 @@ 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.1.4] - 2026-05-11
+
+### Added
+
+* **`get_mpp32_diagnostics` MCP tool.** Reports server version, API URL,
+  and per-variable detection state for `MPP32_AGENT_KEY`,
+  `MPP32_SOLANA_PRIVATE_KEY`, and `MPP32_PRIVATE_KEY` — without ever
+  echoing the secret. The single most common payment failure has been
+  "I set the key but the MCP server doesn't see it" (wrong
+  `claude_desktop_config.json` file, `env` block at the wrong level in
+  the JSON, typo, or stale process from an incomplete restart). This
+  tool turns that into a one-call diagnosis.
+* **Per-variable startup banner lines.** The stderr banner now prints
+  one `[mpp32] MPP32_X: SET (fingerprint) / NOT SET` line per managed
+  env var, so users who can find their MCP log file can see the same
+  diagnosis without calling a tool.
+
 ## [1.1.3] - 2026-05-11
 
 ### Fixed

package/dist/index.js

@@ -2,7 +2,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-const SERVER_VERSION = "1.1.3";
+const SERVER_VERSION = "1.1.4";
 // ── 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
@@ -173,6 +173,63 @@ function isHttpCallable(svc) {
         return false;
     return /^https?:\/\//.test(url);
 }
+// ── Tool 0: get_mpp32_diagnostics ───────────────────────────────────────────
+// Lets the user (and Claude) see exactly what the MCP process detected at
+// startup. The single most common failure mode is "I set the env var but it
+// didn't reach the server" — wrong claude_desktop_config.json file edited,
+// `env` block at the wrong level, typo in the variable name, stale process
+// from an incomplete restart. This tool answers all of those without
+// asking the user to dig through MCP log files.
+function describeEnvVarStatus(name, value) {
+    const raw = process.env[name];
+    if (raw === undefined)
+        return `${name}: NOT SET (variable absent from MCP process env)`;
+    if (raw.length === 0)
+        return `${name}: EMPTY (set but blank)`;
+    if (value === undefined) {
+        return `${name}: REJECTED (raw length ${raw.length}, but failed validation — check startup log for reason)`;
+    }
+    // Show a short, non-secret fingerprint so the user can confirm it's the
+    // right value without us exfiltrating the key.
+    const fingerprint = value.length <= 12
+        ? `${value.length} chars`
+        : `${value.slice(0, 6)}…${value.slice(-4)} (${value.length} chars)`;
+    return `${name}: SET (${fingerprint})`;
+}
+server.tool("get_mpp32_diagnostics", "Report what the mpp32-mcp-server detected at startup: version, API URL, and which env vars (MPP32_AGENT_KEY, MPP32_SOLANA_PRIVATE_KEY, MPP32_PRIVATE_KEY) were loaded into this process. Use this FIRST if payments fail with 'no key configured' even though you set one in claude_desktop_config.json — it confirms whether your env vars actually reached the MCP process or got dropped by a typo / wrong file / stale restart.", {}, async () => {
+    const lines = [
+        `**mpp32-mcp-server diagnostics**`,
+        ``,
+        `Version: ${SERVER_VERSION}`,
+        `API URL: ${API_URL}`,
+        `Timeout: ${TIMEOUT_MS}ms`,
+        `Node: ${process.version} on ${process.platform}/${process.arch}`,
+        ``,
+        `**Environment variable detection** (values are fingerprinted, never returned in full):`,
+        ``,
+        describeEnvVarStatus("MPP32_AGENT_KEY", AGENT_KEY),
+        describeEnvVarStatus("MPP32_SOLANA_PRIVATE_KEY", SOLANA_PRIVATE_KEY),
+        describeEnvVarStatus("MPP32_PRIVATE_KEY", PRIVATE_KEY),
+        ``,
+        `**Capabilities:**`,
+        `- Catalog browsing: yes (always available)`,
+        `- Federated service execution: ${AGENT_KEY ? "yes" : "no — set MPP32_AGENT_KEY"}`,
+        `- x402 (USDC on Solana) payment: ${SOLANA_PRIVATE_KEY ? "yes" : "no — set MPP32_SOLANA_PRIVATE_KEY"}`,
+        `- Tempo (pathUSD on Eth L2) payment: ${PRIVATE_KEY ? "yes" : "no — set MPP32_PRIVATE_KEY"}`,
+        ``,
+        `If a variable shows NOT SET but you put it in claude_desktop_config.json:`,
+        `1. Confirm the file path Claude Desktop actually reads from:`,
+        `   - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json`,
+        `   - Windows: %APPDATA%\\Claude\\claude_desktop_config.json`,
+        `2. The 'env' block must sit INSIDE the server entry, alongside 'command' and 'args' — not at the top level.`,
+        `3. Fully quit Claude Desktop (Cmd+Q on Mac, right-click tray → Quit on Windows). Closing the window is not enough.`,
+        `4. Re-open Claude Desktop. The new MCP process inherits the env from the JSON.`,
+        `5. Call get_mpp32_diagnostics again — if it still shows NOT SET, the JSON did not load (check for a syntax error).`,
+    ];
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+    };
+});
 // ── Tool 1: list_mpp32_services ─────────────────────────────────────────────
 server.tool("list_mpp32_services", "Browse the MPP32 federated catalog of 4,500+ machine-payable APIs and data services. Includes native MPP32 services (callable end-to-end through this MCP), the x402 Bazaar (USDC on Solana), curated free APIs (DexScreener, Jupiter, CoinGecko health, httpbin, etc.), and the public MCP Registry (npx-installable servers; listing-only). Each result indicates whether it is callable through `call_mpp32_endpoint` or listing-only. The catalog is large (~4,500 entries) — by default a single call returns up to 100 results and the response will tell you the true total and whether the page was truncated. Use `q` (free-text search), `category`, `source`, or `protocol` to narrow down, or raise `limit` (max 500) for broader pages.", {
     category: z
@@ -1065,6 +1122,13 @@ async function main() {
         .filter(Boolean)
         .join(", ") || "no keys (catalog-only legacy mode)";
     console.error(`[mpp32] MCP server v${SERVER_VERSION} on stdio. API ${API_URL}. Configured: ${features}. Timeout ${TIMEOUT_MS}ms.`);
+    // Per-variable status so a user staring at this log can immediately see
+    // whether their env vars made it through. Values are fingerprinted.
+    const fp = (v) => !v ? "NOT SET" : v.length <= 12 ? `SET (${v.length}c)` : `SET (${v.slice(0, 6)}…${v.slice(-4)}, ${v.length}c)`;
+    console.error(`[mpp32]   MPP32_AGENT_KEY: ${fp(AGENT_KEY)}`);
+    console.error(`[mpp32]   MPP32_SOLANA_PRIVATE_KEY: ${fp(SOLANA_PRIVATE_KEY)}`);
+    console.error(`[mpp32]   MPP32_PRIVATE_KEY: ${fp(PRIVATE_KEY)}`);
+    console.error(`[mpp32] If a key shows NOT SET but you set it in claude_desktop_config.json, call the get_mpp32_diagnostics tool for help, or fully quit Claude Desktop and reopen.`);
 }
 main().catch((err) => {
     console.error("Fatal:", err);

package/package.json

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