# Aleatoric

Aleatoric Engine is deterministic market simulation infrastructure for generating reproducible, schema-stable synthetic market data used in financial research, validation, and systems testing. It pri…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add aleatoric/causal-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list aleatoric/causal-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get aleatoric/causal-mcp get_health

# Call a tool
npx -y @smithery/cli@latest tool call aleatoric/causal-mcp get_health '{}'
```

## Direct MCP Connection

Endpoint: `https://causal-mcp--aleatoric.run.tools`

**Optional config:**
- `apiKey` (query) — Your Aleatoric API key from www.aleatoric.systems. Required for data generation, optional for discovery endpoints.

## Tools (9)

- `get_health` — Check server health status. Returns OK if the server is running correctly.
- `get_presets` — List available market simulation presets. Returns preset names and configurations for common scenarios like high-volati…
- `get_config_schema` — Get the JSON Schema for SimulationManifest configuration. Use this to understand all available configuration options.
- `validate_config` — Validate a simulation configuration and get its deterministic hash. The hash ensures reproducibility - same config alwa…
- `generate_dataset` — Generate synthetic L2 order book market data. Returns a download URL for a Parquet file containing trades and book upda…
- `normalize_events` — Normalize raw exchange data to a canonical format. Converts exchange-specific payloads to unified event schema.
- `simulate_funding_regime` — Simulate perpetual futures funding rates over multiple periods. Calculates expected funding payments based on spot-mark…
- `get_venue_details` — Get exchange adapter capabilities including supported symbols, tick sizes, trading hours, and fee structures.
- `get_cache_stats` — Get statistics about cached datasets including count, total size, and compression ratios.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get aleatoric/causal-mcp <tool-name>
```

## Resources

- `aleatoric://cache/stats` — Statistics about cached datasets
- `aleatoric://presets` — Available market simulation presets
- `aleatoric://schema/config` — JSON Schema for simulation configuration

## Prompts (2)

- `generate_backtest_data` (symbol, duration, scenario) — Generate synthetic market data for backtesting a trading strategy
- `analyze_funding_costs` (exchange, position_size) — Analyze perpetual futures funding costs across exchanges