@scriptmasterlabs/mcp-x402 2.0.2 → 2.1.1

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/server.json

@@ -1,48 +0,0 @@
-{
-  "$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"
-    }
-  ]
-}

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)

package/src/lib/chains/base.ts

@@ -1,77 +0,0 @@
-import { createWalletClient, createPublicClient, http, parseUnits } from 'viem';
-import { base, baseSepolia } from 'viem/chains';
-import { privateKeyToAccount } from 'viem/accounts';
-import { mnemonicToSeedSync } from 'bip39';
-import HDKey from 'hdkey';
-import { WalletManager } from '../../server/payments/wallet.js';
-import type { RouteParams } from '../../server/payments/router.js';
-
-// USDC contract on Base mainnet
-const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
-// USDC contract on Base Sepolia
-const USDC_BASE_SEPOLIA = '0x036CbD53842c5426634e7929541eC2318f3dCF7e';
-
-const ERC20_TRANSFER_ABI = [
-  {
-    name: 'transfer',
-    type: 'function',
-    inputs: [
-      { name: 'to', type: 'address' },
-      { name: 'amount', type: 'uint256' },
-    ],
-    outputs: [{ name: '', type: 'bool' }],
-    stateMutability: 'nonpayable',
-  },
-] as const;
-
-export class BaseChain {
-  private static instance: BaseChain;
-  private readonly testnet: boolean;
-
-  private constructor() {
-    this.testnet = process.env['TESTNET'] === 'true';
-  }
-
-  static getInstance(): BaseChain {
-    if (!BaseChain.instance) {
-      BaseChain.instance = new BaseChain();
-    }
-    return BaseChain.instance;
-  }
-
-  async sendPayment(params: RouteParams): Promise<string> {
-    const chain = this.testnet ? baseSepolia : base;
-    const rpcUrl = this.testnet
-      ? (process.env['BASE_SEPOLIA_RPC_URL'] ?? 'https://sepolia.base.org')
-      : (process.env['BASE_RPC_URL'] ?? 'https://mainnet.base.org');
-
-    const privateKey = await this.getPrivateKey();
-    const account = privateKeyToAccount(privateKey);
-
-    const walletClient = createWalletClient({ account, chain, transport: http(rpcUrl) });
-    const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
-
-    const usdcAddress = this.testnet ? USDC_BASE_SEPOLIA : USDC_BASE;
-    const amount = parseUnits(params.amount, 6); // USDC has 6 decimals
-
-    const hash = await walletClient.writeContract({
-      address: usdcAddress,
-      abi: ERC20_TRANSFER_ABI,
-      functionName: 'transfer',
-      args: [params.to as `0x${string}`, amount],
-    });
-
-    // Wait for confirmation
-    await publicClient.waitForTransactionReceipt({ hash });
-    return hash;
-  }
-
-  private async getPrivateKey(): Promise<`0x${string}`> {
-    const mnemonic = await WalletManager.getInstance().getSeed();
-    const seed = mnemonicToSeedSync(mnemonic);
-    const hdkey = HDKey.fromMasterSeed(seed);
-    const child = hdkey.derive("m/44'/60'/0'/0/0");
-    if (!child.privateKey) throw new Error('Key derivation failed');
-    return `0x${child.privateKey.toString('hex')}`;
-  }
-}

package/src/lib/chains/solana.ts

@@ -1,59 +0,0 @@
-import {
-  Connection,
-  Keypair,
-  PublicKey,
-  Transaction,
-  sendAndConfirmTransaction,
-} from '@solana/web3.js';
-import { createTransferInstruction, getAssociatedTokenAddress } from '@solana/spl-token';
-import { mnemonicToSeedSync } from 'bip39';
-import HDKey from 'hdkey';
-import { WalletManager } from '../../server/payments/wallet.js';
-import type { RouteParams } from '../../server/payments/router.js';
-
-// USDC mint on Solana mainnet
-const USDC_MINT = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
-
-export class SolanaChain {
-  private static instance: SolanaChain;
-  private readonly rpcUrl: string;
-
-  private constructor() {
-    this.rpcUrl = process.env['SOLANA_RPC_URL'] ?? 'https://api.mainnet-beta.solana.com';
-  }
-
-  static getInstance(): SolanaChain {
-    if (!SolanaChain.instance) {
-      SolanaChain.instance = new SolanaChain();
-    }
-    return SolanaChain.instance;
-  }
-
-  async sendPayment(params: RouteParams): Promise<string> {
-    const connection = new Connection(this.rpcUrl, 'confirmed');
-    const payer = await this.getKeypair();
-    const destination = new PublicKey(params.to);
-
-    const fromATA = await getAssociatedTokenAddress(USDC_MINT, payer.publicKey);
-    const toATA = await getAssociatedTokenAddress(USDC_MINT, destination);
-
-    const lamports = Math.round(parseFloat(params.amount) * 1_000_000); // USDC 6 decimals
-
-    const tx = new Transaction().add(
-      createTransferInstruction(fromATA, toATA, payer.publicKey, BigInt(lamports)),
-    );
-
-    const sig = await sendAndConfirmTransaction(connection, tx, [payer]);
-    return sig;
-  }
-
-  private async getKeypair(): Promise<Keypair> {
-    const mnemonic = await WalletManager.getInstance().getSeed();
-    const seed = mnemonicToSeedSync(mnemonic);
-    const hdkey = HDKey.fromMasterSeed(seed);
-    // BIP-44 for Solana: m/44'/501'/0'/0'
-    const child = hdkey.derive("m/44'/501'/0'/0'");
-    if (!child.privateKey) throw new Error('Solana key derivation failed');
-    return Keypair.fromSeed(child.privateKey.slice(0, 32));
-  }
-}

