badge

Name: badge
Author: payclaw

本地服务

github.com/payclaw安全022 周前更新

代码仓库

关于 badge

Badge 为 AI Agent 提供可跨商家使用的持久身份凭证，记录访问及结果，并让信任评分随历史积累。它包含 SDK 和供 MCP 客户端使用的服务端，适用于 Agent 平台构建者及终端用户。

主要功能

01跨商家持久身份
02访问信息与结果跟踪
03网络故障时的离线回退
04UCP 凭证提供方集成
05基于结果的可移植评分

适用场景

01让 Agent 在不同商家声明身份
02关联访问记录与运行 ID
03网络不可用时继续执行身份调用
04依据历史结果积累商家信任

MCP 相关

Badge MCP 服务端将 SDK 的身份模型、令牌和评分封装为 MCP 工具，供 Claude Desktop、Cursor 和 Windsurf 等 MCP 客户端使用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "payclaw-badge": {
      "command": "npx",
      "args": [
        "-y",
        "@payclaw/badge"
      ],
      "env": {
        "PAYCLAW_API_KEY": "<PAYCLAW_API_KEY>",
        "PAYCLAW_API_URL": "<PAYCLAW_API_URL>"
      }
    }
  }
}

启动命令npx -y @payclaw/badge

需要配置的环境变量

PAYCLAW_API_KEY密钥Your PayClaw API key (get one at payclaw.io)

PAYCLAW_API_URLPayClaw API URL (default: https://payclaw.io)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@payclaw/badge0.4.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

kya labs 的 Badge

为 AI Agent 在商家网站间提供持久身份。Badge 为 Agent 提供一项凭证，使其在每次请求中携带该凭证——商家进行验证，信任会随访问次数累积，而建立起历史记录的 Agent 随着时间推移会获得更好的待遇。

与框架无关。与传输方式无关。零运行时依赖。

Badge SDK

SDK 是主要的集成入口。三个方法即可覆盖完整生命周期：

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",
});

无需注册。无需 API 密钥。首次运行时，Badge.init() 会签发访客通行证并将其缓存到磁盘。身份在进程重启后仍会保留。