xluxx — Python SDK for the XLUXX Trust Layer

Runtime trust scores for MCP (Model Context Protocol) tools. Makes AI agents reliable.

pip install xluxx

Quick start

from xluxx import TrustLayer

trust = TrustLayer()  # No key needed for the free tier

result = trust.resolve("search the web")
print(result.best_server)    # "brave-search"
print(result.confidence)     # 0.985
print(result.fallback)       # "fetch"
print(result.risk_flags)     # []

With an API key (higher rate limits)

from xluxx import TrustLayer

# Register for a free key
key = TrustLayer.register("your-name", "your@email.com")

trust = TrustLayer(api_key=key)
result = trust.resolve("manage files", min_trust_score=80, max_latency_ms=500)

Use it in your agent

from xluxx import resolve

best = resolve("search the web")

if best.confidence > 0.8:
    call_mcp_tool(best.best_server)
elif best.fallback:
    call_mcp_tool(best.fallback)
else:
    raise RuntimeError("no reliable tool found")

API reference

TrustLayer

TrustLayer(api_key: Optional[str] = None, base_url: str = "https://api.xluxx.net")

Convenience function

from xluxx import resolve
result = resolve("search the web", api_key=optional_key)

Result types

@dataclass
class ResolveResult:
    best_server: Optional[str]
    confidence: float
    expected_latency: str
    risk_flags: List[str]
    fallback: Optional[str]
    candidates: List[Dict]
    intent: str
    resolved_at: str
    raw: Dict[str, Any]   # full API response, including resonance fields

@dataclass
class RankResult:
    ranked: List[Dict]
    ranked_at: str

The raw field on ResolveResult exposes the complete API response, including resonance_score, fractal_reliability, coherence_drift, and fallback_stability from the Resonance Engine.

Errors

from xluxx import TrustLayer, TrustLayerError

try:
    result = trust.resolve("search the web")
except TrustLayerError as e:
    print(e, e.status_code)

Pricing

• Free — 100 calls/day, no key required
• Starter — $49/mo, 1,000 calls/day
• Pro — $149/mo, 10,000 calls/day

Links

• API: https://api.xluxx.net
• Website: https://xluxx.net
• GitHub: https://github.com/DrDMT-VR/xluxx-trust
• Node.js SDK: xluxx-trust on npm
• MCP server: xluxx-mcp-server on npm

License

Apache-2.0 — Pablo Solorzano Cohen