Skip to main content

XLUXX Trust Layer SDK — runtime trust scores for 15,000+ MCP servers, Resonance Engine, and Context Gate. Makes AI agents reliable.

Project description

xluxx — Python SDK for the XLUXX Trust Layer

PyPI version Python License

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")
Method Description
resolve(intent, tools=None, category=None, min_trust_score=None, max_latency_ms=None) Find the best tool for an intent. Returns ResolveResult
rank(tools) Rank tool/server IDs by trust score. Returns RankResult
server(server_id) Get full record for a server
servers(limit=50) List all tracked servers, sorted by trust
search(query) Search 15,000+ servers by capability
health() API health and platform stats
TrustLayer.register(name, email) (static) Get a free API key

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

License

Apache-2.0 — Pablo Solorzano Cohen

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xluxx-0.4.0.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xluxx-0.4.0-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file xluxx-0.4.0.tar.gz.

File metadata

  • Download URL: xluxx-0.4.0.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for xluxx-0.4.0.tar.gz
Algorithm Hash digest
SHA256 bd1d029436d01d14158fff380e2d6024239d27b328c334b603f7e50b2fd4a405
MD5 b5d24fefd5d3c9c4b990447a77dc13ce
BLAKE2b-256 48b752bb2c472683c9df7c37ea56228ae54a5cd7f40cbe1d273c862878d5c609

See more details on using hashes here.

File details

Details for the file xluxx-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: xluxx-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 4.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for xluxx-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 55273d671b3edcc937c086d8e7432fdd33c42b596dedbdfb6f1a5ba4d3c840a1
MD5 2fa23abdba58a6128004fb40f1e9c45f
BLAKE2b-256 a32cc69f883a8f5ece6e770869cd27366ae2f1201697958c532131ab79ec01e8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page