Back to Browse

Simlab Mcp For Trading Agents MCP Server

Developer ToolsLow Risk9.9MCP RegistryRemote
Free

Server data from the Official MCP Registry

Pre-trade risk desk for AI trading agents: Golden Line entries, exit guardian, trap veto. x402.

About

Pre-trade risk desk for AI trading agents: Golden Line entries, exit guardian, trap veto. x402.

Remote endpoints: sse: https://simlab.measmony.me/mcp/sse

Security Report

9.9
Low Risk9.9Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

Endpoint verified · Open access · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Applies to the server that hosts this plugin, not to your machine.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-measmonysuon-simlab-alpha-intelligence": {
      "url": "https://simlab.measmony.me/mcp/sse",
      "headers": {
        "x-wallet": "<YOUR_WALLET>",
        "x-client-id": "<YOUR_CLIENT_ID>",
        "x-spend-key": "<YOUR_SPEND_KEY>"
      }
    }
  }
}

This server needs these headers. Replace each <YOUR_...> placeholder with your own value:

  • x-wallet (required): Your Base (EVM) wallet address. Used with x-client-id to bind x402 top-up credit. Licence-key holders may send Authorization: Bearer <key> instead.
  • x-client-id (required): A stable identifier for your agent. Your Sim Lab credit balance is bound to this id plus your wallet address — keep it stable and unguessable.
  • x-spend-key (optional): Secret spend key issued upon x402 top-up settlement. Required for executing paid MCP tool calls and protecting prepaid balance. Recoverable via POST /x402/spend-key/rotate.

Documentation

View on GitHub

From the project's GitHub README.

Sim Lab — Ground-Truth Pre-Trade Risk Firewall & Perpetual Futures Intelligence (MCP Server)


⚡ Executive Overview

"Price feeds tell your AI agent what happened. Sim Lab tells it whether it is allowed to act."

Sim Lab is a high-frequency, domain-specialized quantitative AI intelligence layer and deterministic pre-trade risk firewall distilled from a live production fleet of autonomous perpetual-futures trading agents. Operating as a standard Model Context Protocol (MCP) server over Server-Sent Events (SSE), Sim Lab connects directly to Claude Desktop, ChatGPT, Cursor IDE, Windsurf, LangChain, or custom Python/Rust trading agents.

🛡️ Why Ground-Truth Microstructure Matters for AI Agents

Generic Large Language Models (LLMs) are stochastic pattern-matchers prone to hallucinating fictitious support/resistance levels, inventing reasons to rationalize bad setups, and entering positions during institutional trap dumps.

Sim Lab eliminates agent hallucination by anchoring decision loops in real on-chain order flow and deterministic quantitative physics:

  • Zero Guesswork: Trades are audited against live order flow microstructure (VPIN toxicity, resting L2 spoof walls, CVD flow).
  • Multi-Layer Phase Filtering: 4 distinct defense layers evaluate macro phase, historical loss quarantine, and liquidity traps before an order touches any venue.
  • Code-Enforced Veto: Vetoes are enforced by the open-source client interceptor @simlab/execution-guard, guaranteeing that if pre_trade_check returns VETO, order dispatch is physically aborted at the code level.

Before your agent places a perpetual order on any decentralized or centralized exchange (Decibel DEX, Hyperliquid, Binance, etc.), it queries Sim Lab's multi-layer risk firewall:

  1. Phase 1: Market Regime Gate & Macro Freeze — Is the broader macro market tradable right now? Automatically stands down agents during high-impact economic releases (CPI, FOMC, PPI) or extreme volatility regime shockwaves.
  2. Phase 2: Pair Directives & Toxic Quarantine — Instantly vetoes pairs and directional biases proven toxic by fleet historical loss telemetry.
  3. Phase 3: Microstructure Liquidity Trap Shield — Evaluates Volume-Synchronized Probability of Toxicity (VPIN $\ge 0.35$), Level-2 order book depth spoofing, and Cumulative Volume Delta (CVD) flow divergence on the exact planned entry.
  4. Phase 4: Deterministic Pre-Trade Veto (pre_trade_check) — A single, sub-second ($0.15) call that synthesizes all layers into an authoritative ALLOW or VETO verdict.
  5. Phase 5: Golden Line Institutional Entry Precision (get_golden_entry) — Identifies high-probability moving baseline pullbacks, computes live retest absorption health (0–100), and defines strict risk-to-reward boundaries to stop bots from chasing fakeouts or buying falling knives ($0.03).
  6. Phase 6: Autonomous In-Trade Profit Guardian (evaluate_dynamic_exit) — Continuously monitors open positions to lock in partial profits during momentum peaks and automatically ratchets trailing stops to secure risk-free runners without rigid static take-profits ($0.01 per check).

