Phantom Speculator

FOSS Schema ● live

Automatic schema detection and inference. Analyzes payload structure to infer field types, nullability, and constraints without any configuration.

Tier

FOSS

Phase

Schema

Pricing

FREE (FOSS)

MCP Tool

phantom_speculator_detect

Dependencies

helix-serializer

View source on GitHub

What It Does

Phantom Speculator is the zero-configuration schema inference engine. It analyzes incoming payloads and automatically infers the schema — field names, data types, nullability, cardinality, value distributions, and constraints — using statistical sampling for large payloads and producing JSON Schema-compatible output.

Capabilities

Zero-config schema inference
Statistical sampling for large payloads
Nested structure detection
Type inference (string, number, boolean, date, UUID, email)
Nullability and cardinality analysis
Pattern detection (email, URL, UUID, date)
JSON Schema output

Example

phantom-speculator-example.ts

const result = await mcp.call('phantom_speculator_detect', {
  payload: normalizedPayload,
  stream_uuid: streamUUID,
  sample_size: 1000,
});
// { "type": "object", "properties": { "email": { "format": "email" } } }
console.log(result.confidence); // 0.97

Configuration

phantom-speculator.yaml

agent: phantom-speculator
version: "1.0"
inference:
  sample_size: 1000
  confidence_threshold: 0.95
  detect_patterns: true
output:
  format: json-schema
  include_statistics: true