@scriptmasterlabs/mcp-x402 2.0.2 → 2.1.0

package/server.json

@@ -1,48 +1,52 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.Timwal78/mcp-x402",
-  "description": "The x402 Amazon: 43+ MCP tools, pay-per-call. SEC, squeeze, options, FTD, XRPL/Base payments.",
-  "repository": {
-    "url": "https://github.com/timwal78/SML_Portfolio",
-    "source": "github"
-  },
-  "version": "2.0.2",
-  "packages": [
-    {
-      "registryType": "npm",
-      "identifier": "@scriptmasterlabs/mcp-x402",
-      "version": "2.0.2",
-      "runtimeHint": "node",
-      "transport": {
-        "type": "stdio"
-      },
-      "environmentVariables": [
-        {
-          "name": "MCP_TRANSPORT",
-          "description": "Transport mode. Use 'sse' for HTTP server mode.",
-          "isRequired": false
-        },
-        {
-          "name": "SML_PAYMENT_RECEIVER",
-          "description": "USDC Base address to receive payments from agent tool calls.",
-          "isRequired": false
-        },
-        {
-          "name": "WALLET_SEED",
-          "description": "BIP-39 mnemonic for the server wallet. Auto-generated if not set.",
-          "isRequired": false
-        }
-      ]
-    }
-  ],
-  "remotes": [
-    {
-      "type": "sse",
-      "url": "https://mcp-x402.onrender.com/sse"
-    },
-    {
-      "type": "streamable-http",
-      "url": "https://mcp-x402.onrender.com/mcp"
-    }
-  ]
-}
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Timwal78/mcp-x402",
+  "title": "mcp-x402 — The x402 Amazon for AI Agents",
+  "description": "51 pay-per-call MCP tools: market intel, SEC, XRPL payments, copy-trading. USDC/RLUSD. No keys.",
+  "version": "2.1.0",
+  "repository": {
+    "url": "https://github.com/timwal78/SML_Portfolio",
+    "source": "github"
+  },
+  "homepage": "https://scriptmasterlabs.com",
+  "license": "MIT",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@scriptmasterlabs/mcp-x402",
+      "version": "2.1.0",
+      "runtimeHint": "node",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "MCP_TRANSPORT",
+          "description": "Transport mode. Omit for stdio (default). Set to 'sse' for HTTP server mode.",
+          "isRequired": false
+        },
+        {
+          "name": "SML_PAYMENT_RECEIVER",
+          "description": "Optional USDC Base address to receive payments from agent tool calls.",
+          "isRequired": false
+        },
+        {
+          "name": "WALLET_SEED",
+          "description": "BIP-39 mnemonic for the server wallet. Auto-generated if not set.",
+          "isRequired": false
+        }
+      ]
+    }
+  ],
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp-x402.onrender.com/mcp"
+    },
+    {
+      "type": "sse",
+      "url": "https://mcp-x402.onrender.com/sse"
+    }
+  ],
+  "keywords": ["x402", "micropayments", "usdc", "rlusd", "xrpl", "solana", "base", "squeeze", "options", "sec-filings", "ftd", "market-intelligence", "pay-per-call", "autonomous-agents"]
+}

package/.env.example

@@ -1,35 +0,0 @@
-# === TRANSPORT ===
-# stdio (default, for Claude Code) or sse (remote/Cursor)
-MCP_TRANSPORT=stdio
-MCP_SSE_PORT=3402
-
-# === SML API ===
-# Base URL for ScriptMasterLabs APIs
-SML_API_BASE=https://api.scriptmasterlabs.com
-SML_MTLS_CERT_PATH=./certs/client.crt
-SML_MTLS_KEY_PATH=./certs/client.key
-SML_MTLS_CA_PATH=./certs/sml-ca.crt
-
-# === WALLET (stored in OS keychain — env only for CI/testnet) ===
-# NEVER use in production — use OS keychain instead
-# CI_WALLET_SEED=your-bip39-mnemonic-here
-
-# === CHAINS ===
-BASE_RPC_URL=https://mainnet.base.org
-BASE_SEPOLIA_RPC_URL=https://sepolia.base.org
-XRPL_RPC_URL=wss://xrplcluster.com
-SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
-
-# === SPEND LIMITS ===
-DAILY_SPEND_CAP_USD=50
-AUTO_APPROVE_THRESHOLD_USD=1
-PRICE_CACHE_TTL_MS=60000
-
-# === AUDIT ===
-AUDIT_LOG_PATH=./audit.log
-
-# === CREDIT BUREAU ===
-MIN_CREDIT_SCORE=300
-
-# === TESTNET ===
-TESTNET=false

