Summary
Gives AI agents a persistent identity token that survives across sessions and merchants. Wraps the Badge SDK's three-tier credential ladder (guest pass, badge token, authenticated identity) and exposes lifecycle tracking via MCP tools. Agents declare visits to merchant sites, report outcomes like "not_denied", and accumulate trust over time through a portable kyaScore (500–850 range). The MCP server is a convenience layer for Claude Desktop and similar clients. If you're building a framework or platform, use the SDK directly. It's zero-dependency, offline-resilient, and issues credentials on first run with no signup required. Integrates with UCP as an identity credential provider using ES256-signed JWTs.
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
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
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.identityCredential Provider, published schemas, ES256-signed JWTs - Scoring — outcomes feed kyaScore (500–850), portable across merchants
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.
Links
- Website: kyalabs.io
- Data practices: kyalabs.io/trust
- UCP extension spec: github.com/kyalabs/ucp-agent-badge
- Contact: agent_identity@kyalabs.io
License
MIT
Featured
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
PAYCLAW_API_KEY*secretYour PayClaw API key (get one at payclaw.io)
PAYCLAW_API_URLPayClaw API URL (default: https://payclaw.io)