xluxx-trust

Node.js / TypeScript SDK for the XLUXX Trust Layer — runtime trust scoring for MCP (Model Context Protocol) tools. Makes AI agents reliable.

npm install xluxx-trust

Quick start

const { resolveTool, rankTools, register } = require('xluxx-trust');

// Find the best tool for an intent
const result = await resolveTool('search the web');
console.log(result.best_server);   // "brave-search"
console.log(result.confidence);    // 0.985
console.log(result.fallback);      // "fetch"

// Rank specific tools
const ranked = await rankTools(['github', 'slack', 'postgres']);

// Register for a free API key (higher rate limits)
const { api_key } = await register('my-app', '[email protected]');
const better = await resolveTool('query database', { apiKey: api_key });

TypeScript

The package ships with type definitions. ResolveResult includes best_server, confidence, resonance_score, fractal_reliability, coherence_drift, risk_flags, fallback, fallback_stability, candidates, and more.

import { resolveTool, ResolveResult } from 'xluxx-trust';

const result: ResolveResult = await resolveTool('search the web');

API

All functions return promises and accept an optional apiKey for higher rate limits.

Trust + resolution

| Function | Description | |----------|-------------| | resolveTool(intent, options?) | Best server for an intent. options: apiKey, category, available_tools, min_trust_score, max_latency_ms | | rankTools(tools, apiKey?) | Rank tool IDs by trust score | | recommendToolchain(task, apiKey?) | Generate a tool-chain for a task | | search(query, apiKey?) | Search 15,000+ servers by capability |

Health + telemetry

| Function | Description | |----------|-------------| | getStatus(serverId, apiKey?) | Real-time server status | | getTrends(serverId, apiKey?) | Reliability trends — 24h, 7d, all-time | | getAlerts(apiKey?) | Active degradation alerts | | health() | API health check |

Resonance Engine

| Function | Description | |----------|-------------| | getResonance(serverId, apiKey?) | Fractal reliability + coherence drift for a server | | chainResonance(tools, apiKey?) | Score a multi-step toolchain |

Account

| Function | Description | |----------|-------------| | register(name, email) | Get a free API key | | getUsage(apiKey) | Current usage and quota |

Usage example: agent integration

const { resolveTool } = require('xluxx-trust');

async function pickReliableTool(intent) {
  const r = await resolveTool(intent, { min_trust_score: 80 });
  if (r.confidence > 0.8) return r.best_server;
  if (r.fallback) return r.fallback;
  throw new Error(`No reliable tool found for: ${intent}`);
}

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
• MCP server package: xluxx-mcp-server
• Python SDK: xluxx on PyPI

License

Apache-2.0 — Pablo Solorzano Cohen