package/.github/workflows/ci.yml

@@ -1,59 +0,0 @@
-name: mcp-x402 CI
-
-on:
-  push:
-    paths:
-      - 'mcp-x402/**'
-  pull_request:
-    paths:
-      - 'mcp-x402/**'
-
-defaults:
-  run:
-    working-directory: mcp-x402
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          cache: 'npm'
-          cache-dependency-path: mcp-x402/package-lock.json
-
-      - name: Install dependencies
-        run: npm ci --ignore-scripts
-
-      - name: Type check
-        run: npm run typecheck
-
-      - name: Unit tests
-        run: npm run test:unit
-
-      - name: Upload coverage
-        uses: codecov/codecov-action@v4
-        with:
-          directory: mcp-x402/coverage
-          flags: mcp-x402
-        continue-on-error: true
-
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-
-      - name: Install dependencies
-        run: npm ci --ignore-scripts
-
-      - name: Build
-        run: npm run build
-
-      - name: Docker build
-        run: docker build -t mcp-x402:ci .

package/.github/workflows/keepalive.yml

@@ -1,31 +0,0 @@
-name: mcp-x402 Keepalive
-
-# Pings the SSE health endpoint every 14 minutes to prevent cold starts
-# on free-tier Render instances (which sleep after 15 minutes of inactivity).
-on:
-  schedule:
-    - cron: '*/14 * * * *'  # every 14 minutes, 24/7
-  workflow_dispatch:        # allow manual trigger
-
-jobs:
-  ping:
-    runs-on: ubuntu-latest
-    timeout-minutes: 2
-    steps:
-      - name: Ping mcp-x402 health endpoint
-        env:
-          MCP_X402_URL: ${{ secrets.MCP_X402_URL }}
-        run: |
-          URL="${MCP_X402_URL:-https://mcp-x402.scriptmasterlabs.com}"
-          STATUS=$(curl -s -o /dev/null -w "%{http_code}" --max-time 30 "${URL}/health")
-          echo "Health check HTTP ${STATUS} — ${URL}/health"
-          if [ "$STATUS" != "200" ]; then
-            echo "::warning::Health check returned HTTP ${STATUS}. Service may be degraded."
-          fi
-
-      - name: Ping SqueezeOS keepalive (ecosystem dependency)
-        run: |
-          curl -s --max-time 30 https://squeezeos-api.onrender.com/api/status > /dev/null || true
-          curl -s --max-time 30 https://four02proof.onrender.com/health > /dev/null || true
-          curl -s --max-time 30 https://ghost-layer.onrender.com/health > /dev/null || true
-          echo "Ecosystem keepalives sent."

package/Dockerfile

@@ -1,19 +0,0 @@
-FROM node:22-alpine AS builder
-WORKDIR /app
-COPY package*.json ./
-RUN npm ci --ignore-scripts
-COPY tsconfig.json ./
-COPY src/ ./src/
-RUN npm run build
-
-FROM node:22-alpine AS runner
-WORKDIR /app
-RUN apk add --no-cache dbus libsecret
-COPY package*.json ./
-RUN npm ci --omit=dev --ignore-scripts
-COPY --from=builder /app/dist ./dist
-COPY agents.json llms.txt .well-known/ ./
-EXPOSE 3402
-ENV NODE_ENV=production
-USER node
-CMD ["node", "dist/server/index.js"]

package/docker-compose.yml

