mcp-server-madeonsol 1.15.0 → 1.15.1

package/README.md

@@ -65,6 +65,37 @@ Add to `claude_desktop_config.json` or Cursor MCP settings (free tier at https:/
 
 Restart Claude Desktop and ask: *"What are KOLs buying right now?"*
 
+## AI agent quickstart (x402 / pay-per-call)
+
+Building an autonomous agent? Skip the signup. Point a **funded Solana wallet** at the server and every tool call **auto-pays a micropayment** over [x402](https://x402.org) — no API key, no account, no rate-limit dance.
+
+```json
+{
+  "mcpServers": {
+    "madeonsol": {
+      "command": "mcp-server-madeonsol",
+      "env": {
+        "SVM_PRIVATE_KEY": "<base58 solana private key>"
+      }
+    }
+  }
+}
+```
+
+How it works:
+
+- The wallet behind `SVM_PRIVATE_KEY` settles each request as a **USDC micropayment on Solana** (~$0.005–$0.02 per call, settled on-chain). No subscription, no quota.
+- The free **`madeonsol_discovery`** tool needs no auth and returns every endpoint with its exact per-call price — call it first to see what each tool costs.
+- Install the x402 peer deps alongside the server (only required for this mode):
+
+  ```bash
+  npm install -g mcp-server-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
+  ```
+
+> **Data only.** MadeOnSol returns trading *intelligence* — it never trades, signs swaps, or takes custody of funds. The only thing your wallet ever pays for is the per-call data fee.
+
+Prefer a fixed monthly bill, free tier, or no wallet? Use the developer path below.
+
 ## Authentication
 
 Two options (in priority order):

package/dist/index.d.ts

@@ -1,2 +1,17 @@
 #!/usr/bin/env node
-export {};
+export type AuthMode = "madeonsol" | "x402" | "none";
+/**
+ * Pure selection of the auth mode from environment. Extracted from initAuth()
+ * so the routing/auth-mode logic is unit-testable without setting up signers or
+ * network. Priority: MADEONSOL_API_KEY (Bearer) > SVM_PRIVATE_KEY (x402) > none.
+ */
+export declare function resolveAuthMode(env?: {
+    MADEONSOL_API_KEY?: string;
+    SVM_PRIVATE_KEY?: string;
+}): AuthMode;
+/**
+ * Pure path rewrite. Tools are authored against /api/x402/ paths. In x402 / none
+ * mode the path is kept as-is; in madeonsol (API key) mode the prefix is
+ * rewritten to /api/v1/. Extracted from query() so it is unit-testable.
+ */
+export declare function rewritePath(path: string, mode: AuthMode): string;

package/dist/index.js

@@ -11,7 +11,29 @@ const PORT = parseInt(process.env.PORT || "3100", 10);
 const MODE = process.env.MCP_TRANSPORT || "stdio"; // "stdio" or "http"
 let authMode = "none";
 let paidFetch = fetch;
-const UA = "mcp-server-madeonsol/1.14.0";
+/**
+ * Pure selection of the auth mode from environment. Extracted from initAuth()
+ * so the routing/auth-mode logic is unit-testable without setting up signers or
+ * network. Priority: MADEONSOL_API_KEY (Bearer) > SVM_PRIVATE_KEY (x402) > none.
+ */
+export function resolveAuthMode(env = process.env) {
+    if (env.MADEONSOL_API_KEY)
+        return "madeonsol";
+    if (env.SVM_PRIVATE_KEY)
+        return "x402";
+    return "none";
+}
+/**
+ * Pure path rewrite. Tools are authored against /api/x402/ paths. In x402 / none
+ * mode the path is kept as-is; in madeonsol (API key) mode the prefix is
+ * rewritten to /api/v1/. Extracted from query() so it is unit-testable.
+ */
+export function rewritePath(path, mode) {
+    return mode === "x402" || mode === "none"
+        ? path
+        : path.replace("/api/x402/", "/api/v1/");
+}
+const UA = "mcp-server-madeonsol/1.15.1";
 function apiKeyHeaders() {
     const h = { "User-Agent": UA };
     if (authMode === "madeonsol") {
@@ -20,12 +42,13 @@ function apiKeyHeaders() {
     return h;
 }
 async function initAuth() {
-    if (MADEONSOL_API_KEY) {
+    const mode = resolveAuthMode({ MADEONSOL_API_KEY, SVM_PRIVATE_KEY: PRIVATE_KEY });
+    if (mode === "madeonsol") {
         authMode = "madeonsol";
         console.error("[madeonsol-mcp] Using MadeOnSol API key (Bearer auth)");
         return;
     }
-    if (PRIVATE_KEY) {
+    if (mode === "x402" && PRIVATE_KEY) {
         try {
             const { wrapFetchWithPayment } = await import("@x402/fetch");
             const { x402Client } = await import("@x402/core/client");
@@ -50,9 +73,7 @@ async function initAuth() {
 }
 async function query(path, params) {
     // API key uses /api/v1/ endpoints; x402 uses /api/x402/
-    const apiPath = authMode === "x402" || authMode === "none"
-        ? path
-        : path.replace("/api/x402/", "/api/v1/");
+    const apiPath = rewritePath(path, authMode);
     const url = new URL(apiPath, BASE_URL);
     if (params) {
         for (const [k, v] of Object.entries(params)) {
@@ -928,7 +949,7 @@ async function main() {
                 res.end(JSON.stringify({
                     name: "madeonsol",
                     description: "Solana KOL trading intelligence and deployer analytics. Real-time data from 1,000+ KOL wallets, 6,700+ Pump.fun deployers, 47,000+ scored alpha wallets, copy-trade rules, and wallet tracker. Supports MadeOnSol API key (msk_) or x402 micropayments.",
-                    version: "1.13.0",
+                    version: "1.15.1",
                     tools: [
                         { name: "madeonsol_kol_feed", description: "Get real-time Solana KOL trades from 1,000+ tracked wallets." },
                         { name: "madeonsol_kol_coordination", description: "Get KOL convergence signals — tokens multiple KOLs are accumulating." },
@@ -1013,7 +1034,7 @@ async function main() {
                         transport = new StreamableHTTPServerTransport({
                             sessionIdGenerator: undefined,
                         });
-                        const server = new McpServer({ name: "madeonsol", version: "1.13.0" });
+                        const server = new McpServer({ name: "madeonsol", version: "1.15.1" });
                         registerTools(server);
                         await server.connect(transport);
                     }
@@ -1057,4 +1078,8 @@ async function main() {
         await server.connect(transport);
     }
 }
-main().catch(console.error);
+// Only auto-run when executed as a program (CLI / spawned process), not when
+// the module is imported by a test for its exported pure helpers.
+if (process.env.MADEONSOL_MCP_NO_AUTORUN !== "1") {
+    main().catch(console.error);
+}

package/glama.json

@@ -2,7 +2,7 @@
   "name": "mcp-server-madeonsol",
   "display_name": "MadeOnSol — Solana memecoin intelligence",
   "description": "Real-time Solana memecoin trading intelligence — track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers, surface multi-KOL coordination signals, run server-side copy-trade rules, and stream every DEX trade across 9+ programs. Backtested first-touch scout signal (S-tier scouts attract ≥3 follow-on KOLs ~50% of the time vs 14% baseline). Free tier 200 requests per day; auth via msk_ API key or x402 micropayments.",
-  "version": "1.7.4",
+  "version": "1.15.1",
   "homepage": "https://madeonsol.com/solana-api",
   "repository": "https://github.com/LamboPoewert/mcp-server-madeonsol",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-madeonsol",
-  "version": "1.15.0",
+  "version": "1.15.1",
   "mcpName": "io.github.LamboPoewert/madeonsol",
   "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
   "type": "module",
@@ -16,6 +16,7 @@
   ],
   "scripts": {
     "build": "tsc",
+    "test": "vitest run",
     "preflight": "bash ../../scripts/preflight-publish.sh",
     "prepublishOnly": "npm run preflight && npm run build"
   },
@@ -61,6 +62,7 @@
   },
   "devDependencies": {
     "@types/node": "^20",
-    "typescript": "^5"
+    "typescript": "^5",
+    "vitest": "^4.1.5"
   }
 }