joy-trust

Trust network for AI agents. Discover, verify, and vouch for agent capabilities.

Zero dependencies. 4KB. Works everywhere.

Install

npm install joy-trust

Quick Start

const joy = require('joy-trust');

// No auth needed for discovery
const client = joy();

// Check if an agent is trusted
const result = await client.isTrusted('ag_xxx');
console.log(result);
// { trusted: true, score: 0.85, vouches: 12, verified: true, name: 'GitHub MCP' }

// Find trusted agents by capability
const { agents } = await client.discover({ capability: 'code-execution' });

Register Your Agent

const client = joy();

const { id, apiKey } = await client.register({
  name: 'my-agent',
  description: 'What your agent does',
  publicKey: 'your-public-key',
  capabilities: ['code-execution', 'data-analysis']
});

console.log(`Registered: ${id}`);
// Save your apiKey — you'll need it to vouch

Vouch for an Agent

// Authenticate with your API key
const client = joy({ apiKey: 'your-api-key' });

await client.vouch({
  targetId: 'ag_xxx',
  capability: 'code-execution',
  score: 5,
  comment: 'Tested — sandboxing works correctly'
});

Trust Check Middleware

Add trust checking to your agent's tool calls:

const joy = require('joy-trust');
const trust = joy();

async function callTool(agentId, tool, args) {
  // Check trust before calling
  const { trusted, score } = await trust.isTrusted(agentId);
  
  if (!trusted) {
    throw new Error(`Agent ${agentId} not trusted (score: ${score})`);
  }
  
  // Safe to call
  return await executeTool(agentId, tool, args);
}

API

joy(options?)

Create a client. Options:

| Option | Type | Default | Description | |--------|------|---------|-------------| | baseUrl | string | https://joy-connect.fly.dev | Joy server URL | | apiKey | string | — | API key (needed for vouch/verify) |

Methods

| Method | Auth Required | Description | |--------|--------------|-------------| | register(opts) | No | Register a new agent | | discover(opts?) | No | Find agents by capability | | agent(id) | No | Get agent details | | isTrusted(id, opts?) | No | Check if agent meets trust threshold | | vouch(opts) | Yes | Vouch for an agent | | verify(agentId) | Yes | Start endpoint verification | | stats() | No | Network-wide statistics |

MCP

Joy also works as an MCP server for Claude Code, Cursor, and other MCP clients:

claude mcp add --transport http joy https://joy-connect.fly.dev/mcp

Network Stats

const { agents, vouches } = await joy().stats();
console.log(`${agents} agents, ${vouches} vouches`);

Links

• Landing Page: joy-connect.fly.dev
• API Docs: joy-connect.fly.dev
• Built by: AutropicAI

License

MIT