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
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.
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 GitHubFrom 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 ifpre_trade_checkreturnsVETO, 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:
- 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.
- Phase 2: Pair Directives & Toxic Quarantine — Instantly vetoes pairs and directional biases proven toxic by fleet historical loss telemetry.
- 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.
- Phase 4: Deterministic Pre-Trade Veto (
pre_trade_check) — A single, sub-second ($0.15) call that synthesizes all layers into an authoritativeALLOWorVETOverdict. - 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). - 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, orBANNED). - 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. ReturnsALLOWwith confidence telemetry and dynamic stop targets, orVETOwith 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:
| Metric | Verified Production Record |
|---|---|
| Champion Strategy | Robust Island SMA Retest & 30% Dynamic Harvest Champion V3 |
| Total Closed Trades | 442 closed on-chain trades |
| Win Rate | 65.3% |
| Profit Factor | 3.71 |
| Telemetry Verification | Live 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 viaPOST /x402/spend-key/rotateby signing an EIP-191 message with your wallet.- Session Authorization: The server enforces session-binding. Any
POST /mcp/messagesrequest must present matchingx-client-id,x-wallet, andx-spend-keyheaders 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.
| Tool | Price (USDC) | Purpose & Decision Output |
|---|---|---|
get_market_regime | Headline: FREEFull: $0.02 | Global market condition, trend direction, volatility tier, active macro event freezes, and confidence gate. |
evaluate_dynamic_exit | $0.01 | Autonomous 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.03 | Institutional 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.15 | The Master Gate: Synthesizes regime, toxic quarantine, and trap shield into a single ALLOW or VETO verdict for a planned entry. |
evaluate_trap_shield | $0.10 | Evaluates VPIN order flow toxicity, bid-ask depth imbalance, and CVD divergence for a specific symbol and entry price. |
get_alpha_bundle | $0.15 | Downloads the complete alpha intelligence package (regime, all pair directives, top picks, and macro calendar) in one call. |
check_pair_directive | $0.05 | Checks whether a specific symbol is tradable, quarantined, or restricted to a specific direction (LONG_ONLY, SHORT_ONLY, BANNED). |
get_top_picks | $0.05 | Returns ranked candidate pairs clearing the dynamic quantitative score gate with entry biases and parameters. |
get_harvest_targets | $0.05 | Returns dynamic Amber Band gap targets, staged scale-out levels, and invalidation stops for a given symbol. |
get_robust_island_status | $0.05 | Evaluates whether a symbol is exhibiting the fleet champion's fast/slow SMA trend retest pattern. |
get_market_microstructure | $0.05 | Raw order flow analytics: spread, bid/ask depth wall sizes, CVD flow, VPIN score, and liquidation density clusters. |
get_active_strategy | $0.05 | Returns 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 ]
- 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.
- 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.
- EIP-3009 authorizations pin the recipient address (
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
- Email: alpha@measmony.me
- Telegram: @measmonysuon
- GitHub Repository: https://github.com/Measmonysuon/simlab-mcp-for-trading-agents
📄 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!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
