mcp-server-madeonsol 0.1.0

package/LICENSE

@@ -0,0 +1 @@
+MIT License

package/README.md

@@ -0,0 +1,52 @@
+# mcp-server-madeonsol
+
+MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Use from Claude Desktop, Cursor, or any MCP-compatible client.
+
+## Install
+
+```bash
+npm install -g mcp-server-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
+```
+
+## Configure
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "madeonsol": {
+      "command": "mcp-server-madeonsol",
+      "env": {
+        "SVM_PRIVATE_KEY": "your_solana_private_key_base58"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to MCP settings with the same command and env vars.
+
+## Tools
+
+| Tool | Price | Description |
+|---|---|---|
+| `madeonsol_kol_feed` | $0.005 | Real-time KOL trade feed (946 wallets) |
+| `madeonsol_kol_coordination` | $0.02 | Multi-KOL convergence signals |
+| `madeonsol_kol_leaderboard` | $0.005 | KOL PnL and win rate rankings |
+| `madeonsol_deployer_alerts` | $0.01 | Elite Pump.fun deployer launches |
+| `madeonsol_discovery` | Free | List all endpoints and prices |
+
+## How It Works
+
+The server uses the x402 payment protocol. Each tool call triggers a USDC micropayment on Solana. Your wallet needs SOL (for fees) and USDC.
+
+Without `SVM_PRIVATE_KEY`, tools return payment requirement info instead of data.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const BASE_URL = process.env.MADEONSOL_API_URL || "https://madeonsol.com";
+const PRIVATE_KEY = process.env.SVM_PRIVATE_KEY;
+let paidFetch = fetch;
+async function initPayment() {
+    if (!PRIVATE_KEY) {
+        console.error("[madeonsol-mcp] No SVM_PRIVATE_KEY — tools will return 402 payment info");
+        return;
+    }
+    try {
+        const { wrapFetchWithPayment } = await import("@x402/fetch");
+        const { x402Client } = await import("@x402/core/client");
+        const { ExactSvmScheme } = await import("@x402/svm/exact/client");
+        const { createKeyPairSignerFromBytes } = await import("@solana/kit");
+        const { base58 } = await import("@scure/base");
+        const signer = await createKeyPairSignerFromBytes(base58.decode(PRIVATE_KEY));
+        const client = new x402Client();
+        client.register("solana:*", new ExactSvmScheme(signer));
+        paidFetch = wrapFetchWithPayment(fetch, client);
+        console.error(`[madeonsol-mcp] x402 payments enabled, wallet: ${signer.address}`);
+    }
+    catch (err) {
+        console.error("[madeonsol-mcp] x402 setup failed:", err);
+    }
+}
+async function query(path, params) {
+    const url = new URL(path, BASE_URL);
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    const res = await paidFetch(url.toString());
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        return `Error ${res.status}: ${body}`;
+    }
+    return JSON.stringify(await res.json(), null, 2);
+}
+const server = new McpServer({
+    name: "madeonsol",
+    version: "0.1.0",
+});
+server.tool("madeonsol_kol_feed", "Get real-time Solana KOL trades from 946 tracked wallets. Costs $0.005 USDC per request via x402.", {
+    limit: z.number().min(1).max(100).default(10).describe("Number of trades to return"),
+    action: z.enum(["buy", "sell"]).optional().describe("Filter by trade type"),
+    kol: z.string().optional().describe("Filter by KOL wallet address"),
+}, async ({ limit, action, kol }) => {
+    const params = { limit };
+    if (action)
+        params.action = action;
+    if (kol)
+        params.kol = kol;
+    return { content: [{ type: "text", text: await query("/api/x402/kol/feed", params) }] };
+});
+server.tool("madeonsol_kol_coordination", "Get KOL convergence signals — tokens being accumulated by multiple KOLs simultaneously. Costs $0.02 USDC per request via x402.", {
+    period: z.enum(["1h", "6h", "24h", "7d"]).default("24h").describe("Time period"),
+    min_kols: z.number().min(2).max(50).default(3).describe("Minimum KOLs converging"),
+    limit: z.number().min(1).max(50).default(20).describe("Number of results"),
+}, async ({ period, min_kols, limit }) => ({
+    content: [{ type: "text", text: await query("/api/x402/kol/coordination", { period, min_kols, limit }) }],
+}));
+server.tool("madeonsol_kol_leaderboard", "Get KOL performance rankings by PnL and win rate. Costs $0.005 USDC per request via x402.", {
+    period: z.enum(["today", "7d", "30d"]).default("7d").describe("Time period"),
+    limit: z.number().min(1).max(50).default(20).describe("Number of KOLs"),
+}, async ({ period, limit }) => ({
+    content: [{ type: "text", text: await query("/api/x402/kol/leaderboard", { period, limit }) }],
+}));
+server.tool("madeonsol_deployer_alerts", "Get real-time alerts from elite Pump.fun deployers with KOL buy enrichment. Costs $0.01 USDC per request via x402.", {
+    limit: z.number().min(1).max(100).default(10).describe("Number of alerts"),
+    offset: z.number().min(0).default(0).describe("Pagination offset"),
+}, async ({ limit, offset }) => ({
+    content: [{ type: "text", text: await query("/api/x402/deployer-hunter/alerts", { limit, offset }) }],
+}));
+server.tool("madeonsol_discovery", "List all available MadeOnSol x402 API endpoints with prices and parameter docs. Free, no payment required.", {}, async () => {
+    const res = await fetch(new URL("/api/x402", BASE_URL).toString());
+    const data = await res.json();
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+});
+async function main() {
+    await initPayment();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "mcp-server-madeonsol",
+  "version": "0.1.0",
+  "description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
+  "type": "module",
+  "bin": {
+    "mcp-server-madeonsol": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": ""
+  },
+  "keywords": ["mcp", "solana", "x402", "kol", "trading", "claude", "cursor"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LamboPoewert/mcp-server-madeonsol"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "peerDependencies": {
+    "@x402/fetch": ">=0.1.0",
+    "@x402/core": ">=0.1.0",
+    "@x402/svm": ">=0.1.0",
+    "@solana/kit": ">=2.0.0",
+    "@scure/base": ">=1.0.0"
+  }
+}