🏛️ System Architecture & Risk Firewall

Sim Lab pairs with the client-side execution interceptor to enforce a strict fail-closed boundary:

[ AI Trading Agent (LLM) ]
          │ (Wants to place order)
          ▼
┌─────────────────────────────────────────────────────────────┐
│          CLIENT EXECUTION GUARD (@simlab/execution-guard)   │
│  1. Validates parameters & order intent locally             │
│  2. Queries Sim Lab MCP Pre-Trade Risk Firewall             │
│  3. Strictly enforces Fail-Closed on timeout or stale feed  │
└──────────────────────────────┬──────────────────────────────┘
                               │ (MCP over SSE / JSON-RPC 2.0)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│             SIM LAB CLOUD PRE-TRADE RISK FIREWALL           │
│  Layer 1: Market Regime Gate & Macro Calendar Lockout       │
│  Layer 2: Pair Directives & Historical Loss Quarantine      │
│  Layer 3: Liquidity Trap Shield (VPIN >= 0.35, L2 Spoof)    │
│  Layer 4: Pre-Trade Verdict Switch (ALLOW / VETO)           │
└──────────────────────────────┬──────────────────────────────┘
                               │
                ┌──────────────┴──────────────┐
                ▼                             ▼
       [ ALLOW / FRESH PASS ]          [ VETO / TIMEOUT ]
                │                             │
    Client Guard submits to venue    Client Guard raises fatal error
    (Decibel DEX / Hyperliquid)      Order blocked in client memory
                                     Zero capital risked

The 4 Protective Layers

  • Layer 1: Market Regime Gate & Macro Freeze
    Monitors global market conditions, trend integrity, and macroeconomic news calendars. Prevents agents from entering positions minutes before violent whipsaws caused by FOMC rate decisions, CPI prints, or sudden exchange de-pegs.
  • Layer 2: Pair Directives & Quarantine
    Maintains rolling 30-day Walk-Forward Efficiency (WFE) metrics across 50+ perpetual pairs. Pairs suffering anomalous regime slippage or low liquidity are quarantined with mandatory directional restrictions (LONG_ONLY, SHORT_ONLY, or BANNED).
  • Layer 3: Liquidity Trap Shield
    Scans live microstructure for predatory order book traps:
    • VPIN Toxicity — Measures order flow toxicity to detect aggressive institutional toxicity before price flushes.
    • L2 Order Book Imbalance — Detects resting fake ask/bid walls meant to induce false breakouts.
    • CVD Divergence — Identifies aggressive market buying into resting sell liquidity (exhaustion traps).
  • Layer 4: Deterministic Pre-Trade Check (pre_trade_check)
    Combines all 3 layers into a sub-second, authoritative decision. Returns ALLOW with confidence telemetry and dynamic stop targets, or VETO with the explicit causal reason.

📊 Live Fleet Record & Quantitative Telemetry

Sim Lab intelligence is not backtested theory — it is generated continuously by our production trading fleet on Aptos & Arbitrum perpetual DEXs:

MetricVerified Production Record
Champion StrategyRobust Island SMA Retest & 30% Dynamic Harvest Champion V3
Total Closed Trades442 closed on-chain trades
Win Rate65.3%
Profit Factor3.71
Telemetry VerificationLive discovery proof block at GET https://simlab.measmony.me/x402/info

Champion Strategy: Dynamic Amber Band Harvest Mechanics

The champion strategy replaces rigid static Take Profit targets with Amber Band gap harvesting:

  • Tier 1 (30% Dynamic Gap Scale-Out): When price expands $\ge +0.50%$ and pulls back into the 30% gap between Fast and Slow SMAs ($\lambda_{30} = 0.30$), the agent banks 30% profit and ratchets Stop Loss to Breakeven (+0.30% fee cover cushion).
  • Tier 2 (50% Midpoint Touch Exit): If the remaining 70% runner touches the 50% midpoint gap ($\lambda_{50} = 0.50$), the agent closes 100% of the position (DYNAMIC_ISLAND_50%_TOUCH), locking full campaign profits.

🔌 Connection & Setup

MCP Server Endpoint (SSE Transport)

https://simlab.measmony.me/mcp/sse

1. Claude Desktop Configuration

Add Sim Lab to your claude_desktop_config.json:

{
  "mcpServers": {
    "simlab-alpha-intelligence": {
      "url": "https://simlab.measmony.me/mcp/sse",
      "headers": {
        "x-client-id": "my-claude-agent",
        "x-wallet": "0xYourBaseWalletAddress",
        "x-spend-key": "sk_spend_YourSecretSpendKey"
      }
    }
  }
}

