Badge

Badge by kya labs

Persistent identity for AI agents across merchant sites. Badge gives agents a credential they carry on every request — merchants verify it, trust accumulates across visits, and agents that build history earn better treatment over time.

Framework-agnostic. Transport-agnostic. Zero runtime dependencies.

Badge SDK

The SDK is the primary integration surface. Three methods cover the full lifecycle:

import { Badge } from "@kyalabs/badge-sdk";
const badge = await Badge.init();const runId = badge.startRun();
await badge.declareVisit({  merchant: "store.example.com",  runId,  url: "https://store.example.com/cart",});
await badge.reportOutcome({  merchant: "store.example.com",  runId,  outcome: "not_denied",});

No signup. No API key. Badge.init() issues a guest pass on first run and caches it to disk. Identity survives process restarts.

npm install @kyalabs/badge-sdk

Full SDK documentation →

What the SDK covers

• Identity model — three-tier ladder: guest pass (gp_v1_*) → badge token (kya_*) → authenticated identity
• Lifecycle tracking — declare visits, report outcomes, correlate with run IDs
• Offline resilience — never throws on network failure, deterministic fallback on every call
• UCP integration — io.kyalabs.common.identity Credential Provider, published schemas, ES256-signed JWTs
• Scoring — outcomes feed kyaScore (500–850), portable across merchants

[npm]

Badge MCP Server

For MCP client users (Claude Desktop, Cursor, Windsurf), Badge also ships as an MCP tool server. The MCP server wraps the SDK — same identity model, same tokens, same scoring.

npx @kyalabs/badge

The SDK is the canonical integration path for platform builders and agent frameworks. The MCP server is a convenience wrapper for end users working within MCP clients.

[npm]

Links

• Website: kyalabs.io
• Data practices: kyalabs.io/trust
• UCP extension spec: github.com/kyalabs/ucp-agent-badge
• Contact: [email protected]

License

MIT