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
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
- API: https://api.xluxx.net
- Website: https://xluxx.net
- GitHub: https://github.com/DrDMT-VR/xluxx-trust
- Node.js SDK:
xluxx-truston npm - MCP server:
xluxx-mcp-serveron npm
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bd1d029436d01d14158fff380e2d6024239d27b328c334b603f7e50b2fd4a405
|
|
| MD5 |
b5d24fefd5d3c9c4b990447a77dc13ce
|
|
| BLAKE2b-256 |
48b752bb2c472683c9df7c37ea56228ae54a5cd7f40cbe1d273c862878d5c609
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
55273d671b3edcc937c086d8e7432fdd33c42b596dedbdfb6f1a5ba4d3c840a1
|
|
| MD5 |
2fa23abdba58a6128004fb40f1e9c45f
|
|
| BLAKE2b-256 |
a32cc69f883a8f5ece6e770869cd27366ae2f1201697958c532131ab79ec01e8
|