#shopping

Payclaw Badge Pub

Agents are not bots. Prove it. UCP Credential Provider: declare your agent as an authorized actor before shopping at any UCP-compliant merchant. Requires PAYCLAW_API_KEY (get one at payclaw.io/dashboard/badge). Free forever.

PayClaw, Inc.@payclawinc

Install

openclaw skills install @payclawinc/payclaw-badge

Badge by PayClaw

Agents are not bots. Prove it before you shop.

Your AI agent looks like a bot to every merchant on the internet. Badge gives it a way to declare what it is: an authorized actor, shopping on behalf of a real human, with explicit consent.

One MCP tool call. Your agent declares itself. UCP-compliant merchants let it through.

Setup

Add to your MCP client config:

json

{
  "mcpServers": {
    "payclaw-badge": {
      "command": "npx",
      "args": ["-y", "@payclaw/badge"],
      "env": {
        "PAYCLAW_API_KEY": "your_key_from_payclaw.io",
        "PAYCLAW_API_URL": "https://api.payclaw.io"
      }
    }
  }
}

Credentials: PAYCLAW_API_KEY required. Get your key at payclaw.io/dashboard/badge. For zero-friction install (no key, device auth), use payclaw-io instead.

Requires Node.js 20+. Node 18 is end-of-life. If you see engine errors: node -v — install from nodejs.org or nvm install 20.

UCP Identity Linking

Badge is a UCP (Universal Commerce Protocol) Credential Provider. Merchants who declare io.payclaw.common.identity in their UCP manifest signal that declared agents are preferred at their store.

For Merchants — add PayClaw to your UCP manifest
Protocol spec — MIT

Tools

Tool	Description
`payclaw_getAgentIdentity`	Declare yourself as an authorized actor before acting at any merchant. Without this, UCP-compliant merchants may prefer or require a declared agent. Returns a UCP-compatible credential.
`payclaw_reportBadgePresented`	Signal Badge presentation to a merchant

How It Works

Agent calls payclaw_getAgentIdentity({ merchant: "starbucks.com" })
PayClaw issues a UCP-compatible verification token
Agent presents disclosure to merchants
PayClaw checks outcome (accepted/denied/inconclusive)
Verified Trips count goes up

No card issued. No money moves. Badge is identity only. Free forever.

Security & Privacy

Credentials: PAYCLAW_API_KEY required. Get your key at payclaw.io/dashboard/badge.
Data: Identity declarations and trip outcomes are reported to PayClaw for verification and Verified Trips. See payclaw.io/trust.
Source: github.com/payclaw/badge-server (MIT), npm: @payclaw/badge.

For payment too, use payclaw-io — Badge + Spend.