Badge

io.github.payclaw由 GitHub 账号 payclaw 发布v0.4.0更新于 Oct 24, 2026

Agents are not bots. Prove it. MCP-native identity declaration for authorized agents.

已验证STDIO仅桌面安全与监控商业与电商

概览

AI 生成的概览

一个本地 MCP 服务器，为 AI 代理提供持久身份凭证，用于向商户网站声明访问并上报结果。

可以做什么
向商户网站声明代理访问，附带运行 ID 和网址，并回传访问结果。首次运行时签发并缓存访客通行证，使身份在进程重启后仍保留。将上报的结果汇入跨商户通用的信任评分。封装 Badge SDK，让 MCP 客户端获得相同的身份模型、令牌和评分。
适用场景
当代理访问会核验代理身份的商户网站，且你希望以持久、可移植的身份记录访问与结果，而不是匿名机器人会话时使用。
运行要求
通过 npx 作为本地进程运行，需要 Node.js。必须在 PAYCLAW_API_KEY 环境变量中提供 PayClaw API 密钥，可用 PAYCLAW_API_URL 覆盖接口地址（默认
安装前请注意
需要 PAYCLAW_API_KEY 中的 PayClaw API 密钥，该密钥会发送到所配置的接口。访问声明和结果会上报给第三方服务并计入信任评分，因此商户网址和活动数据会离开本机。README 还提到访客通行证会缓存到磁盘，使身份在多次运行间保留。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Badge，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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:

typescript
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.

bash
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.

bash
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

License

MIT

来源：README.md，提交 829bf50

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.4.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分