Aleatoric MCP Client

Official MCP client SDK for Aleatoric Systems — Institutional-grade synthetic market data generation.

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

Overview

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

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

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

Quick Start

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"
    }
  }
}

3. Verify Installation

Test the connection:

curl -s -H "X-API-Key: YOUR_KEY" https://mcp.aleatoric.systems/mcp/health

Expected output:

{"status": "healthy", "version": "0.4.3"}

4. Start Using

Ask your AI assistant:

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

Available Tools

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"

Direct API Usage

For programmatic access without an MCP client:

import httpx
import os

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

with httpx.Client(timeout=30) as client:
    # Get available presets
    response = client.get(
        f"{base_url}/mcp/presets",
        headers={"X-API-Key": api_key}
    )
    presets = response.json()

    # Validate a configuration
    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: {result['valid']}, Hash: {result['hash']}")

See examples/ for more complete examples.

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