2. Cursor IDE / Windsurf Configuration

Add to .cursor/mcp.json or global MCP settings:

{
  "mcpServers": {
    "simlab": {
      "url": "https://simlab.measmony.me/mcp/sse",
      "headers": {
        "x-client-id": "cursor-quant-assistant",
        "x-wallet": "0xYourBaseWalletAddress",
        "x-spend-key": "sk_spend_YourSecretSpendKey"
      }
    }
  }
}

3. Authentication & Identity

  • x-client-id (required): A stable, unguessable identifier for your agent (e.g. UUID v4). Credit balances are bound to this ID + wallet combination.
  • x-wallet (required): Your EVM wallet address on the Base blockchain.
  • x-spend-key (required for paid tools): A secret authorization token returned once upon successful on-chain settlement (POST /x402/topup). Stored as a cryptographic SHA-256 hash on the server, it prevents anyone who learns your client-id and wallet pair from spending your prepaid balance. Can be rotated or recovered at any time via POST /x402/spend-key/rotate by signing an EIP-191 message with your wallet.
  • Session Authorization: The server enforces session-binding. Any POST /mcp/messages request must present matching x-client-id, x-wallet, and x-spend-key headers bound when the session opened, preventing session URL spend hijacking.
  • Fleet License Holders: Institutional users can pass Authorization: Bearer <license-key> instead of per-call micro-billing. Request access via alpha@measmony.me or Telegram @measmonysuon.

Full Agent Walkthrough: Need to create wallets, configure automated top-ups, and run 24/7 trading loops? Follow the step-by-step guide in AGENT_SETUP.md. Machine-readable LLM routing is available in llms.txt.


🛠️ Complete MCP Tool Catalog & Pricing

Sim Lab uses x402 Pay-Per-Call micro-billing in USDC on Base. The market regime headline is completely free; actionable intelligence tools are billed per call with zero monthly commitments. Credits never expire, and failed calls are never charged.

ToolPrice (USDC)Purpose & Decision Output
get_market_regimeHeadline: FREEFull: $0.02Global market condition, trend direction, volatility tier, active macro event freezes, and confidence gate.
evaluate_dynamic_exit$0.01Autonomous Profit Guardian: Re-called during an active trade to lock in partial gains at momentum peaks and automatically ratchet adaptive trailing stops to secure risk-free runners.
get_golden_entry$0.03Institutional Golden Line Entry: Pinpoints high-probability moving baseline pullbacks, computes live retest absorption health (0–100), and defines strict risk-to-reward boundaries.
pre_trade_check$0.15The Master Gate: Synthesizes regime, toxic quarantine, and trap shield into a single ALLOW or VETO verdict for a planned entry.
evaluate_trap_shield$0.10Evaluates VPIN order flow toxicity, bid-ask depth imbalance, and CVD divergence for a specific symbol and entry price.
get_alpha_bundle$0.15Downloads the complete alpha intelligence package (regime, all pair directives, top picks, and macro calendar) in one call.
check_pair_directive$0.05Checks whether a specific symbol is tradable, quarantined, or restricted to a specific direction (LONG_ONLY, SHORT_ONLY, BANNED).
get_top_picks$0.05Returns ranked candidate pairs clearing the dynamic quantitative score gate with entry biases and parameters.
get_harvest_targets$0.05Returns dynamic Amber Band gap targets, staged scale-out levels, and invalidation stops for a given symbol.
get_robust_island_status$0.05Evaluates whether a symbol is exhibiting the fleet champion's fast/slow SMA trend retest pattern.
get_market_microstructure$0.05Raw order flow analytics: spread, bid/ask depth wall sizes, CVD flow, VPIN score, and liquidation density clusters.
get_active_strategy$0.05Returns the active champion strategy parameters, layer configs, and live verified performance statistics.

Live pricing and contract parameters are published at GET https://simlab.measmony.me/x402/info.


💳 How On-Chain Payment Works (x402 Protocol)

Sim Lab requires no accounts, no passwords, and no credit cards:

[ Agent Calls Paid Tool without Credit ]
                    │
                    ▼
     [ JSON-RPC Error -32042 ]
     (Includes teaser risk score band)
                    │
                    ▼
       [ POST /x402/topup ]
                    │
                    ▼
       [ HTTP 402 Challenge ]
  (Server requests EIP-3009 USDC transfer on Base)
                    │
                    ▼
[ Agent Signs EIP-3009 Gasless Authorization ]
                    │
                    ▼
