Aleatoric Engine MCP

🚀 Aleatoric MCP Client

The official MCP client SDK for Aleatoric Systems, enabling institutional - grade synthetic market data generation.

Keywords: mcp market-data synthetic-data backtesting trading fintech quantitative-finance perpetuals futures order-book

🚀 Quick Start

Installation Methods (Friendly)

• Zero install: The MCP server is hosted; there's no need to build or run a local binary.
• Drop - in configs: There are ready JSONs in configs/ for Claude Desktop, Cursor, VS Code Copilot, and Cline. Just replace YOUR_API_KEY_HERE with your key.
• Public Discovery: The endpoints for health and manifest are publicly accessible, facilitating easy integration with registries like LobeHub.

# Public health check (No API Key required)
curl -s https://mcp.aleatoric.systems/mcp/health

1. Get an API Key

Sign up at www.aleatoric.systems to obtain your API key.

2. Configure Your MCP Client

Add to your MCP client configuration:

{
  "mcpServers": {
    "aleatoric": {
      "url": "https://mcp.aleatoric.systems/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "aleatoric": {
      "url": "https://mcp.aleatoric.systems/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

{
  "servers": {
    "aleatoric": {
      "type": "http",
      "url": "https://mcp.aleatoric.systems/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

{
  "aleatoric": {
    "url": "https://mcp.aleatoric.systems/mcp",
    "headers": {
      "X-API-Key": "your-api-key-here"
    }
  }
}

{
  "name": "Aleatoric Engine",
  "identifier": "aleatoric-engine-mcp",
  "manifest": "https://mcp.aleatoric.systems/mcp/manifest",
  "type": "remote",
  "url": "https://mcp.aleatoric.systems/mcp",
  "headers": {
    "X-API-Key": "YOUR_API_KEY_HERE"
  }
}

3. Verify Installation

Test the connection (this endpoint is public for discovery):

curl -s https://mcp.aleatoric.systems/mcp/health

Expected output:

{"status": "ok", "version": "0.4.4"}

4. Start Using

Ask your AI assistant:

"Generate 1 hour of BTC synthetic order book data with seed 42"

✨ Features

Aleatoric MCP offers AI assistants tools to generate deterministic synthetic market data for backtesting, stress testing, and model validation. It can connect to your AI coding assistant to generate reproducible datasets across 6 major exchanges.

Supported Exchanges: Binance, HyperLiquid, OKX, Bybit, CME, SGX

⚡ 90 - Second Demo

Run this in your AI assistant (Cursor, Claude, Windsurf):

"Generate a 1 - hour dataset of BTC/USDT L2 order book updates on Binance. Use seed 123 for reproducibility. Plot the mid - price and spread over time."

What happens:

1. Agent calls validate_config to lock parameters.
2. Server generates 3,600s of data (approx 14,000 events) with realistic microstructure.
3. Agent receives a signed URL or stream of the data.
4. Agent plots the exact price path defined by seed = 123.

Result: A fully reproducible market scenario for your backtest in under 2 minutes.

Use Cases

• Backtesting: Generate months of realistic order book data in seconds.
• Stress Testing: Simulate extreme market conditions with reproducible seeds.
• Model Validation: Test trading algorithms against deterministic synthetic data.
• CI/CD Pipelines: Automated testing with consistent market scenarios.
• Research: Explore funding rate dynamics across venues.

Why Deterministic Data?

Random data is useless for engineering. You need:

1. Reproducibility: If a test fails, you must be able to replay the exact same market conditions to debug it.
2. Control: Inject specific anomalies (flash crashes, liquidity voids) to test edge cases that might not happen for years in production.
3. Compliance: Prove your algorithm handles known adverse scenarios before deploying capital.
4. Speed: Generate 10 years of tick data in minutes, without expensive subscriptions or rate limits.

💻 Usage Examples

Basic Usage

Ask your AI assistant for data generation, for example:

"Generate 1 hour of BTC synthetic order book data with seed 42"

Advanced Usage

You can use the available tools for more complex operations. For example, use validate_config to validate simulation configuration:

import httpx
import os

api_key = os.getenv("ALEATORIC_API_KEY")
base_url = "https://mcp.aleatoric.systems"

with httpx.Client(timeout=30) as client:
    config = {
        "symbol": "BTC",
        "seed": 42,
        "tick_size": 0.01,
        "lot_size": 0.001,
        "initial_mid": 50000.0,
        "volatility": 0.02,
    }
    response = client.post(
        f"{base_url}/mcp/config/validate",
        json={"config": config},
        headers={"X-API-Key": api_key}
    )
    result = response.json()
    print(f"Valid! Hash: {result['hash']}")

Available Tools

Prompts & Resources

• Prompts: Example asks are in README.md (see Example Prompts) and can be reused directly in MCP - capable IDEs.
• Resources: The server exposes MCP resources for cache inspection/export; attach outputs via get_cache_stats, stream_cache, or export_cache to feed downstream tools.

Validation Checklist (End - to - End)

• Health: curl -s -H "X-API-Key: $ALEATORIC_API_KEY" https://mcp.aleatoric.systems/mcp/health → expect { "status": "healthy", "version": "0.4.3" }.
• Manifest: python examples/list_presets.py --manifest → prints server name/version and tool list.
• Tool Call: python examples/validate_config.py --symbol BTC --seed 42 → expect Valid! Hash: ... with normalized config.
• Resource Flow: python examples/funding_simulation.py --exchange hyperliquid → exercises tool + resource outputs; for cache endpoints, call get_cache_stats then stream_cache/export_cache (attach resource in your MCP client).
• Offline sanity (no network): python -m compileall examples after installing deps to ensure scripts parse.

Example Prompts

"Validate this config: symbol BTC, seed 42, volatility 0.02"
"List available presets for perpetual futures"
"Simulate 10 days of funding rates on HyperLiquid with spot=50000 and mark=50100"
"What exchanges does Aleatoric support?"
"Export my cached dataset as Parquet"

📚 Documentation

API Reference

Full API documentation: www.aleatoric.systems

Endpoints

Pricing

Start your free trial: www.aleatoric.systems

Support

• Documentation: www.aleatoric.systems
• Issues: GitHub Issues
• Email: support@aleatoric.systems

📄 License

MIT License - see LICENSE