@@ -1,50 +0,0 @@
-version: '3.9'
-
-services:
-  mcp-x402:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    image: mcp-x402:latest
-    container_name: mcp-x402
-    restart: always  # Auto-restart on crash, reboot, or OOM
-    environment:
-      NODE_ENV: production
-      MCP_TRANSPORT: sse
-      MCP_SSE_PORT: "3402"
-      DAILY_SPEND_CAP_USD: "50"
-      AUTO_APPROVE_THRESHOLD_USD: "1"
-      PRICE_CACHE_TTL_MS: "60000"
-      PROOF402_URL: https://four02proof.onrender.com
-      TESTNET: "false"
-      # Secrets — supply via .env file or secrets manager; NEVER hardcode
-      # SML_API_BASE:
-      # BASE_RPC_URL:
-      # XRPL_RPC_URL:
-      # SOLANA_RPC_URL:
-    ports:
-      - "3402:3402"
-    volumes:
-      - ./certs:/app/certs:ro         # mTLS certs (read-only)
-      - audit_logs:/app/audit_logs    # Persistent audit log volume
-    healthcheck:
-      test: ["CMD", "wget", "-qO-", "http://localhost:3402/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 20s
-    logging:
-      driver: json-file
-      options:
-        max-size: "50m"
-        max-file: "7"
-    deploy:
-      resources:
-        limits:
-          memory: 512m
-        reservations:
-          memory: 128m
-
-volumes:
-  audit_logs:
-    driver: local

package/render.yaml

@@ -1,39 +0,0 @@
-services:
-  - type: web
-    name: mcp-x402
-    runtime: docker
-    dockerfilePath: ./mcp-x402/Dockerfile
-    dockerContext: ./mcp-x402
-    plan: starter
-    region: oregon
-    healthCheckPath: /health
-    envVars:
-      - key: NODE_ENV
-        value: production
-      - key: MCP_TRANSPORT
-        value: sse
-      - key: MCP_SSE_PORT
-        value: 3402
-      - key: SML_API_BASE
-        sync: false
-      - key: WALLET_SEED
-        sync: false
-      - key: BASE_RPC_URL
-        sync: false
-      - key: XRPL_RPC_URL
-        sync: false
-      - key: SOLANA_RPC_URL
-        sync: false
-      - key: DAILY_SPEND_CAP_USD
-        value: "50"
-      - key: AUTO_APPROVE_THRESHOLD_USD
-        value: "1"
-      - key: PRICE_CACHE_TTL_MS
-        value: "60000"
-      - key: PROOF402_URL
-        value: https://four02proof.onrender.com
-      - key: TESTNET
-        value: "false"
-    autoDeploy: true
-    # Render restarts the service automatically on crash
-    # healthCheckPath triggers restart if /health returns non-2xx

package/sdk/mcp-x402-sdk/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "@scriptmasterlabs/mcp-x402-sdk",
-  "version": "1.0.0",
-  "description": "5-line drop-in x402 payment wrapper for any MCP server author.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": ["mcp", "x402", "autonomous-payments", "ai-agents"],
-  "author": "ScriptMasterLabs",
-  "license": "MIT",
-  "peerDependencies": {
-    "@modelcontextprotocol/sdk": ">=1.0.0",
-    "zod": ">=3.0.0"
-  }
-}

package/sdk/mcp-x402-sdk/src/index.ts

@@ -1,118 +0,0 @@
-import { z } from 'zod';
-
-export type SupportedCurrency = 'USDC' | 'RLUSD';
-export type SupportedChain = 'base' | 'xrpl' | 'solana';
-
-export interface X402PaymentConfig<TInput extends z.ZodTypeAny> {
-  price: string;
-  currency?: SupportedCurrency;
-  chain?: SupportedChain;
-  inputSchema: TInput;
-  handler: (input: z.infer<TInput>, receipt: PaymentReceipt) => Promise<ToolResult>;
-}
-
-export interface PaymentReceipt {
-  receipt_id: string;
-  tx_hash: string;
-  chain: string;
-  amount_paid: string;
-  currency: string;
-  timestamp: number;
-}
-
-export interface ToolResult {
-  content: Array<{ type: 'text'; text: string }>;
-  isError?: boolean;
-}
-
-const PROOF402_URL = process.env['PROOF402_URL'] ?? 'https://four02proof.onrender.com';
-
-/**
- * x402Payment — 5-line drop-in for any MCP server author.
- *
- * @example
- * server.tool('my_tool', schema, x402Payment({
- *   price: '0.01',
- *   currency: 'USDC',
- *   inputSchema: MyInputSchema,
- *   handler: async (input, receipt) => {
- *     return { content: [{ type: 'text', text: JSON.stringify({ result: 'data', receipt }) }] };
- *   },
- * }));
- */
-export function x402Payment<TInput extends z.ZodTypeAny>(
-  config: X402PaymentConfig<TInput>,
-): (rawArgs: unknown) => Promise<ToolResult> {
-  return async (rawArgs: unknown): Promise<ToolResult> => {
-    const parsed = config.inputSchema.safeParse(rawArgs);
-    if (!parsed.success) {
-      return {
-        content: [{ type: 'text', text: JSON.stringify({ error: 'validation_error', issues: parsed.error.issues }) }],
-        isError: true,
-      };
-    }
-
-    const args = parsed.data as z.infer<TInput>;
-    const walletAddress = (args as Record<string, unknown>)['wallet_address'] as string | undefined;
-
-    let receipt: PaymentReceipt;
-    try {
-      receipt = await processPayment({
-        price: config.price,
-        currency: config.currency ?? 'USDC',
-        chain: config.chain,
-        walletAddress,
-      });
-    } catch (err) {
-      return {
-        content: [{ type: 'text', text: JSON.stringify({ error: 'payment_failed', message: String(err) }) }],
-        isError: true,
-      };
-    }
-
-    return config.handler(args, receipt);
-  };
-}
-
-async function processPayment(params: {
-  price: string;
-  currency: SupportedCurrency;
-  chain?: SupportedChain;
-  walletAddress?: string;
-}): Promise<PaymentReceipt> {
-  // Delegates to the 402Proof payment endpoint
-  const res = await fetch(`${PROOF402_URL}/v1/pay`, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      amount: params.price,
-      currency: params.currency,
-      chain: params.chain ?? 'base',
-      wallet: params.walletAddress,
-    }),
-    signal: AbortSignal.timeout(15_000),
-  });
-
-  if (!res.ok) {
-    throw new Error(`Payment failed: HTTP ${res.status}`);
-  }
-
-  const body = (await res.json()) as {
-    receipt_id: string;
-    tx_hash: string;
-    chain: string;
-    amount: string;
-    currency: string;
-  };
-
-  return {
-    receipt_id: body.receipt_id,
-    tx_hash: body.tx_hash,
-    chain: body.chain,
-    amount_paid: body.amount,
-    currency: body.currency,
-    timestamp: Date.now(),
-  };
-}
-
-export { x402Payment as default };

