- name
- payclaw-badge
- description
- 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.
- metadata
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:
{
"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_KEYrequired. 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.