# Payclaw Badge

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

- Skill: `dvcrn/payclaw-badge` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add dvcrn/payclaw-badge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/payclaw-badge/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/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](https://payclaw.io/dashboard/badge). For zero-friction install (no key, device auth), use [payclaw-io](https://clawhub.com/skills/payclaw-io) instead.

**Requires Node.js 20+.** Node 18 is end-of-life. If you see engine errors: `node -v` — install from [nodejs.org](https://nodejs.org) or `nvm install 20`.

## UCP Identity Linking

Badge is a [UCP (Universal Commerce Protocol)](https://ucp.dev) Credential Provider. Merchants who declare `io.payclaw.common.identity` in their UCP manifest signal that declared agents are preferred at their store.

- [For Merchants](https://payclaw.io/merchants) — add PayClaw to your UCP manifest
- [Protocol spec](https://github.com/payclaw/ucp-agent-badge) — 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

1. Agent calls `payclaw_getAgentIdentity({ merchant: "starbucks.com" })`
2. PayClaw issues a UCP-compatible verification token
3. Agent presents disclosure to merchants
4. PayClaw checks outcome (accepted/denied/inconclusive)
5. 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](https://payclaw.io/dashboard/badge).
- **Data:** Identity declarations and trip outcomes are reported to PayClaw for verification and Verified Trips. See [payclaw.io/trust](https://payclaw.io/trust).
- **Source:** [github.com/payclaw/badge-server](https://github.com/payclaw/badge-server) (MIT), [npm: @payclaw/badge](https://www.npmjs.com/package/@payclaw/badge).

For payment too, use [payclaw-io](https://clawhub.com/skills/payclaw-io) — Badge + Spend.

## Links

- [payclaw.io](https://payclaw.io)
- [For Merchants](https://payclaw.io/merchants)
- [Trust & Verification](https://payclaw.io/trust)
- [npm: @payclaw/badge](https://www.npmjs.com/package/@payclaw/badge)
- [Protocol spec: ucp-agent-badge](https://github.com/payclaw/ucp-agent-badge)