package/src/lib/chains/xrpl.ts

@@ -1,63 +0,0 @@
-import { Client, Wallet, xrpToDrops } from 'xrpl';
-import { WalletManager } from '../../server/payments/wallet.js';
-import type { RouteParams } from '../../server/payments/router.js';
-
-export class XRPLChain {
-  private static instance: XRPLChain;
-  private readonly rpcUrl: string;
-
-  private constructor() {
-    this.rpcUrl = process.env['XRPL_RPC_URL'] ?? 'wss://xrplcluster.com';
-  }
-
-  static getInstance(): XRPLChain {
-    if (!XRPLChain.instance) {
-      XRPLChain.instance = new XRPLChain();
-    }
-    return XRPLChain.instance;
-  }
-
-  async sendPayment(params: RouteParams): Promise<string> {
-    const client = new Client(this.rpcUrl);
-    await client.connect();
-
-    try {
-      const wallet = await this.getWallet();
-
-      // RLUSD on XRPL or XRP-denominated drop equivalent
-      const tx = await client.submitAndWait(
-        {
-          TransactionType: 'Payment',
-          Account: wallet.address,
-          Destination: params.to,
-          Amount:
-            params.currency === 'RLUSD'
-              ? {
-                  currency: 'USD',
-                  issuer: process.env['RLUSD_ISSUER'] ?? 'rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh',
-                  value: params.amount,
-                }
-              : xrpToDrops(params.amount),
-        },
-        { wallet },
-      );
-
-      if (tx.result.meta && typeof tx.result.meta === 'object' && 'TransactionResult' in tx.result.meta) {
-        const meta = tx.result.meta as { TransactionResult: string };
-        if (meta.TransactionResult !== 'tesSUCCESS') {
-          throw new Error(`XRPL transaction failed: ${meta.TransactionResult}`);
-        }
-      }
-
-      const txResult = tx.result as unknown as { hash?: string };
-      return txResult.hash ?? 'unknown';
-    } finally {
-      await client.disconnect();
-    }
-  }
-
-  private async getWallet(): Promise<Wallet> {
-    const mnemonic = await WalletManager.getInstance().getSeed();
-    return Wallet.fromMnemonic(mnemonic, { mnemonicEncoding: 'bip39' });
-  }
-}

package/src/lib/credit/bureau.ts

@@ -1,65 +0,0 @@
-interface ScoreCache {
-  score: number;
-  fetchedAt: number;
-}
-
-const SCORE_CACHE_TTL = 300_000; // 5 minutes
-
-export class CreditBureau {
-  private static instance: CreditBureau;
-  private readonly cache = new Map<string, ScoreCache>();
-  private readonly baseUrl: string;
-
-  private constructor() {
-    this.baseUrl = process.env['PROOF402_URL'] ?? 'https://four02proof.onrender.com';
-  }
-
-  static getInstance(): CreditBureau {
-    if (!CreditBureau.instance) {
-      CreditBureau.instance = new CreditBureau();
-    }
-    return CreditBureau.instance;
-  }
-
-  async getScore(wallet: string): Promise<number> {
-    const now = Date.now();
-    const cached = this.cache.get(wallet);
-
-    if (cached && now - cached.fetchedAt < SCORE_CACHE_TTL) {
-      return cached.score;
-    }
-
-    try {
-      const res = await fetch(`${this.baseUrl}/v1/score/${wallet}`, {
-        signal: AbortSignal.timeout(5000),
-      });
-
-      if (res.ok) {
-        const body = (await res.json()) as { score: number };
-        this.cache.set(wallet, { score: body.score, fetchedAt: now });
-        return body.score;
-      }
-    } catch {
-      // Fall through to default
-    }
-
-    // Default score for new/unknown agents
-    const defaultScore = 300;
-    this.cache.set(wallet, { score: defaultScore, fetchedAt: now });
-    return defaultScore;
-  }
-
-  async incrementScore(wallet: string, delta: number): Promise<void> {
-    try {
-      await fetch(`${this.baseUrl}/v1/score/${wallet}/increment`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ delta }),
-      });
-      // Invalidate cache
-      this.cache.delete(wallet);
-    } catch {
-      // Non-fatal
-    }
-  }
-}