[ Facilitator Settles On-Chain · Credit Loaded ]
                    │
                    ▼
    [ Agent Retries MCP Tool Call -> ALLOW / VETO ]
  1. Trial & Top-Up Packs:
    • $1 Trial — Ideal for testing and single agent setup.
    • $10 Bot Pack (+5% bonus credit) — ~70–500 tool calls.
    • $50 Fleet Pack (+10% bonus credit) — For multi-agent desks and high-frequency scanners.
  2. Security & Non-Custodial Safety:
    • EIP-3009 authorizations pin the recipient address (payTo), exact amount, and single-use cryptographic nonce.
    • Replayed signatures are mathematically rejected on-chain (409 Conflict).
    • Funds cannot be rerouted by intermediaries.
    • See proof/RECEIPTS.md for live on-chain settlement transactions and SECURITY.md for the full audit summary.

Working client implementations in Python and TypeScript are available in examples/.


💬 Example Prompts for AI Agents

Once connected to Sim Lab MCP, you can interact with your agent using natural language:

"Before executing any perpetual trades today, query Sim Lab get_market_regime.
Are there any active macro event freezes or banned directions?"

"I am planning to enter SOL/USD LONG at $152.40 with 10x leverage.
Run pre_trade_check to verify if the setup passes the trap shield."

"Scan the market using get_top_picks. Which pairs clear the fleet score gate
and have favorable microstructure depth?"

"Check get_harvest_targets for BTC/USD under the Robust Island Champion strategy.
What are my Tier 1 (30% scale-out) and Tier 2 (50% midpoint touch) price levels?"

"Query get_golden_entry for APT/USD before I place a limit order.
What is the dynamic Golden Line, Amber Upper/Lower band, and retest health score?"

"I am in an active LONG on APT/USD entered at 9.42, current price is 9.68 (45 mins in trade).
Run evaluate_dynamic_exit to determine if I should harvest 35% partial profit or ratchet my trailing stop to Breakeven."

🛡️ Enforceable Execution Gateway (@simlab/execution-guard)

System prompt instructions are not security boundaries. To mathematically guarantee that no order can be placed on an exchange without a fresh, valid Sim Lab approval ticket, wrap your execution engine using the open-source @simlab/execution-guard:

import { SimLabExecutionGuard, OrderIntent } from '@simlab/execution-guard';

const guard = new SimLabExecutionGuard(simLabClient, exchangeAdapter, {
  maxLatencyMs: 1500,     // Strict Fail-Closed if check exceeds 1.5s
  maxFeedAgeSeconds: 15,  // Strict Fail-Closed if market quote is older than 15s
  strictFailClosed: true  // Network error or 5xx = Immediate order halt
});

// Orders are physically intercepted; exchange client is NEVER called on VETO or timeout
await guard.executeProtectedOrder({
  symbol: 'SOL/USD',
  side: 'LONG',
  orderType: 'POST_ONLY',
  sizeUsd: 1000,
  leverage: 4
});

All failure modes and veto enforcement rules are tested in our reproducible test suite:

npm test  # Runs 10/10 fail-closed & schema validation tests in <200ms

📚 Technical Documentation & Research Whitepapers

  • TOOL_SCHEMAS.md: Formal JSON Schemas and error taxonomy for all 12 MCP tools.
  • FLEET_PERFORMANCE.md: Verified 442-trade production champion record and R&D ablation study.
  • COUNTERFACTUAL_VETO.md: Live counterfactual shadow veto telemetry (+356.46% net preserved capital edge).
  • METHODOLOGY_WHITEPAPER.md: Quantitative specification of positive expectancy ($+EV$), Amber Band dynamic harvesting ($\lambda_{30}$), and VPIN toxicity modeling.
  • OPERATIONAL_SLA.md: Availability SLOs (99.9%), p95 latency targets (<200ms), and hourly canary watchdog telemetry.

🔒 Security & Verification

  • Transport: Legacy Server-Sent Events (/mcp/sse + /mcp/messages) compatible with MCP SDK 1.0+.
  • Payment Network: Base Mainnet (USDC) only. Solana or other EVM chains are not supported.
  • Separation of Concerns: Sim Lab is an intelligence and risk veto firewall only. It does not hold custody of trading capital, manage private exchange keys, or execute orders directly. Execution remains isolated within your trading client.

📬 Contact & Support


📄 License

This repository, including its documentation, agent setup guides, and client examples, is licensed under the MIT License. The Sim Lab intelligence backend is operated as a cloud service accessible via x402 on-chain micro-payments or authorized operator licenses.


Reviews

No reviews yet

Be the first to review this server!