package/sdk/mcp-x402-sdk/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "declaration": true
-  },
-  "include": ["src/**/*"]
-}

package/services/backtest_service.py

@@ -1,176 +0,0 @@
-"""
-Backtest microservice — wraps backtester-mcp + yfinance
-POST /backtest  { ticker, strategy_signals, lookback_days, fees, slippage }
-POST /validate  { ticker, lookback_days, train_ratio }  — walk-forward split
-GET  /health
-"""
-
-from __future__ import annotations
-import os
-import json
-import numpy as np
-from datetime import datetime, timedelta
-from typing import Any
-
-from flask import Flask, request, jsonify
-import backtester_mcp as bt
-
-# yfinance is the free price source — no API key required
-try:
-    import yfinance as yf
-    YF_AVAILABLE = True
-except ImportError:
-    YF_AVAILABLE = False
-
-app = Flask(__name__)
-
-# ── helpers ──────────────────────────────────────────────────────────────────
-
-def _fetch_prices(ticker: str, days: int) -> np.ndarray:
-    if not YF_AVAILABLE:
-        raise RuntimeError("yfinance not installed")
-    end = datetime.utcnow()
-    start = end - timedelta(days=days + 30)  # buffer for weekends/holidays
-    df = yf.download(ticker, start=start.strftime("%Y-%m-%d"),
-                     end=end.strftime("%Y-%m-%d"), progress=False, auto_adjust=True)
-    if df.empty:
-        raise ValueError(f"No price data for {ticker}")
-    return df["Close"].dropna().values[-days:]
-
-
-def _momentum_signals(prices: np.ndarray, window: int = 10, threshold: float = 0.001) -> np.ndarray:
-    """Default long-only momentum signal for validation."""
-    returns = np.diff(np.log(prices))
-    mom = np.convolve(returns, np.ones(window) / window, mode="same")
-    signals = np.zeros(len(prices))
-    signals[1:] = np.where(mom[:-1] > threshold, 1, 0)
-    return signals
-
-
-def _run_backtest(prices: np.ndarray, signals: np.ndarray,
-                  fees: float, slippage: float) -> dict[str, Any]:
-    result = bt.backtest(prices, signals, fees=fees, slippage=slippage)
-    m = result.metrics
-    return {
-        "sharpe": round(m["sharpe"], 3),
-        "sortino": round(m["sortino"], 3),
-        "cagr": round(m["cagr"], 4),
-        "total_return": round(m["total_return"], 4),
-        "max_drawdown": round(m["max_drawdown"], 4),
-        "max_drawdown_duration_days": int(m["max_drawdown_duration"]),
-        "win_rate": round(m["win_rate"], 4),
-        "profit_factor": round(m["profit_factor"], 3),
-        "calmar": round(m["calmar"], 3),
-        "volatility": round(m["volatility"], 4),
-        "num_trades": int(m["num_trades"]),
-    }
-
-
-# ── routes ───────────────────────────────────────────────────────────────────
-
-@app.get("/health")
-def health():
-    return jsonify({
-        "status": "ok",
-        "engine": f"backtester-mcp v{bt.__version__}",
-        "yfinance": YF_AVAILABLE,
-        "timestamp": datetime.utcnow().isoformat() + "Z",
-    })
-
-
-@app.post("/backtest")
-def backtest():
-    body = request.get_json(force=True)
-    ticker: str = body.get("ticker", "").upper()
-    custom_signals: list | None = body.get("signals")  # optional float array
-    lookback: int = int(body.get("lookback_days", 252))
-    fees: float = float(body.get("fees", 0.001))
-    slippage: float = float(body.get("slippage", 0.0005))
-    window: int = int(body.get("momentum_window", 10))
-    threshold: float = float(body.get("momentum_threshold", 0.001))
-
-    if not ticker:
-        return jsonify({"error": "ticker required"}), 400
-
-    try:
-        prices = _fetch_prices(ticker, lookback)
-    except Exception as e:
-        return jsonify({"error": str(e)}), 422
-
-    if custom_signals:
-        signals = np.array(custom_signals, dtype=float)
-        if len(signals) != len(prices):
-            return jsonify({"error": f"signals length {len(signals)} != prices length {len(prices)}"}), 400
-    else:
-        signals = _momentum_signals(prices, window=window, threshold=threshold)
-
-    try:
-        metrics = _run_backtest(prices, signals, fees, slippage)
-    except Exception as e:
-        return jsonify({"error": str(e)}), 500
-
-    verdict = "ROBUST" if metrics["sharpe"] > 1.5 and metrics["max_drawdown"] > -0.25 else \
-              "MODERATE" if metrics["sharpe"] > 0.8 else \
-              "WEAK" if metrics["sharpe"] > 0 else "OVERFITTED"
-
-    return jsonify({
-        "ticker": ticker,
-        "lookback_days": len(prices),
-        "fees": fees,
-        "slippage": slippage,
-        "metrics": metrics,
-        "verdict": verdict,
-        "engine": f"backtester-mcp v{bt.__version__}",
-    })
-
-
-@app.post("/validate")
-def walk_forward():
-    """Walk-forward OOS validation — splits data into train/test."""
-    body = request.get_json(force=True)
-    ticker: str = body.get("ticker", "").upper()
-    lookback: int = int(body.get("lookback_days", 504))
-    train_ratio: float = float(body.get("train_ratio", 0.7))
-    fees: float = float(body.get("fees", 0.001))
-    slippage: float = float(body.get("slippage", 0.0005))
-
-    if not ticker:
-        return jsonify({"error": "ticker required"}), 400
-
-    try:
-        prices = _fetch_prices(ticker, lookback)
-    except Exception as e:
-        return jsonify({"error": str(e)}), 422
-
-    split = int(len(prices) * train_ratio)
-    train_prices = prices[:split]
-    oos_prices = prices[split:]
-
-    train_signals = _momentum_signals(train_prices)
-    oos_signals = _momentum_signals(oos_prices)
-
-    try:
-        train_metrics = _run_backtest(train_prices, train_signals, fees, slippage)
-        oos_metrics = _run_backtest(oos_prices, oos_signals, fees, slippage)
-    except Exception as e:
-        return jsonify({"error": str(e)}), 500
-
-    # Deflated Sharpe — penalize if OOS degrades significantly
-    sharpe_degradation = train_metrics["sharpe"] - oos_metrics["sharpe"]
-    oos_verdict = "PASS" if oos_metrics["sharpe"] > 0.5 and sharpe_degradation < 1.5 else "FAIL"
-
-    return jsonify({
-        "ticker": ticker,
-        "train_days": len(train_prices),
-        "oos_days": len(oos_prices),
-        "train_metrics": train_metrics,
-        "oos_metrics": oos_metrics,
-        "sharpe_degradation": round(sharpe_degradation, 3),
-        "oos_verdict": oos_verdict,
-        "engine": f"backtester-mcp v{bt.__version__}",
-    })
-
-
-if __name__ == "__main__":
-    port = int(os.environ.get("BACKTEST_PORT", 8300))
-    app.run(host="0.0.0.0", port=port, debug=False)